Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Helius Tokens API

Complete token account data, on-chain and off-chain metadata, and detailed information for both fungible and non-fungible Solana tokens.

Helius Tokens API is one of 20 APIs that Helius publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Tokens. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 2 paths, and defines 13 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 14 base URLs: https://mainnet.helius-rpc.com, https://devnet.helius-rpc.com, https://sender.helius-rpc.com, https://api.helius.xyz, https://admin-api.helius.xyz, https://api-mainnet.helius-rpc.com, https://api-devnet.helius-rpc.com, http://slc-sender.helius-rpc.com, http://ewr-sender.helius-rpc.com, http://lon-sender.helius-rpc.com, http://fra-sender.helius-rpc.com, http://ams-sender.helius-rpc.com, http://sg-sender.helius-rpc.com, http://tyo-sender.helius-rpc.com.

2 operations 2 paths 13 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://mainnet.helius-rpc.com/?api-key={apiKey}
Authentication
API Key, API Key
License
Resource Areas
1

Authentication & Security 2

Helius Tokens API declares 2 security schemes for authenticating requests. An API key is passed in the query as api-key (ApiKeyQuery). An API key is passed in the header as X-Api-Key (ApiKeyHeader).

  • ApiKeyQuery — Your Helius API key. You can get one for free in the [dashboard](https://dashboard.helius.dev/api-keys).
  • ApiKeyHeader — API key passed in request header

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Tokens 2

Complete token account data, on-chain and off-chain metadata, and detailed information for both fungible and non-fungible Solana tokens.

POST
/v0/tokens/metadata
Returns token metadata (whether NFT or Fungible) for a given token address.
enhancedApi_getTokenMetadata 1 param body → 200400401403404429500503
POST
/v0/token-metadata
Returns all metadata associated with an account, including data from the old token list.
enhancedApi_queryMetadataV1 1 param body → 200400401403404429500503

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are EnhancedApi_OnChainMetadata (11 properties), EnhancedApi_LegacyMetadata (8 properties), EnhancedApi_OnChainAccountInfo (8 properties), EnhancedApi_OffChainMetadata (6 properties). Each schema is shown below with its type and property counts.

EnhancedApi_OffChainMetadata
object
Metaplex metadata that is stored off-chain.
6 properties
EnhancedApi_TokensMetadataRequest
object
1 property
EnhancedApi_TokensMetadataResponseV1
array
EnhancedApi_OnChainMetadataResult
object
2 properties
EnhancedApi_OnChainMetadata
object
Metaplex metadata that is stored on-chain.
11 properties
EnhancedApi_TokensMetadataRequestV1
object
3 properties
EnhancedApi_LegacyMetadata
object
Data from the old SPL token list.
8 properties
EnhancedApi_AccountErrorType
string
EnhancedApi_OffChainMetadataResult
object
3 properties
EnhancedApi_TokenMetadataResponse
object
Metaplex metadata stored both on-chain and off-chain.
3 properties
EnhancedApi_OnChainAccountInfo
object
Account data that is stored on-chain.
8 properties
EnhancedApi_ErrorResponse
object
JSON-RPC error response format
3 properties 3 required
EnhancedApi_OnChainAccountInfoResult
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

helius-tokens-api-openapi.yml Raw ↑

Other APIs Helius publishes across the network.

Helius Solana RPC
Helius Digital Asset Standard (DAS) API
Helius Enhanced Transactions API
Helius Webhooks
Helius LaserStream
Helius Sender
Helius Photon RPC (ZK Compression)
Helius Addresses API
Helius Admin API
Helius Balances API
Helius Funding API
Helius Helius API Catalog API