Skip to main content

​
Descripción general

Inicialmente, la API DAS solo admitía consultas de propiedad para NFT y cNFT de Metaplex. Helius amplió la API DAS para admitir todos los tokens, incluidos los tokens SPL simples (sin metadatos) y Token-2022 (junto con sus extensiones). Puedes consultar los saldos de tokens de cualquier cuenta para todos los tokens (SPL, Token-2022, NFT y NFT comprimidos), con los precios de los tokens en USD incluidos. Un token de Solana se define mediante su cuenta de acuñación. Por ejemplo, la cuenta de acuñación de USDC es EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Cuando compras $40 de USDC, se crea una cuenta de tokens que contiene 40 tokens USDC. Una billetera puede contener cientos de cuentas de tokens para diferentes tokens. Para obtener más información sobre Token-2022, consulta la publicación del blog de Helius.

​
Cuándo usar esta extensión

Usa la extensión de tokens fungibles cuando quieras una vista unificada de los activos de una cuenta —tokens fungibles, NFT y NFT comprimidos— en una sola llamada a DAS, con metadatos y precios en USD. Es la opción adecuada para rastreadores de portafolios, billeteras y paneles de tokens. Usa los métodos estándar de tokens de RPC (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts) cuando solo necesites valores sin procesar de la cadena —el saldo de una sola cuenta, el suministro total o los mayores titulares— sin metadatos ni precios. Consulta la guía para obtener tokens SPL para conocer esos métodos.

​
Cómo funciona

La extensión de Helius para tokens fungibles se basa en la indexación de la propiedad. Los siguientes métodos ofrecen una vista unificada de los activos de una cuenta: getAsset, getAssetsByOwner y searchAssets. La extensión agrega un campo adicional llamado tokenType, que te permite consultar todos los activos que posee la cuenta, incluidos los tokens fungibles y Token-2022. Las opciones de tokenType son:
  • fungible: Devuelve todos los tokens fungibles.
  • nonFungible: Devuelve todos los NFT (comprimidos y normales).
  • regularNft: Devuelve únicamente los NFT normales.
  • compressedNft: Devuelve únicamente los NFT comprimidos.
  • all: Devuelve todos los tokens.
Solicitud de ejemplo:
La respuesta ahora incluye tokens fungibles como JitoSOL. Cada elemento contiene el saldo total de la cuenta, la dirección del programa del token, la dirección de token asociada, el suministro total en circulación y la información de precios. El elemento abreviado a continuación muestra los campos relevantes:

​
Compatibilidad con Token-2022

Helius admite tokens Token-2022 y analiza sus extensiones. La respuesta incluye el campo mint_extensions si el token usa el programa Token-2022. El elemento abreviado a continuación muestra el campo mint_extensions para BERN:

​
Compatibilidad con versiones anteriores

Para mantener la compatibilidad con versiones anteriores, el comportamiento es idéntico al de la API DAS original cuando se omite tokenType: solo se devuelven NFT y NFT comprimidos.

​
Próximos pasos

Get SPL Tokens

Saldos, suministro, titulares y cuentas de tokens.

Search Assets

Filtra por tokenType, propietario y colección.

searchAssets reference

Esquemas completos de solicitudes y respuestas.