APIs de balances de tokens

En los siguientes ejemplos, usaremos los métodos GetTokenBalancesSummary y GetTokenBalancesDetails del Sequence Indexer Gateway.

`GetTokenBalancesSummary`

Solicitud: POST /rpc/IndexerGateway/GetTokenBalancesSummary
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.
- filter (objeto - opcional) — filtros de consulta.
  - accountAddresses ([]string)
  - contractStatus (VERIFIED | UNVERIFIED | ALL)
  - contractWhitelist ([]string)
  - contractBlacklist ([]string)
  - omitNativeBalances (bool)
- omitMetadata (booleano - opcional - por defecto: false)

`GetTokenBalancesDetails`

Solicitud: POST /rpc/IndexerGateway/GetTokenBalancesDetails
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.
- filter (objeto - opcional) — filtros de consulta.
  - accountAddresses ([]string)
  - contractStatus (VERIFIED | UNVERIFIED | ALL)
  - contractWhitelist ([]string)
  - contractBlacklist ([]string)
  - omitNativeBalances (bool)
- omitMetadata (booleano - opcional - por defecto: false)

Obtener el resumen de balances de tokens verificados en redes específicas

Ejemplo: obtenga el resumen de todos los balances de tokens verificados para una cuenta específica en mainnet y polygon

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY" \
  https://indexer.sequence.app/rpc/IndexerGateway/GetTokenBalancesSummary \
  -d '{
    "networks": [
        "polygon",
        "mainnet"
    ],
    "filter": {
        "accountAddresses": [
            "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9"
        ]
    }
  }'

import { SequenceIndexerGateway } from '@0xsequence/indexer'

const INDEXER_TOKEN = 'AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY';
const ACCOUNT_ADDRESS = '0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9';

const indexerGateway = new SequenceIndexerGateway(
  'https://indexer.sequence.app',
  INDEXER_TOKEN
)

const res = await indexerGateway.getTokenBalancesSummary({
  networks: ["polygon", "mainnet"],
  filter: {
    accountAddresses: [ACCOUNT_ADDRESS]
  }
})

res.nativeBalances.forEach(({ chainId, results }) => {
  console.log(`chainId: ${chainId} (native balances)`);
  results.forEach(({ balance }) => {
    console.log(`\tbalance: ${balance}`);
  });
});

res.balances.forEach(({ chainId, results }) => {
  console.log(`chainId: ${chainId} (token balances)`);
  results.forEach(({ contractAddress, balance }) => {
    console.log(`\tcontractAddress: ${contractAddress}, balance: ${balance}`);
  });
});

package main

import (
	"context"
	"fmt"
	"log"
	"net/http"

	"github.com/0xsequence/go-sequence/indexer"
	"github.com/0xsequence/go-sequence/lib/prototyp"
)

const indexerToken = "AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY"

func main() {
	ctx := context.TODO()

	seqIndexerGW := indexer.NewIndexerGatewayClient(
		"https://indexer.sequence.app",
		http.DefaultClient,
	)

	authCtx, err := indexer.WithHTTPRequestHeaders(ctx, http.Header{
		"X-Access-Key": []string{indexerToken},
	})
	if err != nil {
		log.Fatal(err)
	}

	accountAddress := "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9"

	_, nativeBalances, balances, err := seqIndexerGW.GetTokenBalancesSummary(
		authCtx,
		nil, // No chainId filter
		networks,
    []string{"polygon", "mainnet"},
		&indexer.TokenBalancesFilter{
			AccountAddresses: []prototyp.Hash{
				prototyp.HashFromString(accountAddress),
			},
		},
		nil, // Default omitMetadata
		nil, // Default page
	)
	if err != nil {
		log.Fatal(err)
	}

	// Native Balances
	for _, nativeBalance := range nativeBalances {
		fmt.Printf("chainId: %d (native balances)\n", nativeBalance.ChainId)
		for _, result := range nativeBalance.Results {
			fmt.Printf("\tbalance: %s\n", result.Balance)
		}
	}

	// Token Balances
	for _, balance := range balances {
		fmt.Printf("chainId: %d (token balances)\n", balance.ChainID)
		for _, result := range balance.Results {
			fmt.Printf("\tcontractAddress: %s, balance: %s\n",
				result.ContractAddress, result.Balance)
		}
	}
}

Obtenga detalles de balances de contratos específicos en todas las redes

