> ## 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.

# Solana DAS API: Acesso Unificado a Dados de NFT e Token

> A API Solana mais abrangente para NFTs, NFTs comprimidos e tokens. Uma interface unificada para todos os ativos digitais, com metadados completos, propriedade e pesquisa.

## 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?

<CardGroup cols={2}>
  <Card title="Todos os tipos de ativos, uma API" icon="gem">
    NFTs, NFTs comprimidos e tokens fungíveis (SPL e Token-2022) através de uma única interface.
  </Card>

  <Card title="Metadados completos" icon="database">
    Dados on-chain e off-chain (Arweave, IPFS) indexados e retornados juntos em uma única chamada.
  </Card>

  <Card title="Dados de preço incluídos" icon="coins">
    Informações de preço em USD para tokens verificados, retornadas junto com os saldos.
  </Card>

  <Card title="Pesquisa e filtragem" icon="magnifying-glass">
    Consulta por proprietário, coleção, criador, autoridade ou filtros de atributos ricos.
  </Card>
</CardGroup>

## 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.

| Método                 | Use para                               | Retorna                                                                              |
| ---------------------- | -------------------------------------- | ------------------------------------------------------------------------------------ |
| **`getAsset`**         | Um único ativo que você já tem o ID    | Metadados completos, propriedade e (para tokens) preço de um ativo                   |
| **`getAssetsByOwner`** | Tudo o que uma carteira possui         | Todos os ativos para um endereço, com metadados e saldos                             |
| **`searchAssets`**     | Consultas filtradas em todos os ativos | Ativos que correspondem a proprietário, coleção, `tokenType`, e filtros de atributos |

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

<CardGroup cols={2}>
  <Card title="getAsset" icon="gem" href="/docs/pt-BR/api-reference/das/getasset">
    Dados completos para um ativo pelo seu ID.
  </Card>

  <Card title="getAssetBatch" icon="layer-group" href="/docs/pt-BR/api-reference/das/getassetbatch">
    Até 1.000 ativos em uma única requisição.
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="getAssetsByOwner" icon="wallet" href="/docs/pt-BR/api-reference/das/getassetsbyowner">
    Todos os ativos mantidos por uma carteira, com metadados e saldos.
  </Card>

  <Card title="getAssetsByGroup" icon="layer-group" href="/docs/pt-BR/api-reference/das/getassetsbygroup">
    Todos os ativos em uma coleção (chave do grupo `collection`).
  </Card>

  <Card title="getAssetsByCreator" icon="user" href="/docs/pt-BR/api-reference/das/getassetsbycreator">
    Todos os ativos cunhados por um criador específico.
  </Card>

  <Card title="getAssetsByAuthority" icon="address-card" href="/docs/pt-BR/api-reference/das/getassetsbyauthority">
    Todos os ativos controlados por uma determinada autoridade.
  </Card>
</CardGroup>

### Pesquisa

<CardGroup cols={2}>
  <Card title="searchAssets" icon="magnifying-glass" href="/docs/pt-BR/api-reference/das/searchassets">
    Filtragem flexível por proprietário, coleção, `tokenType`, e atributos.
  </Card>
</CardGroup>

### Ativos comprimidos e provas

<CardGroup cols={2}>
  <Card title="getAssetProof" icon="shield-check" href="/docs/pt-BR/api-reference/das/getassetproof">
    Prova de Merkle para um ativo comprimido, necessária para operações on-chain.
  </Card>

  <Card title="getAssetProofBatch" icon="shield-check" href="/docs/pt-BR/api-reference/das/getassetproofbatch">
    Provas de Merkle para vários ativos comprimidos de uma só vez.
  </Card>

  <Card title="getSignaturesForAsset" icon="clock-rotate-left" href="/docs/pt-BR/api-reference/das/getsignaturesforasset">
    Histórico de assinaturas de transações para um ativo.
  </Card>

  <Card title="getNftEditions" icon="image" href="/docs/pt-BR/api-reference/das/getnfteditions">
    Todas as edições impressas a partir de um NFT mestre.
  </Card>
</CardGroup>

### Contas de tokens

<CardGroup cols={2}>
  <Card title="getTokenAccounts" icon="coins" href="/docs/pt-BR/api-reference/das/gettokenaccounts">
    Contas de tokens por emissão ou proprietário, com saldos.
  </Card>
</CardGroup>

## Comece agora

<CardGroup cols={2}>
  <Card title="Obter Ativos (NFTs)" icon="image" href="/docs/pt-BR/das/get-nfts">
    Buscar NFTs e colecionáveis digitais: ativo único, por proprietário, coleções, provas e edições.
  </Card>

  <Card title="Obter Tokens SPL" icon="coins" href="/docs/pt-BR/das/get-tokens">
    Consultar tokens fungíveis: saldos, fornecimento, detentores e contas de tokens.
  </Card>

  <Card title="Pesquisar Ativos" icon="magnifying-glass" href="/docs/pt-BR/das/search">
    Filtrar ativos por proprietário, coleção, tipo de token e atributos.
  </Card>

  <Card title="Paginação" icon="list" href="/docs/pt-BR/das/pagination">
    Paginação baseada em páginas e conjuntos de chaves para grandes conjuntos de resultados.
  </Card>
</CardGroup>

## 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](/docs/pt-BR/das/get-tokens) e a [extensão para token fungível](/docs/pt-BR/das/fungible-token-extension).

### 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](/docs/pt-BR/das/get-nfts) 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.

<Note>
  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.
</Note>

## Melhores práticas

<CardGroup cols={2}>
  <Card title="Paginação" icon="list">
    Comece na página 1 (não 0). Use limites de 100–1.000 e pagine para grandes conjuntos de dados.
  </Card>

  <Card title="Tratamento de erros" icon="shield-check">
    Verifique se há erros em cada resposta e tente novamente com retrocesso exponencial.
  </Card>

  <Card title="Desempenho" icon="bolt">
    Use métodos de lote quando possível, armazene respostas em cache e evite encadear chamadas quando uma só for suficiente.
  </Card>

  <Card title="Segurança" icon="lock">
    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.
  </Card>
</CardGroup>

## Próximas etapas

<CardGroup cols={3}>
  <Card title="Obter Ativos (NFTs)" icon="image" href="/docs/pt-BR/das/get-nfts">
    Recuperar e consultar NFTs e colecionáveis digitais.
  </Card>

  <Card title="Referência da DAS API" icon="code" href="/docs/pt-BR/api-reference/das">
    Esquemas completos de requisição e resposta para cada método DAS.
  </Card>

  <Card title="FAQ da DAS API" icon="book" href="/docs/pt-BR/faqs/das-api">
    Perguntas comuns sobre ativos, dados de preço e uso.
  </Card>
</CardGroup>