Get token balances
Get token balances and transfer history for an earn account.
Returns on-chain token balances for all tokens the earn account has interacted with, along with the complete transfer history for each token. Balances are keyed by token symbol for easy access.
Use this endpoint to display account balances, track token movements, or build transaction history interfaces.
Query Parameters
arbitrum, base, ethereum, tempo The address of the owner of the earn account.
Response
Successful Response
Response containing earn account balances and transfer history.
The derived earn account address.
"0xA4Dc919c61fDAA100AC9aB8Fae4A2d725165C181"
Token balances keyed by token symbol.
{
"USDC": {
"balance": "70710737",
"balance_formatted": "70.710737",
"token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"token_decimals": 6,
"token_symbol": "USDC",
"transfers": [
{
"amount": "70710737",
"amount_formatted": "70.710737",
"block_number": 43830869,
"block_timestamp": "2026-03-25T15:04:45Z",
"direction": "in",
"from_address": "0x111111125421cA6dc452d289314280a0f8842A65",
"to_address": "0xA4Dc919c61fDAA100AC9aB8Fae4A2d725165C181",
"transaction_hash": "0x949969bf49c100beca5d05bebbc99a57608a6d1f7472c621f3b00a5987bb417a"
}
],
"usd_value": "70.77"
},
"WETH": {
"balance": "876484654169830",
"balance_formatted": "0.000876",
"token_address": "0x4200000000000000000000000000000000000006",
"token_decimals": 18,
"token_symbol": "WETH",
"transfers": [
{
"amount": "876484654169830",
"amount_formatted": "0.000876",
"block_number": 43482380,
"block_timestamp": "2026-03-17T13:28:27Z",
"direction": "in",
"from_address": "0xd4a0e0b9149bcee3c920d2e00b5de09138fd8bb7",
"to_address": "0xA4Dc919c61fDAA100AC9aB8Fae4A2d725165C181",
"transaction_hash": "0x4165f6f2185375050f39413833e7a77f33c9c4afd429acec0d867315d96b2ea4"
}
],
"usd_value": "1.80"
}
}Total USD value of all balances (sum of available values).
"72.57"