searchAssets

Обзор

searchAssets объединяет фильтры в одном запросе. Используйте его, когда ни один отдельный метод getAssetsBy* не подходит, например для запроса «сжатые NFT из этой коллекции, принадлежащие этому кошельку» или «взаимозаменяемые токены, которые хранит этот кошелёк». По умолчанию должен совпасть каждый фильтр (conditionType: "all"). Задайте conditionType: "any", чтобы найти активы, удовлетворяющие хотя бы одному фильтру, и negate: true, чтобы инвертировать результат.

Параметры

Фильтры

string

Кошелёк владельца (base-58).

string

Адрес создателя (base-58).

boolean

Вместе с creatorAddress находить только верифицированных создателей.

string

Адрес полномочия (base-58).

[string, string]

Ключ и значение группы, например ["collection", "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"].

string

Адрес делегата (base-58).

string

Интерфейс актива, например V1_NFT, ProgrammableNFT, MplCoreAsset или FungibleToken. Полный список см. в разделе Объект актива.

string

fungible, nonFungible, regularNFT, compressedNFT или all.

string

single (NFT) или token (взаимозаменяемые токены).

boolean

Находить сжатые или несжатые активы.

boolean

Находить активы, которые можно сжать.

boolean

Находить замороженные или незамороженные активы.

boolean

Находить сожжённые или действующие активы.

number

Находить по точному значению предложения.

string

Находить по минту предложения (base-58).

string

creators, fanout или single.

string

Адрес получателя роялти (base-58).

number

Роялти в базисных пунктах.

string

Точный URI JSON-метаданных.

string

Название актива. Требует ownerAddress.

Логика

string

all (по умолчанию) или any.

boolean

Возвращать активы, которые не соответствуют условиям.

Пагинация и вывод

number

Номер страницы, начиная с 1. См. Пагинация.

number

Количество результатов на странице. Максимум и значение по умолчанию: 1 000.

string

Курсор из предыдущего ответа.

string

Вернуть активы с ID до указанного.

string

Вернуть активы с ID после указанного.

object

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

object

Параметры отображения: showNativeBalance (с ownerAddress), showUnverifiedCollections, showCollectionMetadata, showInscription. Также принимается как displayOptions.

Ответ

Список с last_indexed_slot, total, limit, page или cursor, items (объекты активов) и, при showNativeBalance, nativeBalance.

Примеры кода

Действующие NFT в коллекции

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
}

Взаимозаменяемые токены в кошельке

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 }
  }
}'

Сжатые NFT из одной коллекции в кошельке

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`);

Распространённые ошибки

Код	Сообщение	Решение
-32602	Owner address must be provided in order to search assets by name	Добавьте `ownerAddress` при фильтрации по `name`
-32602	Validation Error: Invalid pubkey …	Убедитесь, что каждый фильтр по адресу содержит действительное значение base-58
-32602	unknown field	Проверьте названия параметров; фильтры записываются в camelCase
-32602	Pagination Sorting Error	Курсорам и диапазонам требуется `sortBy: "id"`; для других видов сортировки используйте `page`

Начало работы

Продукты

Решения

Получение данных

DAS API

RPC

Потоковые данные

Apex

Торговые API

Обзор

Параметры

Фильтры

Логика

Пагинация и вывод

Ответ

Примеры кода

Действующие NFT в коллекции

Взаимозаменяемые токены в кошельке

Сжатые NFT из одной коллекции в кошельке

Распространённые ошибки

​Обзор

​Параметры

​Фильтры

​Логика

​Пагинация и вывод

​Ответ

​Примеры кода

​Действующие NFT в коллекции

​Взаимозаменяемые токены в кошельке

​Сжатые NFT из одной коллекции в кошельке

​Распространённые ошибки

Обзор

Параметры

Фильтры

Логика

Пагинация и вывод

Ответ

Примеры кода

Действующие NFT в коллекции

Взаимозаменяемые токены в кошельке

Сжатые NFT из одной коллекции в кошельке

Распространённые ошибки