Tokens API

Fetches list of ERC20, ERC721 and ERC1155 tokens and metadata in any wallet.

Sequence Indexer GetTokenBalances Method:

• Request: POST /rpc/Indexer/GetTokenBalances
• Content-Type: application/json
• Body (in JSON):
  • accountAddress (string) -- the wallet account address
  • includeMetadata (boolean - optional - default: false) -- toggle token metadata to be included in the response

PRO TIP: fetching ERC721/1155 token IDs

In order to fetch ERC721/1155 token balances, you must pass the "contractAddress" to the GetTokenBalances method. See section below for more information.

Example: GetTokenBalances of a wallet account address on Polygon

curl

curl -X POST -H "Content-Type: application/json" https://polygon-indexer.sequence.app/rpc/Indexer/GetTokenBalances -d '{ "accountAddress": "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9", "includeMetadata": true }'

Javascript / Typescript

// Works in both a Webapp (browser) or Node.js:
import { SequenceIndexerClient } from '@0xsequence/indexer'

const indexer = new SequenceIndexerClient('https://polygon-indexer.sequence.app')

// try any account address you'd like :)
const accountAddress = '0xabc...'

// query Sequence Indexer for all token balances of the account on Polygon
const tokenBalances = await indexer.getTokenBalances({
    accountAddress: accountAddress,
    includeMetadata: true
})
console.log('tokens in your account:', tokenBalances)

Go

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

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

func GetTokenBalances(accountAddress string) {
    seqIndexer := indexer.NewIndexerClient("https://polygon-indexer.sequence.app", http.DefaultClient)

    includeMetadata := true

    tokenBalances, _, err := seqIndexer.GetTokenBalances(context.Background(), &accountAddress, nil, &includeMetadata, nil)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("tokenBalances:", tokenBalances)
}

Other

Please contact our team for assistance with integrations to another target.

Fetch token IDs, balances and metadata of ERC721 and ERC1155 collections.

Sequence Indexer GetTokenBalances Method:

• Request: POST /rpc/Indexer/GetTokenBalances
• Content-Type: application/json
• Body (in JSON):
  • accountAddress (string) -- the wallet account address
  • contractAddress (string) -- the contract address of the ERC721 / ERC1155 collection
  • includeMetadata (boolean - optional - default: false) -- toggle token metadata to be included in the response

Example: GetTokenBalances of a contract + account address on Polygon

curl

curl -X POST -H "Content-Type: application/json" https://polygon-indexer.sequence.app/rpc/Indexer/GetTokenBalances -d '{ "contractAddress": "0x631998e91476DA5B870D741192fc5Cbc55F5a52E", "accountAddress": "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9", "includeMetadata": true }'

Javascript / Typescript

// Works in both a Webapp (browser) or Node.js:
import { SequenceIndexerClient } from '@0xsequence/indexer'

const indexer = new SequenceIndexerClient('https://polygon-indexer.sequence.app')

// try any contract and account address you'd like :)
const contractAddress = '0x631998e91476DA5B870D741192fc5Cbc55F5a52E'
const accountAddress = '0xabc...'

// query Sequence Indexer for all nft balances of the account on Polygon
const nftBalances = await indexer.getTokenBalances({
    contractAddress: contractAddress,
    accountAddress: accountAddress,
    includeMetadata: true
})
console.log('collection of items:', nftBalances)

Go

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

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

func GetTokenBalances(contractAddress, accountAddress string) {
    seqIndexer := indexer.NewIndexerClient("https://polygon-indexer.sequence.app", http.DefaultClient)

    includeMetadata := true

    nftBalances, _, err := seqIndexer.GetTokenBalances(context.Background(), &accountAddress, &contractAddress, &includeMetadata, nil)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("nftBalances:", nftBalances)
}

Other

Please contact our team for assistance with integrations to another target.