Skip to main content
POST
searchAssets

Request Parameters

string
required
The Solana wallet address to retrieve owned digital assets for filtering search results.
string
required
Filter for specific Solana token types including compressed NFTs (cNFTs), regular NFTs, programmable NFTs (pNFTs), or fungible SPL tokens for targeted asset discovery.
  • fungible
  • nonFungible
  • regularNft
  • compressedNft
  • all
number
The page of results to return.
string
The authority address criteria for filtering Solana digital assets based on program authority, useful for finding assets controlled by specific protocols or update authorities.
number
The maximum number of assets to return.
object
The sorting options for the response.
string
The criteria by which the assets will be sorted.
  • created
  • recent_action
  • updated
  • none
string
The sorting direction.
  • asc
  • desc
boolean
Filter for compressed Solana NFTs (cNFTs) that use state compression technology for reduced storage costs and improved scalability.
boolean
Filter for Solana assets that are eligible for compression but have not yet been compressed into the state compression format.
number
Delegate criteria for the asset search.
string
Creator wallet address criteria for finding Solana NFTs created by specific artists, projects, or creators for attribution and royalty tracking.
boolean
Whether a creator is verified.
array
Collection grouping array for filtering Solana NFTs by their collection membership (e.g. [“collection”, “<collectionKey>”]) to find related assets.
string
Merkle tree address for filtering compressed NFTs (cNFTs) by their collection tree. This parameter is Helius-specific and not part of the official DAS specification.
number
Supply criteria for the asset search.
string
Supply mint criteria for the asset search.
boolean
Whether an asset is frozen.
boolean
Whether an asset is burnt.
boolean
Filter assets that have an Agent Identity (MPL Core AgentIdentity external plugin).
string
Filter by base58 agent token mint address from the Agent Registry program.
string
Filter by base58 asset-signer PDA (MPL Core).
string
The Solana token standard interface type to filter for specific NFT implementations including programmable NFTs, legacy NFTs, fungible tokens, and MPL Core assets, collections, or groups (MIP-11).
  • V1_NFT
  • V1_PRINT
  • LEGACY_NFT
  • V2_NFT
  • FungibleAsset
  • FungibleToken
  • Custom
  • Identity
  • Executable
  • ProgrammableNFT
  • MplCoreAsset
  • MplBubblegumV2
  • MplCoreCollection
  • MplCoreGroup
string
Royalty target type criteria.
number
Royalty target criteria.
number
Royalty amount criteria.
number
Ownership model criteria.
string
A cursor for paginating backward.
string
A cursor for paginating forward.
object
Advanced display options for customizing the Solana asset search response.
boolean
default:"false"
Show unverified collections instead of skipping them.
boolean
default:"false"
Show metadata for the collection.
boolean
default:"false"
Show total number of matching assets (slower request).
boolean
default:"false"
Show the native (SOL) balance of the owner.
boolean
default:"false"
Display assets with zero balance.

Authorizations

api-key
string
query
required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json
jsonrpc
enum<string>
default:2.0
required

The version of the JSON-RPC protocol.

Available options:
2.0
id
string
default:1
required

An ID to identify the request.

method
enum<string>
default:searchAssets
required

The name of the JSON-RPC method to invoke.

Available options:
searchAssets
params
object
required

Parameters for the searchAssets method.

Response

Successful response

assets
object
Example:
nativeBalance
object

The native SOL balance of the Solana wallet account in lamports and USD value.