Documentation / API reference / EVM
Get EVM ERC20 Account
Last reviewed 2026-09-18
Returns ERC-20 account balances with token metadata, transfer counts and first and last activity timestamps.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | query | string | ||
token_name | query | string | ||
token_symbol | query | string | ||
token_address | query | string | ||
balance_min | query | string | Minimum balance (inclusive) | |
balance_max | query | string | Maximum balance (inclusive) | |
page | query | integer (int32) | ||
limit | query | integer (int32) | ||
order | query | string | One of last_active_block_number_asc, last_active_block_number_desc, last_active_timestamp_asc, last_active_timestamp_desc, first_active_block_number_asc, first_active_block_number_desc, first_active_timestamp_asc, first_active_timestamp_desc, balance_asc, balance_desc. |
Responses
200 — Accounts retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].address | string | Yes |
data[].balance | string | Yes |
data[].first_active_block_number | integer (int32) | Yes |
data[].first_active_timestamp | string (date-time) | Yes |
data[].last_active_block_number | integer (int32) | Yes |
data[].last_active_timestamp | string (date-time) | Yes |
data[].token_address | string | Yes |
data[].token_decimals | integer (int32) | Yes |
data[].token_name | string | Yes |
data[].token_symbol | string | Yes |
data[].total_transfers | integer (int32) | Yes |
pagination | object | Yes |
pagination.current_page | integer (int32) | Yes |
pagination.next_page | integer (int32), nullable | |
pagination.per_page | integer (int32) | Yes |
pagination.prev_page | integer (int32), nullable | |
pagination.total_items | integer (int32) | Yes |
pagination.total_pages | integer (int32) | Yes |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Accounts not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.