任意のウォレットやコントラクトアドレスにおけるネイティブトークン、ERC20、ERC721、ERC1155トークンの一覧と残高、メタデータを取得します。

Sequence Indexer GetTokenBalances Method:
  • Request: POST /rpc/Indexer/GetTokenBalances
  • Content-Type: application/json
  • ボディ(JSON形式):
    • accountAddress (string) — the wallet account address
    • includeMetadata (boolean - optional - default: false) — toggle token metadata to be included in the response
    • metadataOptions (object - optional) — additional options for metadata
      • verifiedOnly (boolean - optional) — return only contracts which are ‘verified’ to help reduce spam
      • includeContracts ([]string - optional) — list of specific contract addresses to always be included, even if verifiedOnly is enabled.
    • includeCollectionTokens (boolean - optional - default: true) — toggle to represent ERC721 / ERC1155 tokens as a single summary item in the response
curl -X POST https://polygon-indexer.sequence.app/rpc/Indexer/GetTokenBalances \
 -H "Content-Type: application/json" \
 -H "X-Access-Key: AQAAAAAAAF_JvPALhBthL7VGn6jV0YDqaFY" \
 -d '{ "accountAddress": "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9", "includeMetadata": true }'
PRO TIP: fetching ERC721/1155 token IDsデフォルトでは、GetTokenBalancesは各コントラクトごとに最大1つのトークンインスタンスのみ返します。 ERC721/1155トークン残高を取得するには、contractAddressGetTokenBalancesメソッドに渡す必要があります。 これにより、指定したcontractAddressからaccountAddressが所有するすべてのトークンが返されます。 詳細は下記のセクションをご覧ください。

ERC721およびERC1155コレクションのトークンID、残高、メタデータを取得します。

Sequence Indexer GetTokenBalances Method:
  • Request: POST /rpc/Indexer/GetTokenBalances
  • Content-Type: application/json
  • ボディ(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
    • metadataOptions (object - optional) — additional options for metadata
      • verifiedOnly (boolean - optional) — return only contracts which are ‘verified’ to help reduce spam
      • includeContracts ([]string - optional) — list of specific contract addresses to always be included, even if verifiedOnly is enabled.

Example: GetTokenBalances of a contract + account address on Polygon using an PROJECT_ACCESS_KEY
curl -X POST https://polygon-indexer.sequence.app/rpc/Indexer/GetTokenBalances \
 -H "Content-Type: application/json" \
 -H "X-Access-Key: PROJECT_ACCESS_KEY" \
 -d '{ "contractAddress": "0x631998e91476DA5B870D741192fc5Cbc55F5a52E", "accountAddress": "0x8e3E38fe7367dd3b52D1e281E4e8400447C8d8B9", "includeMetadata": true }'