> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# searchAssets
> Поиск и фильтрация NFT Solana, сжатых NFT и токенов по гибким критериям, включая владельцев, создателей, коллекции и пользовательские атрибуты
## Параметры запроса
Адрес кошелька Solana, цифровые активы которого необходимо получить для фильтрации результатов поиска.
Фильтр по определенным типам токенов Solana, включая сжатые NFT (cNFT), обычные NFT,
программируемые NFT (pNFT) и взаимозаменяемые токены SPL, для целевого поиска активов.
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
Страница результатов, которую необходимо вернуть.
Критерий адреса полномочного аккаунта для фильтрации цифровых активов Solana по полномочиям программы,
полезный для поиска активов, контролируемых определенными протоколами или полномочными аккаунтами обновления.
Максимальное количество возвращаемых активов.
Параметры сортировки ответа.
Критерий сортировки активов.
* `created`
* `recent_action`
* `updated`
* `none`
Направление сортировки.
* `asc`
* `desc`
Фильтр по сжатым NFT Solana (cNFT), которые используют технологию сжатия состояния
для снижения затрат на хранение и улучшения масштабируемости.
Фильтр по активам Solana, которые допускают сжатие, но еще не были
сжаты в формат сжатия состояния.
Критерий делегата для поиска активов.
Критерий адреса кошелька создателя для поиска NFT Solana, созданных определенными художниками,
проектами или авторами, с целью отслеживания авторства и роялти.
Указывает, верифицирован ли создатель.
Массив группировки коллекций для фильтрации NFT Solana по принадлежности к коллекции
(например, \["collection", "\"]) и поиска связанных активов.
Адрес дерева Меркла для фильтрации сжатых NFT (cNFT) по дереву их коллекции.
Этот параметр относится только к Helius и не входит в официальную спецификацию DAS.
Критерий предложения для поиска активов.
Критерий адреса выпуска предложения для поиска активов.
Указывает, заморожен ли актив.
Указывает, сожжен ли актив.
Фильтр активов с идентификатором агента (внешним плагином MPL Core AgentIdentity).
Фильтр по адресу выпуска токена агента в формате base58 из программы Agent Registry.
Фильтр по PDA подписанта актива в формате base58 (MPL Core).
Тип интерфейса стандарта токенов Solana для фильтрации определенных реализаций NFT,
включая программируемые NFT, устаревшие NFT, взаимозаменяемые токены, а также активы, коллекции и группы MPL Core (MIP-11).
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
Критерий типа получателя роялти.
Критерий получателя роялти.
Критерий суммы роялти.
Критерий модели владения.
Курсор для постраничного перехода назад.
Курсор для постраничного перехода вперед.
Расширенные параметры отображения для настройки ответа поиска активов Solana.
Показывать неверифицированные коллекции, а не пропускать их.
Показывать метаданные коллекции.
Показывать общее количество соответствующих активов (запрос выполняется медленнее).
Показывать нативный баланс владельца (SOL).
Показывать активы с нулевым балансом.
## OpenAPI
````yaml ru/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: API поиска и обнаружения NFT Solana
version: 1.0.0
description: >
Расширенный API стандарта цифровых активов Solana (DAS) для поиска и
обнаружения NFT, токенов и других цифровых активов во всей экосистеме Solana
с широкими возможностями фильтрации.
Этот комплексный поисковый API служит основой для маркетплейсов NFT,
приложений для управления портфелями и аналитических платформ,
позволяя обнаруживать и фильтровать цифровые активы по нескольким критериям,
включая коллекции, создателей, состояние сжатия
и владельца. Поддерживаются как традиционные, так и сжатые NFT во всей
экосистеме Solana.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Конечная точка RPC основной сети
- url: https://devnet.helius-rpc.com
description: Конечная точка RPC тестовой сети Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: searchAssets
description: >
Ищите и обнаруживайте цифровые активы Solana с помощью комплексных
параметров фильтрации.
Этот мощный API обнаружения позволяет приложениям находить NFT, сжатые
NFT, взаимозаменяемые токены
и другие цифровые активы по нескольким критериям, включая владельца,
создателей, коллекции,
состояние сжатия и атрибуты метаданных. Идеально подходит для
маркетплейсов, систем
отслеживания портфелей и аналитических платформ, которым требуются
расширенные возможности обнаружения активов
во всей экосистеме Solana.
Основные возможности:
- Поиск по нескольким критериям во всех стандартах NFT Solana
(традиционных, сжатых и программируемых)
- Фильтрация по коллекциям для проектов и сообществ NFT
- Запросы по создателям и владельцам для атрибуции и анализа портфелей
- Фильтрация по состоянию сжатия для выявления экономичных активов
- Поиск по атрибутам метаданных для обнаружения на основе характеристик
- Полная поддержка пагинации для больших наборов результатов
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Версия протокола JSON-RPC.
default: '2.0'
id:
type: string
description: Идентификатор запроса.
default: '1'
method:
type: string
enum:
- searchAssets
description: Имя вызываемого метода JSON-RPC.
default: searchAssets
params:
type: object
description: Параметры метода `searchAssets`.
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: >-
Адрес кошелька Solana, цифровые активы которого
необходимо получить для фильтрации результатов поиска.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >
Фильтр по определенным типам токенов Solana, включая
сжатые NFT (cNFT), обычные NFT,
программируемые NFT (pNFT) и взаимозаменяемые токены
SPL, для целевого обнаружения активов.
example: all
page:
type: integer
description: Страница результатов, которую необходимо вернуть.
example: 1
authorityAddress:
type: string
description: >
Критерий адреса полномочий для фильтрации цифровых
активов Solana по полномочиям программы.
Полезен для поиска активов, контролируемых определенными
протоколами или полномочиями обновления.
example: string
limit:
type: integer
description: Максимальное количество возвращаемых активов.
example: 100
sortBy:
type: object
description: Параметры сортировки ответа.
properties:
sortBy:
type: string
description: Критерий сортировки активов.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: Направление сортировки.
enum:
- asc
- desc
compressed:
type: boolean
description: >
Фильтр сжатых NFT Solana (cNFT), использующих технологию
сжатия состояния
для снижения затрат на хранение и повышения
масштабируемости.
example: true
compressible:
type: boolean
description: >
Фильтр активов Solana, которые можно сжать, но которые
еще не были
преобразованы в формат со сжатием состояния.
example: false
delegate:
type: integer
description: Критерий делегата для поиска активов.
creatorAddress:
type: string
description: >
Критерий адреса кошелька создателя для поиска NFT
Solana, созданных определенными художниками,
проектами или авторами, с целью атрибуции и отслеживания
роялти.
example: string
creatorVerified:
type: boolean
description: Указывает, подтвержден ли создатель.
example: true
grouping:
type: array
items:
type: string
description: >
Массив группировки коллекций для фильтрации NFT Solana
по принадлежности к коллекции
(например, ["collection", ""]) и поиска
связанных активов.
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: >
Адрес дерева Меркла для фильтрации сжатых NFT (cNFT) по
дереву их коллекции.
Этот параметр относится только к Helius и не входит в
официальную спецификацию DAS.
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: Критерий объема предложения для поиска активов.
example: 0
supplyMint:
type: string
description: Критерий адреса выпуска предложения для поиска активов.
frozen:
type: boolean
description: Указывает, заморожен ли актив.
example: false
burnt:
type: boolean
description: Указывает, сожжен ли актив.
example: false
isAgent:
type: boolean
description: >-
Фильтр активов с идентификатором агента (внешний плагин
MPL Core AgentIdentity).
agentToken:
type: string
description: >-
Фильтр по адресу выпуска токена агента в формате base58
из программы Agent Registry.
assetSigner:
type: string
description: >-
Фильтр по PDA подписанта актива в формате base58 (MPL
Core).
interface:
type: string
description: >
Тип интерфейса стандарта токенов Solana для фильтрации
определенных реализаций NFT,
включая программируемые NFT, устаревшие NFT,
взаимозаменяемые токены, а также активы, коллекции и
группы MPL Core (MIP-11).
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: Custom
royaltyTargetType:
type: string
description: Критерий типа получателя роялти.
example: creators
royaltyTarget:
type: integer
description: Критерий получателя роялти.
example: 0
royaltyAmount:
type: integer
description: Критерий суммы роялти.
example: 0
ownerType:
type: integer
description: Критерий модели владения.
example: 1
before:
type: string
description: Курсор для пагинации назад.
example: string
after:
type: string
description: Курсор для пагинации вперед.
example: string
options:
type: object
description: >-
Расширенные параметры отображения для настройки ответа
поиска активов Solana.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Показывать неподтвержденные коллекции вместо их
пропуска.
showCollectionMetadata:
type: boolean
default: false
description: Показывать метаданные коллекции.
showGrandTotal:
type: boolean
default: false
description: >-
Показывать общее количество соответствующих активов
(запрос выполняется медленнее).
showNativeBalance:
type: boolean
default: false
description: Показывать нативный баланс владельца в SOL.
showZeroBalance:
type: boolean
default: false
description: Показывать активы с нулевым балансом.
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: Успешный ответ
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Гарантируется, что проиндексированы все данные вплоть
до этого слота включительно.
example: 365750752
total:
type: integer
description: >-
Общее количество NFT и цифровых активов Solana,
соответствующих критериям поиска.
example: 80
limit:
type: integer
description: Запрошенное максимальное количество активов.
example: 50
page:
type: integer
description: Текущая страница результатов.
example: 1
items:
type: array
description: Массив активов.
items:
type: object
properties:
interface:
type: string
description: >-
Тип реализации стандарта токенов Solana для
цифрового актива.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Указывает, есть ли у этого актива идентификатор
агента (внешний плагин MPL Core AgentIdentity).
Если значение равно false, поле отсутствует.
agent_token:
type: string
description: >-
Закодированный в base58 адрес выпуска токена
агента из программы Agent Registry. Если токен
не зарегистрирован, поле отсутствует.
asset_signer:
type: string
description: >-
Закодированный в base58 PDA подписанта актива
для MPL Core. Если неприменимо, поле
отсутствует.
plugins:
type: object
description: >-
Плагины MPL Core, включая необязательное
членство в `groups` MIP-11.
additionalProperties: true
id:
type: string
description: >-
Уникальный идентификатор адреса выпуска
цифрового актива Solana.
ownership:
type: object
description: >-
Сведения о владении цифровым активом Solana,
включая текущего владельца и модель владения.
content:
type: object
description: >-
Контент и метаданные цифрового актива Solana,
включая URI, атрибуты и медиафайлы.
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:
type: object
description: >-
Нативный баланс учетной записи кошелька Solana в лампортах
и его стоимость в долларах США.
properties:
lamports:
type: integer
description: Количество лампортов в учетной записи.
price_per_sol:
type: number
description: Текущая цена SOL.
total_price:
type: number
description: Общая стоимость SOL в этой учетной записи.
'400':
description: >-
Некорректный запрос. Сервер не смог понять запрос из-за
недопустимого синтаксиса.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32602
message:
type: string
example: Недопустимые параметры запроса.
id:
type: string
example: '1'
'401':
description: >-
Не авторизовано. Клиент должен пройти аутентификацию, чтобы получить
запрошенный ответ.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: >-
Ошибка аутентификации. Ключ API отсутствует или
недействителен.
id:
type: string
example: '1'
'403':
description: Доступ запрещен. У клиента нет прав доступа к содержимому.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32003
message:
type: string
example: У вас нет разрешения на доступ к этому ресурсу.
id:
type: string
example: '1'
'404':
description: Не найдено. Сервер не может найти запрошенный ресурс.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32004
message:
type: string
example: Активы, соответствующие критериям поиска, не найдены.
id:
type: string
example: '1'
'429':
description: >-
Слишком много запросов. Пользователь отправил слишком много запросов
за указанный промежуток времени.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32029
message:
type: string
example: >-
Превышено ограничение частоты запросов. Повторите
попытку позже.
id:
type: string
example: '1'
'500':
description: >-
Внутренняя ошибка сервера. Сервер столкнулся с ситуацией, которую не
может обработать.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32000
message:
type: string
example: На сервере произошла непредвиденная ошибка.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Ваш ключ API Helius. Его можно бесплатно получить в [панели
управления](https://dashboard.helius.dev/api-keys).
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.