evm_getwallettokenbalancesprice
Retrieve ERC20 and native token balances with USD prices for a wallet address. Access on-chain and off-chain metadata, token logos, and filter spam or low-liquidity tokens using customizable options.
Instructions
Fetch ERC20 and native token balances for a given wallet address, including their USD prices. Each token returned includes on-chain metadata, as well as off-chain metadata, logos, spam status and more. Additional options to exclude spam tokens, low-liquidity tokens and inactive tokens.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The address from which token balances will be checked | |
| chain | No | The chain to query | eth |
| cursor | No | The cursor returned in the previous response (used for getting the next page). | |
| exclude_native | No | Exclude native balance from the result | |
| exclude_spam | No | Exclude spam tokens from the result | |
| exclude_unverified_contracts | No | Exclude unverified contracts from the result | |
| limit | No | The desired page size of the result. | |
| max_token_inactivity | No | Exclude tokens inactive for more than the given amount of days | |
| min_pair_side_liquidity_usd | No | Exclude tokens with liquidity less than the specified amount in USD. This parameter refers to the liquidity on a single side of the pair. | |
| to_block | No | The block number up to which the balances will be checked. | |
| token_addresses | No | The addresses to get balances for (optional) |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "The address from which token balances will be checked",
"type": "string"
},
"chain": {
"default": "eth",
"description": "The chain to query",
"enum": [
"eth",
"0x1",
"sepolia",
"0xaa36a7",
"polygon",
"0x89",
"bsc",
"0x38",
"bsc testnet",
"0x61",
"avalanche",
"0xa86a",
"fantom",
"0xfa",
"cronos",
"0x19",
"arbitrum",
"0xa4b1",
"chiliz",
"0x15b38",
"chiliz testnet",
"0x15b32",
"gnosis",
"0x64",
"gnosis testnet",
"0x27d8",
"base",
"0x2105",
"base sepolia",
"0x14a34",
"optimism",
"0xa",
"holesky",
"0x4268",
"polygon amoy",
"0x13882",
"linea",
"0xe708",
"moonbeam",
"0x504",
"moonriver",
"0x505",
"moonbase",
"0x507",
"linea sepolia",
"0xe705",
"flow",
"0x2eb",
"flow-testnet",
"0x221",
"ronin",
"0x7e4",
"ronin-testnet",
"0x7e5",
"lisk",
"0x46f",
"lisk-sepolia",
"0x106a",
"pulse",
"0x171"
],
"type": "string"
},
"cursor": {
"description": "The cursor returned in the previous response (used for getting the next page).",
"type": "string"
},
"exclude_native": {
"default": false,
"description": "Exclude native balance from the result",
"type": "boolean"
},
"exclude_spam": {
"default": false,
"description": "Exclude spam tokens from the result",
"type": "boolean"
},
"exclude_unverified_contracts": {
"default": false,
"description": "Exclude unverified contracts from the result",
"type": "boolean"
},
"limit": {
"description": "The desired page size of the result.",
"minimum": 0,
"type": "number"
},
"max_token_inactivity": {
"description": "Exclude tokens inactive for more than the given amount of days",
"type": "number"
},
"min_pair_side_liquidity_usd": {
"description": "Exclude tokens with liquidity less than the specified amount in USD. This parameter refers to the liquidity on a single side of the pair.",
"type": "number"
},
"to_block": {
"description": "The block number up to which the balances will be checked.",
"type": "number"
},
"token_addresses": {
"description": "The addresses to get balances for (optional)",
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"required": [
"address"
],
"type": "object"
}