> ## 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
> Recupera información detallada de un NFT de Solana, un NFT comprimido o un token, incluidos los metadatos, la propiedad, los datos de precios y los atributos en cadena
## Almacenamiento en caché de datos de precios
Los datos de precios que devuelve getAsset se almacenan en caché y podrían no estar actualizados. La información de precios tiene una caché de 600 segundos, lo que significa que los datos pueden tener hasta 600 segundos de antigüedad.
Los datos de precios están disponibles para los 10 mil tokens principales por volumen de 24 horas y se encuentran en la sección `token_info.price_info` de la respuesta. Para las aplicaciones que requieren precios en tiempo real, considera implementar una validación adicional.
## Agentes de MPL Core y grupos MIP-11
Cuando están presentes, la respuesta puede incluir valores `is_agent`, `agent_token`, `asset_signer` e `interface`, como `MplCoreGroup`, y un objeto `plugins.groups` para la pertenencia a MIP-11. `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority` e `searchAssets` devuelven los mismos campos opcionales. Consulta la [guía de búsqueda de activos](/docs/es/das/search) para conocer los filtros de `searchAssets`.
## Parámetros de la solicitud
El identificador único del NFT o activo digital de Solana que quieres recuperar. Normalmente, es la dirección de acuñación del NFT o token.
Opciones de visualización y formato para la respuesta de datos del activo.
Muestra información de agrupación para las colecciones no verificadas en lugar de omitirlas.
Muestra los metadatos de la colección.
Muestra los tokens fungibles que posee el propietario.
## OpenAPI
````yaml es/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: API del estándar de activos digitales de Solana (DAS)
version: 1.0.0
description: >
La API del estándar de activos digitales de Solana (DAS) proporciona acceso
completo y estandarizado a los NFT y activos digitales de la blockchain de
Solana.
Este potente conjunto de API permite a los desarrolladores obtener
información detallada sobre cualquier activo digital en Solana,
incluidos los NFT tradicionales y comprimidos, con un formato de datos
uniforme sin importar el estándar del token.
Ten en cuenta que cada respuesta exitosa de DAS incluye un campo
`last_indexed_slot` que indica el slot más reciente para el cual se
garantiza que el índice de DAS está
completo. Se han indexado todos los datos en cadena **hasta este slot
inclusive**. Es posible que también se hayan indexado datos posteriores a
este slot,
aunque no se garantiza.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Punto de conexión RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Punto de conexión RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAsset
description: >
Obtén datos completos de cualquier NFT o activo digital de Solana
mediante su identificador único.
Este punto de conexión proporciona todos los metadatos en cadena y fuera
de la cadena, los detalles de propiedad, la información de regalías,
los datos de la colección y el estado de compresión de cualquier activo
digital de Solana. El método getAsset admite todos los estándares de
tokens,
incluidos los NFT comprimidos (cNFT), los NFT programables (pNFT) y los
tokens SPL tradicionales.
Usa este punto de conexión para:
- Obtener todos los metadatos de los anuncios en mercados de NFT
- Obtener información sobre la propiedad de activos para integraciones
con billeteras
- Acceder a datos de regalías y creadores para aplicar regalías
- Comprobar el estado de compresión para identificar NFT comprimidos
rentables
- Consultar la agrupación por colección para analizar colecciones de NFT
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
description: El nombre del método RPC que se invocará.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
El identificador único del NFT o activo digital de
Solana que se obtendrá. Normalmente, es la dirección de
acuñación del NFT o token.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: >-
Opciones de visualización y formato para la respuesta de
datos del activo.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Muestra información de agrupación de colecciones no
verificadas en lugar de omitirlas.
showCollectionMetadata:
type: boolean
default: false
description: Muestra los metadatos de la colección.
showFungible:
type: boolean
description: >-
Muestra los tokens fungibles que posee el
propietario.
default: false
responses:
'200':
description: Respuesta exitosa
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
id:
type: string
description: El ID utilizado para identificar la solicitud.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Se garantiza que se han indexado todos los datos hasta
este slot inclusive.
interface:
type: string
description: >-
El tipo de interfaz del activo digital de Solana, que
indica su estándar de token y su implementación.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Indica si este activo tiene una identidad de agente.
Solo es verdadero para activos de MPL Core que usan el
adaptador de plugin externo AgentIdentity. El valor
predeterminado es falso y se omite de la respuesta
cuando es falso.
agent_token:
type: string
description: >-
Dirección de acuñación codificada en Base58 del token
del agente del programa Agent Registry. Se omite
cuando el activo no tiene una entrada correspondiente
en el registro.
asset_signer:
type: string
description: >-
PDA codificada en Base58 que se usa para firmar en
nombre del activo; se deriva de forma determinista del
ID del activo para los activos de MPL Core. Se omite
cuando no corresponde.
id:
type: string
description: El identificador único del activo.
content:
type: object
description: >-
Información de contenido del activo digital de Solana,
incluidos los metadatos, archivos y enlaces.
properties:
$schema:
type: string
description: La URL del esquema de los metadatos del activo.
json_uri:
type: string
description: >-
URI que apunta a los metadatos JSON del NFT de
Solana, normalmente alojados en Arweave u otro
almacenamiento descentralizado.
files:
type: array
description: Arreglo de archivos asociados con el activo.
items:
type: object
metadata:
type: object
description: >-
Información completa de los metadatos del activo
digital de Solana, incluidos el nombre, símbolo,
atributos y estándar del token.
properties:
name:
type: string
description: El nombre del activo.
symbol:
type: string
description: El símbolo del activo.
attributes:
type: array
description: Arreglo de atributos de características.
items:
type: object
properties:
value:
type: string
description: El valor de la característica.
trait_type:
type: string
description: El tipo de característica.
description:
type: string
description: Descripción del activo.
token_standard:
type: string
description: Estándar de token utilizado.
links:
type: object
description: Enlaces externos relacionados con el activo.
authorities:
type: array
description: Lista de autoridades asociadas con el activo.
items:
type: object
properties:
address:
type: string
description: La dirección de la autoridad.
scopes:
type: array
description: Los ámbitos de la autoridad.
items:
type: string
compression:
type: object
description: >-
Detalles de compresión del activo digital de Solana,
que indican si es un NFT comprimido con validación de
prueba de estado.
properties:
eligible:
type: boolean
description: Indica si el activo es apto para la compresión.
compressed:
type: boolean
description: >-
Indica si el activo está comprimido actualmente
mediante la tecnología de compresión de estado de
Solana, que reduce los costos de almacenamiento.
data_hash:
type: string
description: Hash de los datos del activo.
creator_hash:
type: string
description: Hash de los datos del creador.
asset_hash:
type: string
description: Hash del activo completo.
tree:
type: string
description: Dirección del árbol de Merkle.
seq:
type: integer
description: Número de secuencia.
leaf_id:
type: integer
description: Identificador de la hoja en el árbol de Merkle.
grouping:
type: array
description: Información de agrupación del activo.
items:
type: object
properties:
group_key:
type: string
description: La clave que identifica al grupo.
group_value:
type: string
description: El valor asociado con el grupo.
royalty:
type: object
description: >-
Información de regalías del activo digital de Solana,
utilizada para calcular las comisiones del mercado y
los pagos a creadores.
properties:
royalty_model:
type: string
description: El modelo utilizado para las regalías.
target:
type:
- string
- 'null'
description: La dirección de destino de las regalías.
percent:
type: number
description: Porcentaje de regalías.
basis_points:
type: integer
description: Puntos básicos de las regalías.
primary_sale_happened:
type: boolean
description: Indica si se realizó la venta principal.
locked:
type: boolean
description: Indica si la regalía está bloqueada.
creators:
type: array
description: Lista de creadores del activo.
items:
type: object
properties:
address:
type: string
description: La dirección del creador.
share:
type: integer
description: El porcentaje de participación del creador.
verified:
type: boolean
description: Indica si el creador está verificado.
ownership:
type: object
description: >-
Detalles de propiedad del activo digital de Solana,
incluidos el propietario actual, el estado de
delegación y la información de congelación.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: Indica si el activo está congelado.
delegated:
type: boolean
description: Indica si el activo está delegado.
delegate:
type:
- string
- 'null'
description: La dirección del delegado, si está delegado.
ownership_model:
type: string
description: El modelo de propiedad.
owner:
type: string
description: La dirección del propietario.
supply:
type:
- object
- 'null'
description: Información sobre el suministro del activo.
properties:
print_max_supply:
type: integer
description: Suministro máximo que puede imprimirse.
print_current_supply:
type: integer
description: Suministro impreso actual.
edition_nonce:
type: integer
description: Nonce de la edición.
mutable:
type: boolean
description: Indica si el activo es mutable.
burnt:
type: boolean
description: Indica si el activo se quemó.
token_info:
type: object
description: Información específica del token.
properties:
supply:
type: integer
description: Suministro total de tokens.
decimals:
type: integer
description: Número de decimales.
token_program:
type: string
description: ID del programa del token.
mint_authority:
type: string
description: Dirección de la autoridad de acuñación.
freeze_authority:
type: string
description: Dirección de la autoridad de congelación.
plugins:
type: object
description: >-
Carga útil de plugins de MPL Core. Puede incluir un
plugin `groups` (MIP-11) en activos y colecciones.
additionalProperties: true
properties:
groups:
type: object
description: >-
Plugin Groups de MIP-11 con metadatos de
pertenencia.
properties:
authority:
type: object
description: >-
Autoridad del plugin (por ejemplo,
UpdateAuthority).
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: >-
Pertenencias a grupos de este activo o
colección.
items:
type: object
properties:
group_address:
type: string
description: >-
Dirección Base58 de la cuenta de grupo
de MPL Core.
member_number:
type: integer
description: Número del miembro dentro del 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: >-
Solicitud incorrecta. El servidor no pudo comprender la solicitud
debido a una sintaxis no vá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 solicitud no válidos.
id:
type: string
example: '1'
'401':
description: >-
No autorizado. El cliente debe autenticarse para obtener la
respuesta 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: >-
La autenticación falló. Falta la clave de API o no es
válida.
id:
type: string
example: '1'
'403':
description: Prohibido. El cliente no tiene derechos de acceso al contenido.
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: No tienes permiso para acceder a este recurso.
id:
type: string
example: '1'
'404':
description: No encontrado. El servidor no puede encontrar el 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: No se encontró el activo solicitado.
id:
type: string
example: '1'
'429':
description: >-
Demasiadas solicitudes. El usuario envió demasiadas solicitudes
durante un período determinado.
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: >-
Se superó el límite de solicitudes. Inténtalo de nuevo
más tarde.
id:
type: string
example: '1'
'500':
description: >-
Error interno del servidor. El servidor encontró una situación que
no sabe cómo gestionar.
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: Ocurrió un error inesperado en el servidor.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````