Ejemplo: Obtenga los detalles de balance de los contratos USDC en Arbitrum, Polygon y Mainnet

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY" \
  https://indexer.sequence.app/rpc/IndexerGateway/GetTokenBalancesDetails \
  -d '{
    "networks": [
        "arbitrum",
        "polygon",
        "mainnet"
    ],
    "filter": {
        "accountAddresses": [
            "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9"
        ],
        "contractWhitelist": [
            "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
            "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
        ]
    }
  }'

import { SequenceIndexerGateway } from '@0xsequence/indexer'

const INDEXER_TOKEN = 'AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY';
const ACCOUNT_ADDRESS = '0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9';

const indexerGateway = new SequenceIndexerGateway(
  'https://indexer.sequence.app',
  INDEXER_TOKEN
)

const res = await indexerGateway.getTokenBalancesDetails({
  networks: ['arbitrum', 'polygon', 'mainnet'],
  filter: {
    accountAddresses: [ACCOUNT_ADDRESS],
    contractWhitelist: [
      '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', // USDC on Ethereum
      '0x3c499c542cef5e3811e1192ce70d8cc03d5c3359', // USDC on Polygon
      '0xaf88d065e77c8cc2239327c5edb3a432268e5831'  // USDC on Arbitrum
    ]
  }
});

// Native Balances
res.nativeBalances.forEach(({ chainId, results }) => {
  console.log(`chainId: ${chainId} (native balances)`);
  results.forEach(({ balance }) => {
    console.log(`\tbalance: ${balance}`);
  });
});

// Token Balances
res.balances.forEach(({ chainId, results }) => {
  console.log(`chainId: ${chainId} (token balances)`);
  results.forEach(({ contractAddress, balance }) => {
    console.log(`\tcontractAddress: ${contractAddress}, balance: ${balance}`);
  });
});

package main

import (
	"context"
	"fmt"
	"log"
	"net/http"

	"github.com/0xsequence/go-sequence/indexer"
	"github.com/0xsequence/go-sequence/lib/prototyp"
)

const indexerToken = "AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY"

func main() {
	ctx := context.TODO()

	seqIndexerGW := indexer.NewIndexerGatewayClient(
		"https://indexer.sequence.app",
		http.DefaultClient,
	)

	authCtx, err := indexer.WithHTTPRequestHeaders(ctx, http.Header{
		"X-Access-Key": []string{indexerToken},
	})
	if err != nil {
		log.Fatal(err)
	}

	accountAddress := "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9"
	contractWhitelist := []prototyp.Hash{
		prototyp.HashFromString("0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"),
		prototyp.HashFromString("0x3c499c542cef5e3811e1192ce70d8cc03d5c3359"),
		prototyp.HashFromString("0xaf88d065e77c8cc2239327c5edb3a432268e5831"),
	}

	_, nativeBalances, balances, err := seqIndexerGW.GetTokenBalancesDetails(
		authCtx,
		nil, // No chainId filter
		[]string{"arbitrum", "polygon", "mainnet"},
		&indexer.TokenBalancesFilter{
			AccountAddresses: []prototyp.Hash{
				prototyp.HashFromString(accountAddress),
			},
			ContractWhitelist: contractWhitelist,
		},
		nil, // Default omitMetadata
		nil, // Default page
	)
	if err != nil {
		log.Fatal(err)
	}

	// Native Balances
	for _, nativeBalance := range nativeBalances {
		fmt.Printf("chainId: %d (native balances)\n", nativeBalance.ChainId)
		for _, result := range nativeBalance.Results {
			fmt.Printf("\tbalance: %s\n", result.Balance)
		}
	}

	// Token Balances
	for _, balance := range balances {
		fmt.Printf("chainId: %d (token balances)\n", balance.ChainID)
		for _, result := range balance.Results {
			fmt.Printf("\tcontractAddress: %s, balance: %s\n",
				result.ContractAddress, result.Balance)
		}
	}
}

Transacciones

Indexador

Gateway del Indexador

Analíticas

Metadatos

Infraestructura

Builder

Marketplace

RPC Blockchain

Obtener balances en todas las redes

APIs de balances de tokens

`GetTokenBalancesSummary`

`GetTokenBalancesDetails`

Obtener el resumen de balances de tokens verificados en redes específicas

Obtenga detalles de balances de contratos específicos en todas las redes

​APIs de balances de tokens

​GetTokenBalancesSummary

​GetTokenBalancesDetails

​Obtener el resumen de balances de tokens verificados en redes específicas

​Obtenga detalles de balances de contratos específicos en todas las redes

APIs de balances de tokens

`GetTokenBalancesSummary`

`GetTokenBalancesDetails`

Obtener el resumen de balances de tokens verificados en redes específicas

Obtenga detalles de balances de contratos específicos en todas las redes