Execution address balances

Retrieve the native ETH balance and ERC-20 token balances for an Ethereum address. The response includes at most 200 distinct ERC-20 tokens. To fetch all tokens beyond this limit, call /api/v1/execution/address/{address}/erc20tokens.

GET /api/v1/execution/address/{address}

Execution address balances

cURL

curl --request GET \
  --url 'https://beaconcha.in/api/v1/execution/address/{address}?apikey='

200

Example

{
  "status": "OK",
  "data": {
    "address": "0x388c818ca8b9251b393131c08a736a67ccb19297",
    "ether": "2.472194030644794345",
    "tokens": [
      {
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "balance": "122100",
        "symbol": "TOKEN1"
      }
    ]
  }
}

Authorizations

ApiKeyAuthQueryApiKeyAuthHeader

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

token · string

Optional ERC-20 contract address to filter the result to a single token. Provide a 0x-prefixed, 20-byte hex address.

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

Example:

"0xdAC17F958D2ee523a2206206994597C13D831ec7"

Response

200

application/json

Balances were retrieved successfully. The data object contains the address, native ETH balance, and a list of ERC-20 token balances.

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

Asset balances for a single execution-layer address, including native ETH and up to 200 ERC-20 token balances.

Show child attributes