Tokens By Wallet | Alchemy Docs

1 import requests 2 3 url = "https://api.g.alchemy.com/data/v1/docs-demo/assets/tokens/by-address" 4 5 payload = {} 6 headers = {"Content-Type": "application/json"} 7 8 response = requests.post(url, json=payload, headers=headers) 9 10 print(response.json())

1 { 2 "data": [ 3 { 4 "network": "foo", 5 "address": "foo", 6 "tokenAddress": "foo", 7 "tokenBalance": "foo", 8 "tokenMetadata": { 9 "id": 1, 10 "jsonrpc": "2.0", 11 "method": "alchemy_getTokenMetadata", 12 "params": [ 13 "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" 14 ] 15 }, 16 "tokenPrices": { 17 "network": "foo", 18 "address": "foo", 19 "prices": [ 20 { 21 "currency": "foo", 22 "value": "foo", 23 "lastUpdatedAt": "foo" 24 } 25 ], 26 "error": "foo" 27 } 28 } 29 ] 30 }

Fetches fungible tokens (native and ERC-20) 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.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.

addresseslist of objectsRequired

Array of address and networks pairs (limit 2 pairs, max 5 networks each). Networks should match network enums.

withMetadatabooleanOptionalDefaults to true

Boolean - if set to true, returns metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

withPricesbooleanOptionalDefaults to true

Boolean - if set to true, returns token prices. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

includeNativeTokensbooleanOptionalDefaults to true

Whether to include each chain’s native token in the response (e.g. ETH on Ethereum). The native token will have a null contract address.

Response

Successful response!

datalist of objects

List of tokens by address, with prices and metadata.

Path parameters

Request

Response

Errors