searchAssets

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

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.

Show child attributes

params.ownerAddress

string

required

The Solana wallet address to retrieve owned digital assets for filtering search results.

Example:

"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"

params.tokenType

enum<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.

Available options:

fungible,

nonFungible,

regularNft,

compressedNft,

all

Example:

"all"

params.page

integer

The page of results to return.

Example:

1

params.authorityAddress

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.

Example:

"string"

params.limit

integer

The maximum number of assets to return.

Example:

100

params.sortBy

object

The sorting options for the response.

Show child attributes

params.sortBy.sortBy

enum<string>

The criteria by which the assets will be sorted.

Available options:

created,

recent_action,

updated,

none

params.sortBy.sortDirection

enum<string>

The sorting direction.

Available options:

asc,

desc

params.compressed

boolean

Filter for compressed Solana NFTs (cNFTs) that use state compression technology for reduced storage costs and improved scalability.

Example:

true

params.compressible

boolean

Filter for Solana assets that are eligible for compression but have not yet been compressed into the state compression format.

Example:

false

params.delegate

integer

Delegate criteria for the asset search.

params.creatorAddress

string

Creator wallet address criteria for finding Solana NFTs created by specific artists, projects, or creators for attribution and royalty tracking.

Example:

"string"

params.creatorVerified

boolean

Whether a creator is verified.

Example:

true

params.grouping

string[]

Collection grouping array for filtering Solana NFTs by their collection membership (e.g. ["collection", ""]) to find related assets.

Example:

[
  "collection",
  "DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x"
]

params.tree

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.

Example:

"mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL"

params.supply

integer

Supply criteria for the asset search.

Example:

0

params.supplyMint

string

Supply mint criteria for the asset search.

params.frozen

boolean

Whether an asset is frozen.

Example:

false

params.burnt

boolean

Whether an asset is burnt.

Example:

false

params.interface

enum<string>

The Solana token standard interface type to filter for specific NFT implementations including programmable NFTs, legacy NFTs, and fungible tokens.

Available options:

V1_NFT,

V1_PRINT,

LEGACY_NFT,

V2_NFT,

FungibleAsset,

FungibleToken,

Custom,

Identity,

Executable,

ProgrammableNFT

Example:

"Custom"

params.royaltyTargetType

string

Royalty target type criteria.

Example:

"creators"

params.royaltyTarget

integer

Royalty target criteria.

Example:

0

params.royaltyAmount

integer

Royalty amount criteria.

Example:

0

params.ownerType

integer

Ownership model criteria.

Example:

1

params.before

string

A cursor for paginating backward.

Example:

"string"

params.after

string

A cursor for paginating forward.

Example:

"string"

params.options

object

Advanced display options for customizing the Solana asset search response.

Show child attributes

params.options.showUnverifiedCollections

boolean

default:false

Show unverified collections instead of skipping them.

params.options.showCollectionMetadata

boolean

default:false

Show metadata for the collection.

params.options.showGrandTotal

boolean

default:false

Show total number of matching assets (slower request).

params.options.showNativeBalance

boolean

default:false

Show the native (SOL) balance of the owner.

params.options.showInscription

boolean

default:false

Display inscription details.

params.options.showZeroBalance

boolean

default:false

Display assets with zero balance.

Response

Successful response

assets

object

Show child attributes

assets.last_indexed_slot

integer

All data up to and including this slot is guaranteed to have been indexed.

Example:

365750752

assets.total

integer

The total number of Solana NFTs and digital assets matching the search criteria.

Example:

80

assets.limit

integer

The maximum number of assets requested.

Example:

50

assets.page

integer

The current page of results.

Example:

1

assets.items

object[]

An array of assets.

Show child attributes

assets.items.interface

string

The Solana token standard implementation type of the digital asset.

assets.items.id

string

The unique mint address identifier of the Solana digital asset.

assets.items.ownership

object

Ownership details of the Solana digital asset including current owner and model.

assets.items.content

object

The content and metadata of the Solana digital asset including URI, attributes, and media.

Example:

{
  "total": 80,
  "limit": 50,
  "page": 1,
  "items": [
    {
      "interface": "V1_NFT",
      "id": "SomeNftMintKey12345",
      "ownership": {
        "owner": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        "ownership_model": "single"
      },
      "content": {
        "json_uri": "https://example.com/metadata/12345.json"
      }
    }
  ]
}

nativeBalance

object

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

Show child attributes

nativeBalance.lamports

integer

The number of lamports in the account.

nativeBalance.price_per_sol

number

The current price of SOL.

nativeBalance.total_price

number

The total SOL value in this account.

API Reference

Solana RPC APIs

Solana APIs

Data Streaming APIs

Event Listening APIs

Deprecated APIs

Authorizations

Body

Response