Skip to main content

​
O que é a DAS API?

A Digital Asset Standard (DAS) API é uma especificação de código aberto que oferece uma interface unificada para cada tipo de ativo digital em Solana:
  • NFTs Regulares (Tokens Não Fungíveis)
  • NFTs Comprimidos (cNFTs, usando compressão de estado)
  • Tokens Fungíveis (SPL Token e Token-2022, incluindo extensões)
Um único conjunto de métodos abrange metadados, propriedade, saldos, coleções, criadores, pesquisa e provas de Merkle — assim, você pode construir marketplaces de NFT, carteiras, rastreadores de portfólio, aplicativos com restrição por token e ferramentas analíticas contra a mesma API. Ambas as redes compartilham os mesmos métodos:
  • Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

​
Por que Helius para a DAS API?

Todos os tipos de ativos, uma API

NFTs, NFTs comprimidos e tokens fungíveis (SPL e Token-2022) através de uma única interface.

Metadados completos

Dados on-chain e off-chain (Arweave, IPFS) indexados e retornados juntos em uma única chamada.

Dados de preço incluídos

Informações de preço em USD para tokens verificados, retornadas junto com os saldos.

Pesquisa e filtragem

Consulta por proprietário, coleção, criador, autoridade ou filtros de atributos ricos.

​
Qual método devo usar?

A maioria das integrações começa com um dos três métodos. Use esta tabela para escolher o ponto de entrada certo e, em seguida, procure pelos métodos especializados abaixo. Como regra geral:
  • Conhece o ID exato do ativo? Use getAsset (ou getAssetBatch para muitos).
  • Listando as posses de uma carteira? Use getAssetsByOwner.
  • Filtrando por coleção, tipo de token ou atributos? Use searchAssets.

​
Métodos chave

​
Único ativo

getAsset

Dados completos para um ativo pelo seu ID.

getAssetBatch

Até 1.000 ativos em uma única requisição.

​
Ativos por proprietário, coleção ou criador

getAssetsByOwner

Todos os ativos mantidos por uma carteira, com metadados e saldos.

getAssetsByGroup

Todos os ativos em uma coleção (chave do grupo collection).

getAssetsByCreator

Todos os ativos cunhados por um criador específico.

getAssetsByAuthority

Todos os ativos controlados por uma determinada autoridade.

​
Pesquisa

searchAssets

Filtragem flexível por proprietário, coleção, tokenType, e atributos.

​
Ativos comprimidos e provas

getAssetProof

Prova de Merkle para um ativo comprimido, necessária para operações on-chain.

getAssetProofBatch

Provas de Merkle para vários ativos comprimidos de uma só vez.

getSignaturesForAsset

Histórico de assinaturas de transações para um ativo.

getNftEditions

Todas as edições impressas a partir de um NFT mestre.

​
Contas de tokens

getTokenAccounts

Contas de tokens por emissão ou proprietário, com saldos.

​
Comece agora

Obter Ativos (NFTs)

Buscar NFTs e colecionáveis digitais: ativo único, por proprietário, coleções, provas e edições.

Obter Tokens SPL

Consultar tokens fungíveis: saldos, fornecimento, detentores e contas de tokens.

Pesquisar Ativos

Filtrar ativos por proprietário, coleção, tipo de token e atributos.

Paginação

Paginação baseada em páginas e conjuntos de chaves para grandes conjuntos de resultados.

​
Trabalhando com tipos especiais de ativos

​
Tokens fungíveis

Helius estende a DAS API para cobrir todos os tokens, incluindo tokens SPL simples (sem metadados) e Token-2022 (mais suas extensões). O suporte a tokens fungíveis está disponível através de getAsset, getAssetsByOwner, e searchAssets usando o parâmetro tokenType, e os preços para tokens verificados são retornados sob token_info.price_info. Para saldos, fornecimento, detentores e consultas de contas de token, veja o Guia de Tokens SPL e a extensão para token fungível.

​
NFTs Comprimidos

NFTs comprimidos por estado (cNFTs) usam os mesmos métodos dos NFTs regulares para leituras (getAsset, getAssetsByOwner, searchAssets), além de dois métodos específicos de compressão:
  • getAssetProof retorna a prova de Merkle necessária para verificar e realizar operações on-chain, como transferências e destruições.
  • getSignaturesForAsset retorna o histórico de transações para um ativo comprimido.
Veja o Guia de Ativos para exemplos completos de NFT comprimido.

​
Dados off-chain

A maioria das coleções de NFT armazena metadados extras (atributos, imagens) off-chain em Arweave ou IPFS. A DAS API indexa esses dados off-chain e os retorna junto com os dados on-chain em uma única chamada.
Helius não pode detectar mutações de dados off-chain. Os dados off-chain são apenas atualizados uma vez que o ativo é visto novamente on-chain (por exemplo, quando é modificado). Para solicitar uma reindexação, entre em contato com o suporte da Helius.

​
Melhores práticas

Paginação

Comece na página 1 (não 0). Use limites de 100–1.000 e pagine para grandes conjuntos de dados.

Tratamento de erros

Verifique se há erros em cada resposta e tente novamente com retrocesso exponencial.

Desempenho

Use métodos de lote quando possível, armazene respostas em cache e evite encadear chamadas quando uma só for suficiente.

Segurança

Nunca exponha sua chave de API no código do lado do cliente. Proxie solicitações através de um servidor e defina políticas de CORS.

​
Próximas etapas

Obter Ativos (NFTs)

Recuperar e consultar NFTs e colecionáveis digitais.

Referência da DAS API

Esquemas completos de requisição e resposta para cada método DAS.

FAQ da DAS API

Perguntas comuns sobre ativos, dados de preço e uso.