Execution address balances

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

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

GET

api

execution

address

{address}

Execution address balances

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

{
  "status": "OK",
  "data": {
    "address": "0x388c818ca8b9251b393131c08a736a67ccb19297",
    "ether": "2.472194030644794345",
    "tokens": [
      {
        "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).

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.

Example:

"0xdAC17F958D2ee523a2206206994597C13D831ec7"

Response

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

data.address

string

Ethereum account address (0x-prefixed, 20-byte hex; 40 hex characters after 0x).

Example:

"0x388c818ca8b9251b393131c08a736a67ccb19297"

data.ether

string

Native ETH balance as a decimal string in ETH units with up to 18 decimal places (non-negative, no scientific notation).

Example:

"2.472194030644794345"

data.tokens

object[]

List of ERC-20 token balances associated with the address. The list is limited to the first 200 tokens; use the dedicated tokens endpoint for larger result sets.

Show child attributes

data.tokens.address

string

ERC-20 token contract address (0x-prefixed, 20-byte hex).

Example:

"0xdac17f958d2ee523a2206206994597c13d831ec7"

data.tokens.balance

string

Token balance as a decimal string in token units; non-negative, no scientific notation. Precision follows the token's decimals.

Example:

"122100"

data.tokens.symbol

string

Token symbol as defined by the ERC-20 contract.

Example:

"TOKEN1"

Execution block overview

ERC-20 token balances for an address

Introduction

API Docs

Execution address balances

Authorizations

Path Parameters

Query Parameters

Response