alchemy_getTokenBalances

POST

/{apiKey}

Returns ERC-20 token balances for a given address.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringrequireddefaults to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

A 20-byte wallet address.

enum or string[]optional

A token specification: - The string "erc20" - "NATIVE_TOKEN" - "DEFAULT_TOKENS" (deprecated) - An array of token contract addresses.

objectoptional

Optional pagination options.

Responses

200

An object containing the queried address and an array of token balance objects.

POST/v2/{apiKey}

curl --request POST \  --url https://eth-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "alchemy_getTokenBalances",  "params": [    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",    [      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"    ],    {      "pageKey": "string",      "maxCount": 100    }  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",    "tokenBalances": [      {        "contractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",        "tokenBalance": "0x0000000000000000000000000000000000000000000000000000000000000000"      }    ]  }}

Was this page helpful?

alchemy_getTokenBalances

Path Parameters

apiKey

Request

address

tokenSpec

options

Responses

200