> ## 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
> Recuperar informações detalhadas de um único NFT Solana, NFT comprimido ou token, incluindo metadados, propriedade, dados de preço e atributos on-chain
## Cache de Dados de Preço
Os dados de preço retornados por getAsset são armazenados em cache e podem não estar atualizados. As informações de preço têm um cache de 600 segundos, o que significa que os dados podem ter até 600 segundos de atraso.
Os dados de preço estão disponíveis para os 10 mil principais tokens por volume de 24h e podem ser encontrados na seção `token_info.price_info` da resposta. Para aplicativos que exigem preços em tempo real, considere implementar uma validação adicional.
## Agentes MPL Core e grupos MIP-11
Quando presentes, a resposta pode incluir valores `is_agent`, `agent_token`, `asset_signer`, `interface`, como `MplCoreGroup`, e um objeto `plugins.groups` para associação MIP-11. Os mesmos campos opcionais são retornados por `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority`, e `searchAssets`. Veja o [Guia de busca de ativos](/docs/pt-BR/das/search) para filtros `searchAssets`.
## Parâmetros da Solicitação
O identificador único do NFT Solana ou ativo digital a ser recuperado. Este é tipicamente o endereço de cunhagem do NFT ou token.
Opções de exibição e formatação para a resposta de dados do ativo.
Exibe informações de agrupamento para coleções não verificadas em vez de ignorá-las.
Exibe metadados para a coleção.
Exibe tokens fungíveis mantidos pelo proprietário.
## OpenAPI
````yaml pt-BR/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: Solana Digital Asset Standard (DAS) API
version: 1.0.0
description: >
A Solana Digital Asset Standard (DAS) API fornece acesso abrangente e
padronizado aos NFTs e ativos digitais da blockchain Solana.
Este conjunto poderoso de API permite que os desenvolvedores recuperem
informações detalhadas sobre qualquer ativo digital no Solana,
incluindo NFTs tradicionais e comprimidos, com formatação de dados
consistente independente do padrão do token.
Observe que cada resposta DAS bem-sucedida inclui um campo
`last_indexed_slot` indicando o slot mais recente para o qual o índice DAS é
garantido como
completo. Todos os dados on-chain **até e incluindo** este slot foram
indexados. Dados além deste slot também podem já ter sido indexados,
embora não seja garantido.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAsset
description: >
Recupere dados abrangentes de qualquer NFT ou ativo digital Solana pelo
seu identificador único.
Este endpoint fornece metadados completos on-chain e off-chain, detalhes
de propriedade, informações de royalties,
dados de coleção e estado de compressão para qualquer ativo digital
Solana. O método getAsset suporta todos os padrões de token
incluindo NFTs comprimidos (cNFTs), NFTs programáveis (pNFTs) e tokens
SPL tradicionais.
Use este endpoint para:
- Buscar metadados completos para listagens de mercado de NFT
- Recuperar informações de propriedade de ativos para integrações de
carteira
- Acessar dados de royalties e criadores para aplicação de royalties
- Verificar status de compressão para identificar NFTs comprimidos de
forma econômica
- Visualizar agrupamento de coleções para análises de coleções de NFT
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Um identificador único para a solicitação.
example: '1'
default: '1'
method:
type: string
description: O nome do método RPC a ser invocado.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
O identificador único do NFT ou ativo digital Solana a
ser recuperado. Isso é tipicamente o endereço de mint do
NFT ou token.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: >-
Opções de exibição e formatação para a resposta de dados
do ativo.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Exibe informações de agrupamento para coleções não
verificadas em vez de pulá-las.
showCollectionMetadata:
type: boolean
default: false
description: Exibe metadados para a coleção.
showFungible:
type: boolean
description: Exibe tokens fungíveis mantidos pelo proprietário.
default: false
responses:
'200':
description: Resposta bem-sucedida
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
id:
type: string
description: O ID usado para identificar a solicitação.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Todos os dados até e incluindo este slot são
garantidos como indexados.
interface:
type: string
description: >-
O tipo de interface do ativo digital Solana, indicando
seu padrão de token e implementação.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Se este ativo tem uma Identidade de Agente. Somente
verdadeiro para ativos MPL Core que usam o adaptador
de plugin externo AgentIdentity. O padrão é falso e é
omitido da resposta quando falso.
agent_token:
type: string
description: >-
Endereço de mint codificado em Base58 do token de
agente do programa de Registro de Agentes. Omitido
quando o ativo não tem entrada correspondente no
registro.
asset_signer:
type: string
description: >-
PDA codificado em Base58 usado para assinar em nome do
ativo; derivado deterministicamente do ID do ativo
para ativos MPL Core. Omitido quando não aplicável.
id:
type: string
description: O identificador único do ativo.
content:
type: object
description: >-
Informações de conteúdo do ativo digital Solana,
incluindo metadados, arquivos e links.
properties:
$schema:
type: string
description: A URL do esquema para os metadados do ativo.
json_uri:
type: string
description: >-
URI apontando para os metadados JSON do NFT
Solana, tipicamente hospedado no Arweave ou outro
armazenamento descentralizado.
files:
type: array
description: Array de arquivos associados com o ativo.
items:
type: object
metadata:
type: object
description: >-
Informações completas dos metadados sobre o ativo
digital Solana, incluindo nome, símbolo, atributos
e padrão de token.
properties:
name:
type: string
description: O nome do ativo.
symbol:
type: string
description: O símbolo do ativo.
attributes:
type: array
description: Array de atributos de traço.
items:
type: object
properties:
value:
type: string
description: O valor do traço.
trait_type:
type: string
description: O tipo do traço.
description:
type: string
description: Descrição do ativo.
token_standard:
type: string
description: Padrão de token utilizado.
links:
type: object
description: Links externos relacionados ao ativo.
authorities:
type: array
description: Lista de autoridades associadas ao ativo.
items:
type: object
properties:
address:
type: string
description: O endereço da autoridade.
scopes:
type: array
description: Os escopos da autoridade.
items:
type: string
compression:
type: object
description: >-
Detalhes de compressão do ativo digital Solana,
indicando se é um NFT comprimido com validação de
prova de estado.
properties:
eligible:
type: boolean
description: Se o ativo é elegível para compressão.
compressed:
type: boolean
description: >-
Se o ativo está atualmente comprimido usando a
tecnologia de compressão de estado do Solana, o
que reduz os custos de armazenamento.
data_hash:
type: string
description: Hash dos dados do ativo.
creator_hash:
type: string
description: Hash dos dados do criador.
asset_hash:
type: string
description: Hash do ativo inteiro.
tree:
type: string
description: Endereço da árvore Merkle.
seq:
type: integer
description: Número de sequência.
leaf_id:
type: integer
description: Identificador de folha na árvore Merkle.
grouping:
type: array
description: Informações de agrupamento para o ativo.
items:
type: object
properties:
group_key:
type: string
description: A chave que identifica o grupo.
group_value:
type: string
description: O valor associado com o grupo.
royalty:
type: object
description: >-
Informações de royalties para o ativo digital Solana,
usadas para cálculos de taxas de mercado e pagamentos
aos criadores.
properties:
royalty_model:
type: string
description: O modelo usado para royalties.
target:
type:
- string
- 'null'
description: O endereço de destino para royalties.
percent:
type: number
description: Percentual de royalties.
basis_points:
type: integer
description: Pontos base de royalties.
primary_sale_happened:
type: boolean
description: Se a venda primária ocorreu.
locked:
type: boolean
description: Se o royalty está bloqueado.
creators:
type: array
description: Lista de criadores do ativo.
items:
type: object
properties:
address:
type: string
description: O endereço do criador.
share:
type: integer
description: A porcentagem de participação do criador.
verified:
type: boolean
description: Se o criador é verificado.
ownership:
type: object
description: >-
Detalhes de propriedade do ativo digital Solana,
incluindo proprietário atual, status de delegação e
informações de congelamento.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: Se o ativo está congelado.
delegated:
type: boolean
description: Se o ativo está delegado.
delegate:
type:
- string
- 'null'
description: O endereço do delegado se delegado.
ownership_model:
type: string
description: O modelo de propriedade.
owner:
type: string
description: O endereço do proprietário.
supply:
type:
- object
- 'null'
description: Informações de fornecimento para o ativo.
properties:
print_max_supply:
type: integer
description: Fornecimento máximo que pode ser impresso.
print_current_supply:
type: integer
description: Fornecimento atual impresso.
edition_nonce:
type: integer
description: Nonce da edição.
mutable:
type: boolean
description: Se o ativo é mutável.
burnt:
type: boolean
description: Se o ativo foi queimado.
token_info:
type: object
description: Informações específicas do token.
properties:
supply:
type: integer
description: Fornecimento total de token.
decimals:
type: integer
description: Número de decimais.
token_program:
type: string
description: ID do programa de token.
mint_authority:
type: string
description: Endereço da autoridade de mint.
freeze_authority:
type: string
description: Endereço da autoridade de congelamento.
plugins:
type: object
description: >-
Payload de plugin MPL Core. Pode incluir um plugin
`groups` (MIP-11) em ativos e coleções.
additionalProperties: true
properties:
groups:
type: object
description: Plugin MIP-11 Groups com metadados de associação.
properties:
authority:
type: object
description: >-
Autoridade do plugin (por exemplo,
UpdateAuthority).
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: >-
Grupos de associação para este ativo ou
coleção.
items:
type: object
properties:
group_address:
type: string
description: >-
Endereço Base58 da conta do grupo MPL
Core.
member_number:
type: integer
description: Número do membro dentro do grupo.
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: >-
Solicitação Incorreta. O servidor não conseguiu entender a
solicitação devido à sintaxe inválida.
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: Parâmetros de solicitação inválidos.
id:
type: string
example: '1'
'401':
description: >-
Não autorizado. O cliente deve se autenticar para obter a resposta
solicitada.
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: >-
Falha na autenticação. Chave de API ausente ou
inválida.
id:
type: string
example: '1'
'403':
description: Proibido. O cliente não tem direitos de acesso ao conteúdo.
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: Você não tem permissão para acessar este recurso.
id:
type: string
example: '1'
'404':
description: Não encontrado. O servidor não pode encontrar o recurso solicitado.
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: O ativo solicitado não foi encontrado.
id:
type: string
example: '1'
'429':
description: >-
Muitas Solicitações. O usuário enviou muitas solicitações em um
determinado período de tempo.
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: >-
Limite de taxa excedido. Por favor, tente novamente
mais tarde.
id:
type: string
example: '1'
'500':
description: >-
Erro Interno do Servidor. O servidor encontrou uma situação que não
sabe como lidar.
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: Ocorreu um erro inesperado no servidor.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API Helius. Você pode obter uma gratuitamente no
[painel](https://dashboard.helius.dev/api-keys).
````