Helius Helius API Catalog API
The Helius API Catalog API from Helius — 1 operation(s) for helius api catalog.
OpenAPI Specification
openapi: 3.1.0
info:
title: Addresses Helius API Catalog API
version: 1.0.0
summary: Machine-readable discovery document for every Helius API surface on Solana.
description: 'This document is a discovery catalog — not an operational spec. It exists so
AI agents, codegen tools, and SDK generators can locate the canonical
OpenAPI document for every Helius API in one request instead of crawling
the docs site.
Start with the `x-apis` array: each entry links a Helius API surface to its
canonical OpenAPI spec (`specUrl`) and human-readable docs (`docsUrl`).
Follow `externalDocs` for the full developer documentation site.
## A note on JSON-RPC APIs
Several Helius APIs (Solana RPC, DAS, Sender, Mint, Priority Fee,
ZK Compression) follow the JSON-RPC 2.0 convention where every method POSTs
to `/` with a `method` field in the request body. For each such API the
repository ships both per-method fragment YAMLs (used to render the
Mintlify reference pages) and an auto-generated `_combined.yaml` that
merges every method into a single OpenAPI document. In the combined
documents, colliding paths are disambiguated with a URL-fragment suffix
(e.g. `/#getAccountInfo`) and each operation carries an `x-actual-path`
extension that records the real request path (`/`). The fragment syntax is
schema-only — real calls still go to the `url` in `servers`.
All `specUrl` values below point to raw GitHub files on the `main` branch
of `helius-labs/docs`. They are stable URLs suitable for downstream tools
to pin or fetch.
'
contact:
name: Helius Support
url: https://www.helius.dev/contact
email: support@helius.dev
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Solana mainnet RPC endpoint (Solana RPC, DAS, Priority Fee, ZK Compression)
- url: https://devnet.helius-rpc.com
description: Solana devnet RPC endpoint
- url: https://sender.helius-rpc.com
description: Helius Sender — global transaction submission
- url: https://api.helius.xyz
description: Helius REST APIs (Wallet API, Enhanced API, Webhooks)
- url: https://admin-api.helius.xyz
description: Helius Admin API — project usage and billing
- url: https://api-mainnet.helius-rpc.com
description: Mainnet RPC endpoint
- url: https://api-devnet.helius-rpc.com
description: Devnet RPC endpoint
- url: http://slc-sender.helius-rpc.com
description: Salt Lake City
- url: http://ewr-sender.helius-rpc.com
description: Newark
- url: http://lon-sender.helius-rpc.com
description: London
- url: http://fra-sender.helius-rpc.com
description: Frankfurt
- url: http://ams-sender.helius-rpc.com
description: Amsterdam
- url: http://sg-sender.helius-rpc.com
description: Singapore
- url: http://tyo-sender.helius-rpc.com
description: Tokyo
tags:
- name: Helius API Catalog
paths:
/:
post:
summary: Get Solana priority fee estimates
description: "Calculate optimal priority fee recommendations for Solana transactions based on real-time \nnetwork conditions. This advanced API analyzes historical fee data and current congestion \nlevels to provide precise fee estimates for different priority levels.\n"
operationId: priorityFeeApi_getPriorityFeeEstimate
security:
- ApiKeyQuery: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PriorityFeeApi_PriorityFeeEstimateRequest'
examples:
transactionExample:
value:
jsonrpc: '2.0'
id: '1'
method: getPriorityFeeEstimate
params:
- transaction: LxzhDW7TapzziJVHEGPh1QjmZB6kjNqmvuJ9gmihBGEkzw2N8ospDq32UZdVmKWzRZqKuyvhp7xmLvsmmHa3MfxVKpYoLV9cPkw5isHnHgDUwLSMsDaZ4dLEULexXAvuV9k6fLD2LMhFKM6gqH6j69GQLAm1g4e3z5ZVZN6pmJdSmZ4PqKcwNn4sS7E3Abp1hV59uBJB9i4jEdEAh28rZ8WCeNizzEmrJZFhatFFFGSDsk23jDPEjbkMcoRWXKf1WthFScC2S6Wz284Dtjqp7kW8eybV3DpmN9DtBbcfFNQPtUwmiBZCKszdYym5AjJvRHiUKUdMwFpC3toPnMvTmKZ9iHQtzZRkg5xBufRtUN5eVYJfdw2DxzH6RfqhC2rAjfSbfJA4wmaq9f5eUe2iEjmqvne6r85PPcHBJzyqkVtAyUFtTc9DfU8UiM9rFhQ2UB71M6m5UCsC6EwowMw5k8iF8rL7iPCLdubVdy8S58DPLNG4E4rdosev1T63YdRWSgEwBZh7iX4zGBA9AKAm3B9itCSxLSL46Y6uZgVku9UXsMcWWz3URoa6hRbo55CYPLhrVeqjqX5DsXpaG6QkngbEaESQUnkakE1AFkYXmNXEd2m3sLRTYB2o5UTkwkJS2u5sJHyYqAvXr3vFZr7qAYFLD3LwS5tsdb45ZQVQwsbnNddMHgkpmSqLHS6Fv1epxqHbzpRCU1tgMsriApVWC3pj2LLD41HxkV8aKvkVyHgJFACUtbvRBZAasHf1F71Gz3qZNTdh3efWsZJRXnfxKPbATU7NTMaMUL8JjknfoVwp3/SsAUIMHFzjQMQmoiQMSL1q+S+r9dLR55BgaWAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqQECAwABDAIAAAAEAAAAAAAA
accountKeysExample:
value:
jsonrpc: '2.0'
id: '1'
method: getPriorityFeeEstimate
params:
- accountKeys:
- 2CiBfRKcERi2GgYn83UaGo1wFaYHHrXGGfnDaa2hxdEA
options:
includeAllPriorityFeeLevels: true
responses:
'200':
description: Successfully retrieved Solana priority fee estimates
content:
application/json:
schema:
$ref: '#/components/schemas/PriorityFeeApi_PriorityFeeEstimateResponse'
examples:
singleEstimateResponse:
value:
jsonrpc: '2.0'
result:
priorityFeeEstimate: 120000
id: '1'
allLevelsResponse:
value:
jsonrpc: '2.0'
result:
priorityFeeLevels:
min: 0
low: 2
medium: 10082
high: 100000
veryHigh: 1000000
unsafeMax: 50000000
id: '1'
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC version identifier
error:
type: object
description: Error information
properties:
code:
type: integer
example: -32602
description: Error code
message:
type: string
example: Invalid params
description: Error message
id:
type: string
description: Client-generated identifier matching the request
'401':
description: Unauthorized — missing or invalid API key.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: Unauthorized
id:
type: string
'429':
description: Too Many Requests — rate limit exceeded.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
example: -32005
message:
type: string
example: Too many requests
id:
type: string
'500':
description: Internal server error. Retryable with exponential backoff.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
example: -32603
message:
type: string
example: Internal error
id:
type: string
servers:
- url: https://mainnet.helius-rpc.com
description: Mainnet RPC endpoint
- url: https://devnet.helius-rpc.com
description: Devnet RPC endpoint
tags:
- Helius API Catalog
components:
schemas:
PriorityFeeApi_PriorityFeeEstimateRequest:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
default: '2.0'
description: JSON-RPC version identifier for the Solana RPC API request, must be "2.0"
id:
type: string
default: '1'
description: Client-generated identifier for the request
method:
type: string
enum:
- getPriorityFeeEstimate
default: getPriorityFeeEstimate
description: The RPC method name
params:
type: array
description: Parameters for the method call
default:
- transaction: LxzhDW7TapzziJVHEGPh1QjmZB6kjNqmvuJ9gmihBGEkzw2N8ospDq32UZdVmKWzRZqKuyvhp7xmLvsmmHa3MfxVKpYoLV9cPkw5isHnHgDUwLSMsDaZ4dLEULexXAvuV9k6fLD2LMhFKM6gqH6j69GQLAm1g4e3z5ZVZN6pmJdSmZ4PqKcwNn4sS7E3Abp1hV59uBJB9i4jEdEAh28rZ8WCeNizzEmrJZFhatFFFGSDsk23jDPEjbkMcoRWXKf1WthFScC2S6Wz284Dtjqp7kW8eybV3DpmN9DtBbcfFNQPtUwmiBZCKszdYym5AjJvRHiUKUdMwFpC3toPnMvTmKZ9iHQtzZRkg5xBufRtUN5eVYJfdw2DxzH6RfqhC2rAjfSbfJA4wmaq9f5eUe2iEjmqvne6r85PPcHBJzyqkVtAyUFtTc9DfU8UiM9rFhQ2UB71M6m5UCsC6EwowMw5k8iF8rL7iPCLdubVdy8S58DPLNG4E4rdosev1T63YdRWSgEwBZh7iX4zGBA9AKAm3B9itCSxLSL46Y6uZgVku9UXsMcWWz3URoa6hRbo55CYPLhrVeqjqX5DsXpaG6QkngbEaESQUnkakE1AFkYXmNXEd2m3sLRTYB2o5UTkwkJS2u5sJHyYqAvXr3vFZr7qAYFLD3LwS5tsdb45ZQVQwsbnNddMHgkpmSqLHS6Fv1epxqHbzpRCU1tgMsriApVWC3pj2LLD41HxkV8aKvkVyHgJFACUtbvRBZAasHf1F71Gz3qZNTdh3efWsZJRXnfxKPbATU7NTMaMUL8JjknfoVwp3
items:
type: object
properties:
transaction:
type: string
description: 'Base58 or Base64 encoded Solana transaction for which to estimate optimal priority fees.
The API will analyze the specific instructions and accounts in this transaction to provide
accurate fee estimates based on current network conditions and computational complexity.
'
accountKeys:
type: array
description: Array of Solana account public keys to estimate priority fees for (alternative to providing a transaction)
items:
type: string
description: Base58 encoded public key of a Solana account
options:
$ref: '#/components/schemas/PriorityFeeApi_PriorityFeeOptions'
PriorityFeeApi_PriorityFeeEstimateResponse:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC version identifier
id:
type: string
description: Client-generated identifier matching the request
result:
type: object
description: Result object containing comprehensive Solana priority fee estimates
properties:
priorityFeeEstimate:
type: number
format: float
description: 'Estimated optimal priority fee in microlamports for the requested Solana transaction,
calculated based on recent blockchain activity and computational requirements.
'
priorityFeeLevels:
type: object
description: 'Detailed fee estimates for different priority levels on the Solana blockchain (in microlamports),
allowing developers to choose the optimal balance between cost and confirmation speed.
'
properties:
min:
type: number
format: float
description: 'Minimum viable fee for Solana transactions - suitable for non-urgent transactions during low congestion periods
(may result in transaction failure during network congestion)
'
low:
type: number
format: float
description: 'Low priority fee for Solana transactions - economical option for transactions that aren''t time-sensitive
(longer confirmation time, lower cost)
'
medium:
type: number
format: float
description: 'Medium priority fee for Solana transactions - balanced option for most standard transactions
(reasonable confirmation time with moderate cost)
'
high:
type: number
format: float
description: 'High priority fee for Solana transactions - prioritized processing for time-sensitive operations
like DeFi trades or NFT mints (faster confirmation, higher cost)
'
veryHigh:
type: number
format: float
description: 'Very high priority fee for Solana transactions - premium option for critical transactions requiring
near-immediate confirmation (very fast confirmation, premium cost)
'
unsafeMax:
type: number
format: float
description: 'Maximum observed fee on Solana - the highest fee seen in the analysis window, representing
an upper bound during extreme congestion (fastest possible confirmation, but potentially unnecessarily high)
'
PriorityFeeApi_PriorityFeeOptions:
type: object
description: Advanced options for customizing Solana priority fee estimation based on network conditions
properties:
transactionEncoding:
type: string
enum:
- Base58
- Base64
description: Encoding format of the provided Solana transaction
priorityLevel:
type: string
enum:
- Min
- Low
- Medium
- High
- VeryHigh
- UnsafeMax
description: Specific priority level to estimate fees for based on current Solana network congestion
includeAllPriorityFeeLevels:
type: boolean
description: When true, returns comprehensive estimates for all priority levels from minimum to maximum
lookbackSlots:
type: integer
minimum: 1
maximum: 150
description: Number of recent Solana blockchain slots to analyze for accurate fee estimation (1-150)
includeVote:
type: boolean
description: When true, includes vote transactions in the fee calculation for more comprehensive analysis
recommended:
type: boolean
description: When true, returns the recommended optimal fee based on current Solana network conditions
evaluateEmptySlotAsZero:
type: boolean
description: When true, slots with no transactions are counted as zero-fee slots in the calculation
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: Your Helius API key. You can get one for free in the [dashboard](https://dashboard.helius.dev/api-keys).
ApiKeyHeader:
type: apiKey
in: header
name: X-Api-Key
description: API key passed in request header
externalDocs:
description: Helius Documentation (canonical)
url: https://www.helius.dev/docs
x-apis:
- id: rpc-http
name: Solana RPC (HTTP)
description: JSON-RPC 2.0 methods for Solana mainnet and devnet, plus Helius extensions such as `getTransactionsForAddress` with server-side filtering and token account helpers (`getTokenAccountsByOwnerV2`, `getProgramAccountsV2`).
specUrl: https://www.helius.dev/openapi/rpc-http.json
docsUrl: https://www.helius.dev/docs/rpc/overview
tags:
- rpc
- json-rpc
- solana
- accounts
- transactions
status: stable
x-specFragments: https://github.com/helius-labs/docs/tree/main/openapi/rpc-http
- id: das-api
name: Digital Asset Standard (DAS) API
description: Unified NFT and token queries for Solana — regular NFTs, compressed NFTs, and fungible tokens — indexed for fast lookups by owner, creator, authority, collection, or search.
specUrl: https://www.helius.dev/openapi/das-api.json
docsUrl: https://www.helius.dev/docs/das-api
tags:
- nft
- tokens
- compressed-nft
- digital-assets
- json-rpc
status: stable
x-specFragments: https://github.com/helius-labs/docs/tree/main/openapi/das-api
- id: sender-api
name: Helius Sender
description: Ultra-low-latency transaction submission with dual routing to validators and Jito infrastructure. Regional endpoints for Salt Lake City, Newark, London, Frankfurt, Amsterdam, Singapore, and Tokyo.
specUrl: https://www.helius.dev/openapi/sender-api.json
docsUrl: https://www.helius.dev/docs/sending-transactions/sender
tags:
- transactions
- sender
- low-latency
- jito
status: stable
x-specFragments: https://github.com/helius-labs/docs/tree/main/openapi/sender-api
- id: wallet-api
name: Wallet API
description: High-performance REST API for Solana wallet data — identity, balances, transaction history, transfers, and funding lineage. Returns pre-indexed results suitable for wallet and portfolio UIs.
specUrl: https://www.helius.dev/openapi/wallet-api.json
docsUrl: https://www.helius.dev/docs/wallet-api/overview
tags:
- wallet
- portfolio
- history
- rest
status: beta
- id: priority-fee-api
name: Priority Fee API
description: Real-time priority fee recommendations across multiple priority levels, derived from recent network activity. Accepts either account keys or a serialized transaction.
specUrl: https://www.helius.dev/openapi/priority-fee-api.json
docsUrl: https://www.helius.dev/docs/priority-fee-api
tags:
- priority-fee
- transactions
- fees
- json-rpc
status: stable
x-specFragments: https://github.com/helius-labs/docs/tree/main/openapi/priority-fee-api
- id: zk-compression
name: ZK Compression Indexer
description: Indexer API for Solana state compression — compressed accounts, compressed token balances, Merkle proofs, and validity proofs. Enables up to 1000x lower storage costs relative to regular accounts.
specUrl: https://www.helius.dev/openapi/zk-compression.json
docsUrl: https://www.helius.dev/docs/zk-compression/introduction
tags:
- zk-compression
- state-compression
- accounts
- proofs
- json-rpc
status: stable
x-specFragments: https://github.com/helius-labs/docs/tree/main/openapi/zk-compression
- id: admin-api
name: Admin API
description: Programmatic access to Helius project usage and billing data — credits consumed, credits remaining, prepaid balances, and subscription details for the current billing cycle.
specUrl: https://www.helius.dev/openapi/admin-api.json
docsUrl: https://www.helius.dev/docs/api-reference/admin
tags:
- admin
- billing
- usage
- rest
status: stable
x-specFragments: https://github.com/helius-labs/docs/tree/main/openapi/admin-api
- id: enhanced-api
name: Enhanced API
description: Decoded, human-readable transaction history, NFT events, and address activity on Solana. Returns typed, parsed data instead of raw instruction bytes.
specUrl: https://www.helius.dev/openapi/enhanced-api.json
docsUrl: https://www.helius.dev/docs/enhanced-transactions/overview
tags:
- enhanced
- parsed-transactions
- nft-events
- history
- rest
status: stable
- id: webhooks
name: Helius Webhooks
description: Real-time HTTP notifications for Solana on-chain events — configure account, transaction, or NFT event subscriptions and receive parsed payloads via HTTPS POST.
specUrl: https://www.helius.dev/openapi/webhooks.json
docsUrl: https://www.helius.dev/docs/webhooks
tags:
- webhooks
- events
- notifications
- rest
status: stable