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 NFTs API

Access comprehensive NFT data including events, collection aggregations, real-time stats, and complete historical activity on Solana.

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

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

This API exposes 8 operations across 8 paths, and defines 44 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.

8 operations 8 paths 44 schemas 2 GET6 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 NFTs 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 8

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

NFTs 8

Access comprehensive NFT data including events, collection aggregations, real-time stats, and complete historical activity on Solana.

GET
/v0/addresses/{address}/nft-events
Returns all NFT related events associated with the given address.
enhancedApi_getNftEvents 7 params → 200400401403404429500503
POST
/v0/tokens/metadata
Returns token metadata (whether NFT or Fungible) for a given token address.
enhancedApi_getTokenMetadata 1 param body → 200400401403404429500503
GET
/v0/addresses/{address}/nfts
Returns the NFTs held for a given address.
enhancedApi_getNFTs 3 params → 200400401403404429500503
POST
/v1/nft-events
Queries for NFT events.
enhancedApi_queryNftEvents 1 param body → 200400401403404429500503
POST
/v1/nfts
Describes the provided NFTs.
enhancedApi_describeNfts 1 param body → 200400401403404429500503
POST
/v1/mintlist
Returns a list of mint accounts for a given NFT collection.
enhancedApi_mintlist 1 param body → 200400401403404429500503
POST
/v1/active-listings
Query for active NFT listings.
enhancedApi_queryActiveListings 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 44

The contract defines 44 schemas that model the data the API accepts and returns. The most detailed are EnhancedApi_NftEventV2 (16 properties), EnhancedApi_NFTEvent (14 properties), EnhancedApi_OnChainMetadata (11 properties), EnhancedApi_OnChainAccountInfo (8 properties). Each schema is shown below with its type and property counts.

EnhancedApi_ActiveListing
object
4 properties
EnhancedApi_TransactionType
string
EnhancedApi_DescribeNftsRequest
object
1 property
EnhancedApi_ActiveListingsRequest
object
2 properties
EnhancedApi_OffChainMetadata
object
Metaplex metadata that is stored off-chain.
6 properties
EnhancedApi_NFTsResponse
object
2 properties
EnhancedApi_NFTEvent
object
14 properties
EnhancedApi_NftName
string
The name of the NFT.
EnhancedApi_TokenTransfer
object
6 properties
EnhancedApi_SortOrder
string
Order of the returned results. Must be 'ASC' or 'DESC'. Results are descending by default.
EnhancedApi_TokensMetadataRequest
object
1 property
EnhancedApi_NftEventV2
object
16 properties
EnhancedApi_NativeTransfer
object
3 properties
EnhancedApi_TokensMetadataResponseV1
array
EnhancedApi_TransactionSource
string
EnhancedApi_Token
object
2 properties
EnhancedApi_PaginationToken
string
Token used for pagination. Provide the token to the API to retrieve the results from the next page. If no token exists, the query has no results remaining.
EnhancedApi_MintlistResponse
object
2 properties
EnhancedApi_OnChainMetadata
object
Metaplex metadata that is stored on-chain.
11 properties
EnhancedApi_OnChainAccountInfoResult
object
2 properties
EnhancedApi_ActiveListingsResponse
object
2 properties
EnhancedApi_OnChainMetadataResult
object
2 properties
EnhancedApi_TokenStandard
string
EnhancedApi_SaleType
string
EnhancedApi_TokensMetadataRequestV1
object
3 properties
EnhancedApi_LegacyMetadata
object
Data from the old SPL token list.
8 properties
EnhancedApi_Commitment
string
EnhancedApi_NFTEventType
string
EnhancedApi_QueryNftEventsRequest
object
2 properties
EnhancedApi_NftBurned
boolean
If the NFT was was burned. Burned NFTs have no name, firstVerifiedCreator, or verifiedCollectionAddress.
EnhancedApi_VerifiedCollectionAddress
string
Verified Metaplex collection address. Does not exist for all NFT collections.
EnhancedApi_Asset
object
6 properties
EnhancedApi_Marketplace
string
Marketplace where the NFT is being listed.
EnhancedApi_AccountErrorType
string
EnhancedApi_OffChainMetadataResult
object
3 properties
EnhancedApi_QueryNftEventsResponse
object
2 properties
EnhancedApi_DescribeNftsResponse
array
EnhancedApi_NftV2
object
5 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_MintlistRequest
object
2 properties
EnhancedApi_FirstVerifiedCreator
string
First verified creator of the NFT. Used to reference NFT collections.
EnhancedApi_NftMintAccount
string
NFT mint account address.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

helius-nfts-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