> ## 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 Fungible Token API: Acesso Completo aos Dados de Tokens

> "Consulte todos os tokens Solana com o DAS API: tokens SPL, extensões Token-2022, dados de preço em USD e saldos através de getAsset, getAssetsByOwner e searchAssets."

## Visão Geral

Inicialmente, o DAS API apenas suportava consultas de propriedade contra Metaplex NFTs e cNFTs. Helius estendeu o DAS API para suportar **todos os tokens**, incluindo tokens SPL simples (sem metadados) e Token-2022 (mais suas extensões).

Você pode consultar os saldos de tokens de **qualquer** conta em **todos** os tokens (SPL, Token-2022, NFTs e NFTs comprimidos), com preços de tokens em USD incluídos. Um token Solana é definido por sua conta de mint. Por exemplo, a conta de mint para USDC é [EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v](https://explorer.solana.com/address/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). Quando você compra \$40 de USDC, uma conta de token é criada que contém 40 tokens USDC. Uma carteira pode conter centenas de contas de token para diferentes tokens.

Para saber mais sobre Token-2022, veja o [post no blog](https://www.helius.dev/blog/what-is-token-2022) da Helius.

## Quando usar isto

Use a extensão de token fungível quando quiser uma **visão unificada** dos ativos de uma conta — tokens fungíveis, NFTs e NFTs comprimidos — em uma chamada DAS, com metadados e preços em USD. É a escolha certa para rastreadores de portfólio, carteiras e dashboards de tokens.

Utilize os métodos padrão de token RPC (`getTokenAccountBalance`, `getTokenAccountsByOwner`, `getTokenSupply`, `getTokenLargestAccounts`) quando você só precisar de valores brutos on-chain — saldo de uma única conta, fornecimento total ou maiores detentores — sem metadados ou preços. Veja o [Guia de Obtenção de Tokens SPL](/docs/pt-BR/das/get-tokens) para isso.

## Como funciona

A extensão de tokens fungíveis da Helius gira em torno da indexação de propriedade. Os seguintes métodos fornecem uma visão unificada dos ativos de uma conta: [getAsset](/docs/pt-BR/api-reference/das/getasset), [getAssetsByOwner](/docs/pt-BR/api-reference/das/getassetsbyowner) e [searchAssets](/docs/pt-BR/api-reference/das/searchassets).

A extensão adiciona um campo extra chamado `tokenType`, que permite consultas contra todos os ativos que a conta possui, incluindo tokens fungíveis e Token-2022. As opções para `tokenType` são:

* `fungible`: Retorna todos os tokens fungíveis.
* `nonFungible`: Retorna todos os NFTs (NFTs comprimidos e regulares).
* `regularNft`: Retorna apenas os NFTs regulares.
* `compressedNft`: Retorna apenas os NFTs comprimidos.
* `all`: Retorna todos os tokens.

Exemplo de solicitação:

```json theme={"system"}
{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze",
        "tokenType": "all"
    }
}
```

A resposta agora inclui tokens fungíveis como JitoSOL. Cada item contém o saldo total da conta, o endereço do programa do token, o endereço associado ao token, o fornecimento total em circulação e as informações de preço. O item reduzido abaixo mostra os campos relevantes:

```jsonc theme={"system"}
{
    "id": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
    "content": {
        "$schema": "",
        "json_uri": "",
        "metadata": {
            "description": "MEV-Powered Liquid Staking Derivative",
            "name": "Jito Staked SOL",
            "symbol": "JitoSOL",
            "token_standard": "Fungible"
        }
        // ...
    },
    "token_info": {
        "symbol": "JitoSOL",
        "balance": 35688813508,
        "supply": 5949594702758293,
        "decimals": 9,
        "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "associated_token_address": "H7iLu4DPFpzEx1AGN8BCN7Qg966YFndt781p6ukhgki9",
        "price_info": {
            "price_per_token": 56.47943,
            "total_price": 2015.6838854339217,
            "currency": "USDC"
        }
    }
    // ...
}
```

## Suporte ao Token-2022

Helius suporta tokens Token-2022 e analisa suas extensões. A resposta inclui o campo `mint_extensions` se o token utilizar o programa Token-2022. O item reduzido abaixo mostra o campo `mint_extensions` para BERN:

```jsonc theme={"system"}
{
    "mint_extensions": {
        "transfer_fee_config": {
            "withheld_amount": 0,
            "newer_transfer_fee": {
                "epoch": 457,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 690
            },
            "older_transfer_fee": {
                "epoch": 455,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 0
            },
            "withdraw_withheld_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD",
            "transfer_fee_config_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD"
        }
    }
    // ...
}
```

## Compatibilidade retroativa

Para compatibilidade retroativa, o comportamento é idêntico ao original DAS quando `tokenType` é omitido: apenas NFTs e NFTs comprimidos são retornados.

```json theme={"system"}
{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze"
    }
}
```

## Próximos passos

<CardGroup cols={3}>
  <Card title="Obter Tokens SPL" icon="coins" href="/docs/pt-BR/das/get-tokens">
    Saldos, fornecimento, detentores, e contas de token.
  </Card>

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

  <Card title="Referência searchAssets" icon="code" href="/docs/pt-BR/api-reference/das/searchassets">
    Esquemas completos de pedido e resposta.
  </Card>
</CardGroup>