alchemy_getTokenBalances

post

https://{network}.g.alchemy.com/v2/{apiKey}

Returns ERC20 token balances for all tokens the given address has ever transacted in with. Optionally accepts a list of contracts.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

apiKey

string

required

Defaults to docs-demo

Body Params

integer

Defaults to 1

jsonrpc

string

Defaults to 2.0

method

string

Defaults to alchemy_getTokenBalances

params

array

length between 2 and 3

String, 20 Bytes - The address to check token balances for.
One of the following token specifications, defaults to erc20
1. The String erc20 - denotes the set of erc20 tokens that the address has ever held.
2. Array - A list of contract addresses. Suggested limit: 100 addresses [omitted below]
3. The String DEFAULT_TOKENS - denotes a query for the top 100 tokens by 24 hour volume - only available on Mainnet for Ethereum, Polygon, and Arbitrum. [deprecated, please use erc20 instead]
Options (optional) - An object that contains the following settings [omitted below]:
1. pageKey: Applies only to the erc20 request type. A string address used for pagination. If more results are available, a pageKey will be returned in the response.
2. maxCount: Applies only to the erc20 request type. Specifies the maximum count of token balances to return per call. This value defaults to 100 and is currently capped at 100.

params

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json