Skip to main content

​
¿Qué es la API DAS?

La API Digital Asset Standard (DAS) es una especificación de código abierto que te proporciona una interfaz unificada para cada tipo de activo digital en Solana:
  • NFT normales (tokens no fungibles)
  • NFT comprimidos (cNFT, que usan compresión de estado)
  • Tokens fungibles (SPL Token y Token-2022, incluidas sus extensiones)
Un único conjunto de métodos abarca metadatos, propiedad, saldos, colecciones, creadores, búsquedas y pruebas de Merkle. Así puedes crear mercados de NFT, billeteras, rastreadores de portafolios, aplicaciones con acceso restringido por tokens y herramientas de análisis con la misma API. Ambas redes comparten los mismos métodos:
  • Red principal: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

​
¿Por qué usar Helius para la API DAS?

All asset types, one API

NFT, NFT comprimidos y tokens fungibles (SPL y Token-2022) mediante una única interfaz.

Complete metadata

Los datos en cadena y fuera de cadena (Arweave, IPFS) se indexan y devuelven juntos en una sola llamada.

Price data included

Información de precios en USD para tokens verificados, devuelta junto con los saldos.

Search and filtering

Consulta por propietario, colección, creador, autoridad o filtros avanzados de atributos.

​
¿Qué método debo usar?

La mayoría de las integraciones comienzan con uno de tres métodos. Usa esta tabla para elegir el punto de entrada adecuado y luego recurre a los métodos especializados que aparecen a continuación. Como regla general:
  • ¿Conoces el ID exacto del activo? Usa getAsset (o getAssetBatch para varios).
  • ¿Quieres enumerar los activos de una billetera? Usa getAssetsByOwner.
  • ¿Quieres filtrar por colección, tipo de token o atributos? Usa searchAssets.

​
Métodos principales

​
Activo individual

getAsset

Datos completos de un activo según su ID.

getAssetBatch

Hasta 1,000 activos en una sola solicitud.

​
Activos por propietario, colección o creador

getAssetsByOwner

Todos los activos que contiene una billetera, con metadatos y saldos.

getAssetsByGroup

Todos los activos de una colección (clave de grupo collection).

getAssetsByCreator

Todos los activos acuñados por un creador específico.

getAssetsByAuthority

Todos los activos controlados por una autoridad determinada.

​
Búsqueda

searchAssets

Filtrado flexible por propietario, colección, tokenType y atributos.

​
Activos comprimidos y pruebas

getAssetProof

Prueba de Merkle para un activo comprimido, necesaria para las operaciones en cadena.

getAssetProofBatch

Pruebas de Merkle para varios activos comprimidos a la vez.

getSignaturesForAsset

Historial de firmas de transacciones de un activo.

getNftEditions

Todas las ediciones impresas a partir de un NFT maestro.

​
Cuentas de tokens

getTokenAccounts

Cuentas de tokens por acuñación o propietario, con saldos.

​
Primeros pasos

Get Assets (NFTs)

Obtén NFT y coleccionables digitales: activos individuales, por propietario, colecciones, pruebas y ediciones.

Get SPL Tokens

Consulta tokens fungibles: saldos, suministro, titulares y cuentas de tokens.

Search Assets

Filtra activos por propietario, colección, tipo de token y atributos.

Pagination

Paginación basada en páginas y claves para conjuntos grandes de resultados.

​
Trabajar con tipos de activos especiales

​
Tokens fungibles

Helius amplía la API DAS para abarcar todos los tokens, incluidos los tokens SPL simples (sin metadatos) y Token-2022 (junto con sus extensiones). La compatibilidad con tokens fungibles está disponible mediante getAsset, getAssetsByOwner e searchAssets con el parámetro tokenType. Los precios de los tokens verificados se devuelven en token_info.price_info. Para consultar saldos, suministro, titulares y cuentas de tokens, consulta la guía para obtener tokens SPL y la extensión de tokens fungibles.

​
NFT comprimidos

Los NFT con compresión de estado (cNFT) usan los mismos métodos que los NFT normales para las lecturas (getAsset, getAssetsByOwner, searchAssets), además de dos métodos específicos para la compresión:
  • getAssetProof devuelve la prueba de Merkle necesaria para verificar y realizar operaciones en cadena, como transferencias y quemas.
  • getSignaturesForAsset devuelve el historial de transacciones de un activo comprimido.
Consulta la guía para obtener activos para ver ejemplos completos de NFT comprimidos.

​
Datos fuera de cadena

La mayoría de las colecciones de NFT almacenan metadatos adicionales (atributos e imágenes) fuera de cadena en Arweave o IPFS. La API DAS indexa estos datos fuera de cadena y los devuelve junto con los datos en cadena en una sola llamada.
Helius no puede detectar modificaciones de datos fuera de cadena. Estos datos solo se actualizan cuando el activo vuelve a detectarse en cadena (por ejemplo, cuando se modifica). Para solicitar una nueva indexación, contacta con el equipo de soporte de Helius.

​
Prácticas recomendadas

Pagination

Comienza en la página 1 (no en la 0). Usa límites de 100 a 1,000 y pagina los conjuntos de datos grandes.

Error handling

Comprueba si hay errores en cada respuesta y vuelve a intentarlo con espera exponencial.

Performance

Usa métodos por lotes cuando sea posible, almacena las respuestas en caché y evita encadenar llamadas cuando una sola sea suficiente.

Security

Nunca expongas tu clave de API en el código del cliente. Canaliza las solicitudes mediante un servidor y configura políticas CORS.

​
Próximos pasos

Get Assets (NFTs)

Recupera y consulta NFT y coleccionables digitales.

DAS API reference

Esquemas completos de solicitudes y respuestas para cada método de DAS.

DAS API FAQ

Preguntas frecuentes sobre activos, datos de precios y uso.