Skip to main content
GET
/
api
/
v1
/
execution
/
address
/
{address}
/
erc20tokens
ERC-20 token balances for an address
curl --request GET \
  --url 'https://beaconcha.in/api/v1/execution/address/{address}/erc20tokens?apikey='
{
  "status": "OK",
  "data": [
    {
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "balance": "122100",
      "symbol": "TOKEN1"
    }
  ]
}

Authorizations

​
apikey
string
query
required

Path Parameters

​
address
string
required

Ethereum account address to query. Provide a 0x-prefixed, 20-byte hex string (40 hexadecimal characters after 0x).

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xdAC17F958D2ee523a2206206994597C13D831ec7"

Query Parameters

​
offset
integer
default:0

Number of items to skip from the start of the result set. Use 0 for the first page.

Required range: x >= 0
Example:

0

​
limit
integer

Maximum number of tokens to return per page. Allowed range is 1 to 200.

Required range: 1 <= x <= 200
Example:

50

Response

Tokens were retrieved successfully. The data array contains one entry per ERC-20 token for which a balance is available for the address.

Standard success envelope used by all API endpoints.

​
status
enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:
OK
​
data
object[]

Response payload specific to the endpoint.