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

# API de tokens fungibles de Solana: acceso completo a los datos de tokens

> Consulta todos los tokens de Solana con la API DAS: tokens SPL, extensiones de Token-2022, datos de precios en USD y saldos mediante getAsset, getAssetsByOwner y searchAssets.

## 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](https://explorer.solana.com/address/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](https://www.helius.dev/blog/what-is-token-2022) 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](/docs/es/das/get-tokens) 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](/docs/es/api-reference/das/getasset), [getAssetsByOwner](/docs/es/api-reference/das/getassetsbyowner) y [searchAssets](/docs/es/api-reference/das/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:

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

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:

```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"
        }
    }
    // ...
}
```

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

```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"
        }
    }
    // ...
}
```

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

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

## Próximos pasos

<CardGroup cols={3}>
  <Card title="Get SPL Tokens" icon="coins" href="/docs/es/das/get-tokens">
    Saldos, suministro, titulares y cuentas de tokens.
  </Card>

  <Card title="Search Assets" icon="magnifying-glass" href="/docs/es/das/search">
    Filtra por tokenType, propietario y colección.
  </Card>

  <Card title="searchAssets reference" icon="code" href="/docs/es/api-reference/das/searchassets">
    Esquemas completos de solicitudes y respuestas.
  </Card>
</CardGroup>
