​
Balances de Tokens

En los siguientes ejemplos, usaremos el método GetTokenBalances de Sequence Indexer Gateway:

​
GetTokenBalances

  • Solicitud: POST /rpc/IndexerGateway/GetTokenBalances
  • Content-Type: application/json
  • Cuerpo (en JSON):
    • chainIds ([]int - opcional) — devuelve resultados solo para las cadenas que coincidan con el ID dado.
    • networks ([]string - opcional) — devuelve resultados solo para las cadenas que coincidan con los nombres dados.
    • accountAddress (string) — la dirección de cuenta del wallet
    • contractAddress: (string — opcional) — la dirección del contrato del token
    • tokenID: (string — opcional) — el ID del token
    • includeMetadata (booleano - opcional - por defecto: false) — alterna si los metadatos del token se incluyen en la respuesta
    • includeCollectionTokens (booleano - opcional - por defecto: true) — alterna para representar tokens ERC721 / ERC1155 como un solo ítem resumen en la respuesta
    • metadataOptions (objeto - opcional) — opciones adicionales para metadatos
      • verifiedOnly (booleano - opcional) — devuelve solo contratos ‘verificados’ para ayudar a reducir spam
      • unverifiedOnly (booleano - opcional) — devuelve solo contratos que sean ‘unverified’
      • includeContracts ([]string - opcional) — lista de direcciones de contrato específicas que siempre se incluirán, incluso si verifiedOnly está activado.

Estos ejemplos están basados en el ejemplo de Obtener Todos los Tokens para Indexer.

​
Obtenga balances de tokens y metadatos de una cuenta en múltiples redes de Ethereum

Ejemplo: Obtener balances de tokens, junto con metadatos, para la cuenta 0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9 en todas las cadenas.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY" \
  https://indexer.sequence.app/rpc/IndexerGateway/GetTokenBalances \
  -d '{
    "accountAddress": "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9", 
    "includeMetadata": true,
    "metadataOptions": {
      "verifiedOnly": true
    }
  }'

CONSEJO PRO: obtener IDs de tokens ERC721/1155

Notará que, por defecto, GetTokenBalances devolverá como máximo una instancia de token por cada contrato. Para obtener balances de tokens ERC721/1155, debe pasar el contractAddress al método GetTokenBalances. Esto devolverá todos los tokens que posee accountAddress del contractAddress especificado. Consulte la sección de abajo para más información.

​
Obtenga los IDs de token, balances y metadatos de colecciones ERC721 y ERC1155.

Ejemplo: obtenga balances de tokens para una cuenta y contrato de token específicos en la red Polygon

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY" \
  https://indexer.sequence.app/rpc/IndexerGateway/GetTokenBalances \
  -d '{
    "chainIds": [137],
    "accountAddress": "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9",
    "contractAddress": "0x631998e91476DA5B870D741192fc5Cbc55F5a52E",
    "includeMetadata": true,
    "metadataOptions": {
      "verifiedOnly": true
    }
  }'