Tokens & NFTs (DAS)
searchAssets
Search and filter Solana NFTs, compressed NFTs, and tokens using flexible criteria including ownership, creators, collections, and custom attributes
POST
/
searchAssets
curl --request POST \
--url 'https://mainnet.helius-rpc.com/?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "my-id",
"method": "searchAssets",
"params": {
"ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"tokenType": "all",
"limit": 50
}
}
'import requests
url = "https://mainnet.helius-rpc.com/?api-key="
payload = {
"jsonrpc": "2.0",
"id": "my-id",
"method": "searchAssets",
"params": {
"ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"tokenType": "all",
"limit": 50
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
jsonrpc: '2.0',
id: 'my-id',
method: 'searchAssets',
params: {
ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
tokenType: 'all',
limit: 50
}
})
};
fetch('https://mainnet.helius-rpc.com/?api-key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.helius-rpc.com/?api-key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'jsonrpc' => '2.0',
'id' => 'my-id',
'method' => 'searchAssets',
'params' => [
'ownerAddress' => '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
'tokenType' => 'all',
'limit' => 50
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://mainnet.helius-rpc.com/?api-key="
payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"my-id\",\n \"method\": \"searchAssets\",\n \"params\": {\n \"ownerAddress\": \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n \"tokenType\": \"all\",\n \"limit\": 50\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://mainnet.helius-rpc.com/?api-key=")
.header("Content-Type", "application/json")
.body("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"my-id\",\n \"method\": \"searchAssets\",\n \"params\": {\n \"ownerAddress\": \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n \"tokenType\": \"all\",\n \"limit\": 50\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.helius-rpc.com/?api-key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"jsonrpc\": \"2.0\",\n \"id\": \"my-id\",\n \"method\": \"searchAssets\",\n \"params\": {\n \"ownerAddress\": \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n \"tokenType\": \"all\",\n \"limit\": 50\n }\n}"
response = http.request(request)
puts response.read_body{
"assets": {
"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": {
"lamports": 123,
"price_per_sol": 123,
"total_price": 123
}
}{
"jsonrpc": "2.0",
"error": {
"code": -32602,
"message": "Invalid request parameters."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "Authentication failed. Missing or invalid API key."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32003,
"message": "You do not have permission to access this resource."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32004,
"message": "No assets found matching the search criteria."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32029,
"message": "Rate limit exceeded. Please try again later."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32000,
"message": "An unexpected error occurred on the server."
},
"id": "1"
}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.
fungiblenonFungibleregularNftcompressedNftall
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.
createdrecent_actionupdatednone
string
The sorting direction.
ascdesc
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_NFTV1_PRINTLEGACY_NFTV2_NFTFungibleAssetFungibleTokenCustomIdentityExecutableProgrammableNFTMplCoreAssetMplBubblegumV2MplCoreCollectionMplCoreGroup
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
Body
application/json
The version of the JSON-RPC protocol.
Available options:
2.0 An ID to identify the request.
The name of the JSON-RPC method to invoke.
Available options:
searchAssets Parameters for the searchAssets method.
Show child attributes
Show child attributes
Response
Successful response
Show child attributes
Show child attributes
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"
}
}
]
}
The native SOL balance of the Solana wallet account in lamports and USD value.
Show child attributes
Show child attributes
Was this page helpful?
⌘I
searchAssets
curl --request POST \
--url 'https://mainnet.helius-rpc.com/?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "my-id",
"method": "searchAssets",
"params": {
"ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"tokenType": "all",
"limit": 50
}
}
'import requests
url = "https://mainnet.helius-rpc.com/?api-key="
payload = {
"jsonrpc": "2.0",
"id": "my-id",
"method": "searchAssets",
"params": {
"ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"tokenType": "all",
"limit": 50
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
jsonrpc: '2.0',
id: 'my-id',
method: 'searchAssets',
params: {
ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
tokenType: 'all',
limit: 50
}
})
};
fetch('https://mainnet.helius-rpc.com/?api-key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.helius-rpc.com/?api-key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'jsonrpc' => '2.0',
'id' => 'my-id',
'method' => 'searchAssets',
'params' => [
'ownerAddress' => '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
'tokenType' => 'all',
'limit' => 50
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://mainnet.helius-rpc.com/?api-key="
payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"my-id\",\n \"method\": \"searchAssets\",\n \"params\": {\n \"ownerAddress\": \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n \"tokenType\": \"all\",\n \"limit\": 50\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://mainnet.helius-rpc.com/?api-key=")
.header("Content-Type", "application/json")
.body("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"my-id\",\n \"method\": \"searchAssets\",\n \"params\": {\n \"ownerAddress\": \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n \"tokenType\": \"all\",\n \"limit\": 50\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.helius-rpc.com/?api-key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"jsonrpc\": \"2.0\",\n \"id\": \"my-id\",\n \"method\": \"searchAssets\",\n \"params\": {\n \"ownerAddress\": \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n \"tokenType\": \"all\",\n \"limit\": 50\n }\n}"
response = http.request(request)
puts response.read_body{
"assets": {
"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": {
"lamports": 123,
"price_per_sol": 123,
"total_price": 123
}
}{
"jsonrpc": "2.0",
"error": {
"code": -32602,
"message": "Invalid request parameters."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "Authentication failed. Missing or invalid API key."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32003,
"message": "You do not have permission to access this resource."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32004,
"message": "No assets found matching the search criteria."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32029,
"message": "Rate limit exceeded. Please try again later."
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32000,
"message": "An unexpected error occurred on the server."
},
"id": "1"
}