> ## 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.
# getAsset
> Получение подробной информации об одном NFT Solana, сжатом NFT или токене, включая метаданные, сведения о владельце, данные о цене и атрибуты в блокчейне
## Кеширование данных о цене
Данные о цене, возвращаемые getAsset, кешируются и могут быть неактуальными. Срок кеширования информации о цене составляет 600 секунд, поэтому данные могут быть устаревшими на 600 секунд.
Данные о цене доступны для 10 тыс. ведущих токенов по объёму торгов за 24 часа. Их можно найти в разделе `token_info.price_info` ответа. Для приложений, которым нужны цены в реальном времени, рекомендуется реализовать дополнительную проверку.
## Агенты MPL Core и группы MIP-11
При наличии соответствующих данных ответ может содержать значения `is_agent`, `agent_token`, `asset_signer`, `interface`, например `MplCoreGroup`, а также объект `plugins.groups` для членства в MIP-11. Те же необязательные поля возвращают `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority` и `searchAssets`. Подробнее о фильтрах `searchAssets` см. в [руководстве по поиску активов](/docs/ru/das/search).
## Параметры запроса
Уникальный идентификатор NFT Solana или цифрового актива, который требуется получить. Обычно это адрес минта NFT или токена.
Параметры отображения и форматирования данных об активе в ответе.
Отображает сведения о группировке для непроверенных коллекций вместо их пропуска.
Отображает метаданные коллекции.
Отображает взаимозаменяемые токены, принадлежащие владельцу.
## OpenAPI
````yaml ru/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: API стандарта цифровых активов Solana (DAS)
version: 1.0.0
description: >
API стандарта цифровых активов Solana (DAS) предоставляет комплексный и
стандартизированный доступ к NFT и цифровым активам блокчейна Solana.
Этот мощный набор API позволяет разработчикам получать подробную информацию
о любом цифровом активе в Solana,
включая как традиционные, так и сжатые NFT, с единообразным форматированием
данных независимо от стандарта токена.
Обратите внимание: каждый успешный ответ DAS содержит поле
`last_indexed_slot`, указывающее последний слот, для которого гарантируется
полнота индекса DAS.
Все данные в блокчейне **до этого слота включительно** проиндексированы.
Данные после этого слота также могут быть уже проиндексированы,
но это не гарантируется.
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: getAsset
description: >
Получите полные данные о любом NFT или цифровом активе Solana по его
уникальному идентификатору.
Эта конечная точка предоставляет полные метаданные из блокчейна и
внешних источников, сведения о владении, информацию о роялти,
данные коллекции и состояние сжатия для любого цифрового актива Solana.
Метод getAsset поддерживает все стандарты токенов,
включая сжатые NFT (cNFT), программируемые NFT (pNFT) и традиционные
токены SPL.
Используйте эту конечную точку, чтобы:
- Получать полные метаданные для объявлений на торговых площадках NFT
- Получать сведения о владении активами для интеграций с кошельками
- Получать доступ к данным о роялти и создателях для обеспечения выплаты
роялти
- Проверять состояние сжатия для выявления экономичных сжатых NFT
- Просматривать группировку по коллекциям для аналитики коллекций NFT
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: Версия протокола JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Уникальный идентификатор запроса.
example: '1'
default: '1'
method:
type: string
description: Имя вызываемого метода RPC.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
Уникальный идентификатор получаемого NFT или цифрового
актива Solana. Обычно это адрес выпуска NFT или токена.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: >-
Параметры отображения и форматирования данных об активе
в ответе.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Отображает сведения о группировке для непроверенных
коллекций вместо их пропуска.
showCollectionMetadata:
type: boolean
default: false
description: Отображает метаданные коллекции.
showFungible:
type: boolean
description: >-
Отображает взаимозаменяемые токены, принадлежащие
владельцу.
default: false
responses:
'200':
description: Успешный ответ
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Версия протокола JSON-RPC.
id:
type: string
description: Идентификатор, используемый для определения запроса.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Гарантируется, что все данные до этого слота
включительно проиндексированы.
interface:
type: string
description: >-
Тип интерфейса цифрового актива Solana, указывающий
его стандарт токена и реализацию.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Указывает, имеет ли этот актив идентификатор агента.
Значение true возможно только для активов MPL Core,
использующих внешний адаптер плагина AgentIdentity. По
умолчанию имеет значение false и при этом не
включается в ответ.
agent_token:
type: string
description: >-
Закодированный в Base58 адрес выпуска токена агента из
программы Agent Registry. Не включается, если для
актива нет соответствующей записи в реестре.
asset_signer:
type: string
description: >-
Закодированный в Base58 адрес PDA, используемый для
подписи от имени актива; для активов MPL Core он
детерминированно выводится из идентификатора актива.
Не включается, если неприменим.
id:
type: string
description: Уникальный идентификатор актива.
content:
type: object
description: >-
Сведения о содержимом цифрового актива Solana, включая
метаданные, файлы и ссылки.
properties:
$schema:
type: string
description: URL схемы метаданных актива.
json_uri:
type: string
description: >-
URI, указывающий на метаданные JSON для NFT
Solana, обычно размещенные в Arweave или другом
децентрализованном хранилище.
files:
type: array
description: Массив файлов, связанных с активом.
items:
type: object
metadata:
type: object
description: >-
Полные метаданные цифрового актива Solana, включая
имя, символ, атрибуты и стандарт токена.
properties:
name:
type: string
description: Имя актива.
symbol:
type: string
description: Символ актива.
attributes:
type: array
description: Массив атрибутов характеристик.
items:
type: object
properties:
value:
type: string
description: Значение характеристики.
trait_type:
type: string
description: Тип характеристики.
description:
type: string
description: Описание актива.
token_standard:
type: string
description: Используемый стандарт токена.
links:
type: object
description: Внешние ссылки, относящиеся к активу.
authorities:
type: array
description: Список управляющих субъектов, связанных с активом.
items:
type: object
properties:
address:
type: string
description: Адрес управляющего субъекта.
scopes:
type: array
description: Области полномочий.
items:
type: string
compression:
type: object
description: >-
Сведения о сжатии цифрового актива Solana,
указывающие, является ли он сжатым NFT с проверкой
доказательства состояния.
properties:
eligible:
type: boolean
description: Можно ли сжать актив.
compressed:
type: boolean
description: >-
Сжат ли актив в настоящее время с помощью
технологии сжатия состояния Solana, которая
снижает затраты на хранение.
data_hash:
type: string
description: Хеш данных актива.
creator_hash:
type: string
description: Хеш данных создателя.
asset_hash:
type: string
description: Хеш всего актива.
tree:
type: string
description: Адрес дерева Меркла.
seq:
type: integer
description: Порядковый номер.
leaf_id:
type: integer
description: Идентификатор листа в дереве Меркла.
grouping:
type: array
description: Сведения о группировке актива.
items:
type: object
properties:
group_key:
type: string
description: Ключ, идентифицирующий группу.
group_value:
type: string
description: Значение, связанное с группой.
royalty:
type: object
description: >-
Сведения о роялти для цифрового актива Solana,
используемые для расчета комиссий торговой площадки и
выплат создателям.
properties:
royalty_model:
type: string
description: Модель расчета роялти.
target:
type:
- string
- 'null'
description: Целевой адрес для роялти.
percent:
type: number
description: Процент роялти.
basis_points:
type: integer
description: Роялти в базисных пунктах.
primary_sale_happened:
type: boolean
description: Состоялась ли первичная продажа.
locked:
type: boolean
description: Заблокировано ли роялти.
creators:
type: array
description: Список создателей актива.
items:
type: object
properties:
address:
type: string
description: Адрес создателя.
share:
type: integer
description: Процентная доля создателя.
verified:
type: boolean
description: Проверен ли создатель.
ownership:
type: object
description: >-
Сведения о владении цифровым активом Solana, включая
текущего владельца, состояние делегирования и
информацию о заморозке.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: Заморожен ли актив.
delegated:
type: boolean
description: Делегирован ли актив.
delegate:
type:
- string
- 'null'
description: Адрес делегата, если актив делегирован.
ownership_model:
type: string
description: Модель владения.
owner:
type: string
description: Адрес владельца.
supply:
type:
- object
- 'null'
description: Сведения об объеме выпуска актива.
properties:
print_max_supply:
type: integer
description: Максимальный объем, который можно выпустить.
print_current_supply:
type: integer
description: Текущий выпущенный объем.
edition_nonce:
type: integer
description: Одноразовое значение издания.
mutable:
type: boolean
description: Можно ли изменять актив.
burnt:
type: boolean
description: Был ли актив сожжен.
token_info:
type: object
description: Сведения, относящиеся к токену.
properties:
supply:
type: integer
description: Общий объем выпуска токена.
decimals:
type: integer
description: Количество десятичных знаков.
token_program:
type: string
description: Идентификатор программы токена.
mint_authority:
type: string
description: Адрес управляющего выпуском.
freeze_authority:
type: string
description: Адрес управляющего заморозкой.
plugins:
type: object
description: >-
Полезная нагрузка плагина MPL Core. Может включать
плагин `groups` (MIP-11) для активов и коллекций.
additionalProperties: true
properties:
groups:
type: object
description: Плагин MIP-11 Groups с метаданными о членстве.
properties:
authority:
type: object
description: >-
Управляющий плагином (например,
UpdateAuthority).
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: >-
Членство этого актива или коллекции в
группах.
items:
type: object
properties:
group_address:
type: string
description: >-
Адрес учетной записи группы MPL Core в
формате Base58.
member_number:
type: integer
description: Номер участника в группе.
examples:
success:
value:
jsonrpc: '2.0'
id: test
result:
last_indexed_slot: 365749093
interface: ProgrammableNFT
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
content:
$schema: https://schema.metaplex.com/nft1.0.json
json_uri: >-
https://madlads.s3.us-west-2.amazonaws.com/json/8420.json
files:
- uri: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
mime: image/png
- uri: >-
https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
mime: image/png
metadata:
attributes:
- value: Male
trait_type: Gender
- value: King
trait_type: Type
- value: Royal
trait_type: Expression
- value: Mad Crown
trait_type: Hat
- value: Madness
trait_type: Eyes
- value: Mad Armor
trait_type: Clothing
- value: Royal Rug
trait_type: Background
description: Fock it.
name: 'Mad Lads #8420'
symbol: MAD
token_standard: ProgrammableNonFungible
links:
image: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
external_url: https://madlads.com
authorities:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
share: 100
verified: true
ownership:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue
supply:
print_max_supply: 0
print_current_supply: 0
edition_nonce: 254
mutable: true
burnt: false
token_info:
supply: 1
decimals: 0
token_program: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
mint_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
freeze_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
'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.