Skip to content
Alchemy Logo

Tokens By Wallet

POST
https://api.g.alchemy.com/data/v1/{apiKey}/assets/tokens/by-address

Fetches fungible tokens (native, ERC-20 and SPL) for multiple wallet addresses and networks. Returns a list of tokens with balances, prices, and metadata for each wallet/network combination. This endpoint is supported on Ethereum, Solana, and 30+ EVM chains. See the full list of supported networks here.

This endpoint fans out across every requested network and merges the results. If one or more networks fail (upstream error or per-network timeout: 5s on paginated requests, 10s on fetch-all), the response is still HTTP 200 with a top-level error.partialErrors array listing the failed networks. See Handling partial failures for the recommended client pattern.

The top-level error object is distinct from the per-token data.tokens[].error field. The former reports networks that failed entirely; the latter reports a per-token metadata or pricing failure within an otherwise successful network response.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request Body

Responses

200

Successful response!

400

Bad Request: Invalid input (e.g., malformed JSON).

429

Too Many Requests: Rate limit exceeded.

Was this page helpful?