searchAssets

Overview

searchAssets combines filters in one query. Use it when no single getAssetsBy* method fits, for example “compressed NFTs in this collection owned by this wallet” or “fungible tokens this wallet holds”. By default every filter must match (conditionType: "all"). Set conditionType: "any" to match assets that satisfy at least one filter, and negate: true to invert the result.

Parameters

Filters

string

Owner wallet (base-58).

string

Creator address (base-58).

boolean

With creatorAddress, match only verified creators.

string

Authority address (base-58).

[string, string]

Group key and value, for example ["collection", "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"].

string

Delegate address (base-58).

string

Asset interface, such as V1_NFT, ProgrammableNFT, MplCoreAsset or FungibleToken. See Asset object for the full list.

string

fungible, nonFungible, regularNFT, compressedNFT or all.

string

single (NFTs) or token (fungible tokens).

boolean

Match compressed or uncompressed assets.

boolean

Match assets that can be compressed.

boolean

Match frozen or unfrozen assets.

boolean

Match burned or live assets.

number

Match an exact supply.

string

Match by supply mint (base-58).

string

creators, fanout or single.

string

Royalty recipient address (base-58).

number

Royalty in basis points.

string

Exact metadata JSON URI.

string

Asset name. Requires ownerAddress.

Logic

string

all (default) or any.

boolean

Return assets that do not match.

Paging and output

number

Page number, starting at 1. See Pagination.

number

Results per page. Maximum and default 1,000.

string

Cursor from a previous response.

string

Return assets with IDs before this one.

string

Return assets with IDs after this one.

object

{ "sortBy": "id" | "created" | "updated" | "recent_action" | "none", "sortDirection": "asc" | "desc" }

object

Display options: showNativeBalance (with ownerAddress), showUnverifiedCollections, showCollectionMetadata, showInscription. Also accepted as displayOptions.

Response

A list with last_indexed_slot, total, limit, page or cursor, items (asset objects) and, with showNativeBalance, nativeBalance.

Code Examples

Live NFTs in a collection

curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "searchAssets",
  "params": {
    "grouping": ["collection", "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"],
    "burnt": false,
    "page": 1,
    "limit": 1
  }
}'

{
  "jsonrpc": "2.0",
  "result": {
    "last_indexed_slot": 457714710,
    "total": 1,
    "limit": 1,
    "page": 1,
    "items": [
      {
        "interface": "ProgrammableNFT",
        "id": "JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC",
        "content": {
          "metadata": { "name": "Mad Lads #6867", "symbol": "MAD" }
        },
        "burnt": false
      }
    ]
  },
  "id": 1
}

Fungible tokens a wallet holds

curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "searchAssets",
  "params": {
    "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
    "tokenType": "fungible",
    "page": 1,
    "limit": 100,
    "options": { "showNativeBalance": true }
  }
}'

Compressed NFTs a wallet holds in one collection

const RPC_URL = 'https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY';

const response = await fetch(RPC_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'searchAssets',
    params: {
      ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      grouping: ['collection', 'DRiP3vrQ7LuvQtmwL74RcejviWmQ1HuuKFcJdUpYG6Di'],
      compressed: true,
      page: 1,
      limit: 1000,
    },
  }),
});
const { result } = await response.json();
console.log(`${result.items.length} compressed DRiP NFTs`);

Common Errors

Code	Message	Solution
-32602	Owner address must be provided in order to search assets by name	Add `ownerAddress` when filtering by `name`
-32602	Validation Error: Invalid pubkey …	Check every address filter is valid base-58
-32602	unknown field	Check parameter names; filters are camelCase
-32602	Pagination Sorting Error	Cursors and ranges need `sortBy: "id"`; use `page` with other sorts

Get Started

Agents

Products

Solutions

Fetching Data

DAS API

RPC

Data Streaming

Apex

Trading APIs

Overview

Parameters

Filters

Logic

Paging and output

Response

Code Examples

Live NFTs in a collection

Fungible tokens a wallet holds

Compressed NFTs a wallet holds in one collection

Common Errors

​Overview

​Parameters

​Filters

​Logic

​Paging and output

​Response

​Code Examples

​Live NFTs in a collection

​Fungible tokens a wallet holds

​Compressed NFTs a wallet holds in one collection

​Common Errors

Overview

Parameters

Filters

Logic

Paging and output

Response

Code Examples

Live NFTs in a collection

Fungible tokens a wallet holds

Compressed NFTs a wallet holds in one collection

Common Errors