> ## Documentation Index > Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt > Use this file to discover all available pages before exploring further. # 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`. ## OpenAPI ````yaml /api/v1/bundled.yaml get /api/v1/execution/address/{address} openapi: 3.0.4 info: title: beaconcha.in API Documentation license: name: GPL-3.0 url: https://www.gnu.org/licenses/gpl-3.0.en.html description: >- > ⚠️ No new features or endpoints will be added to V1. We recommend the [V2 API](/api/overview) for all new projects. See the [migration guide](/api/v1-to-v2-migration). ## Introduction **Advanced and reliable API for accessing comprehensive Ethereum blockchain data.** - **Free Usage Policy:** The API is free to use under a fair use policy, with rate limits of 10 requests per minute per IP. - **Caching:** All responses are cached for 1 minute. - **Higher Usage Plans:** For higher usage plans, visit: [https://beaconcha.in/pricing](https://beaconcha.in/pricing). An API key is required to use these plans. ### API Key Usage API keys can be obtained at [/user/settings](https://beaconcha.in/user/settings) and must be included in requests either as a query string parameter or in the request header. #### Example: Query String Parameter ```bash curl https://beaconcha.in/api/v1/slot/1?apikey= ``` #### Example: Request Header ```bash curl -H 'apikey: ' https://beaconcha.in/api/v1/slot/1 ``` contact: {} version: '1.1' servers: - url: https://beaconcha.in description: Ethereum mainnet - url: https://hoodi.beaconcha.in description: Hoodi Ethereum testnet security: - ApiKeyAuthQuery: [] - ApiKeyAuthHeader: [] tags: - name: Epoch description: Data related to consensus layer epochs - name: Slots description: Data related to consensus layer slots - name: Validators description: Data related to consensus layer validators - name: Rewards description: Data related to validator rewards - name: Sync Committees description: Data related to sync committees - name: Rocketpool description: Data related to the rocketpool protocol - name: ETH.Store® description: Data related to the ETH.Store® metric - name: Validator deposits description: Data related to execution layer validator deposits - name: Blocks description: Data related to execution layer blocks - name: Gas description: Data related to gas prices - name: Address description: Data related to ethereum addresses - name: Network description: Network data - name: Misc description: Miscellaneous data - name: User description: User data - name: Machine Metrics description: Submit machine, beacon-node, and validator-client monitoring metrics paths: /api/v1/execution/address/{address}: get: tags: - Addresses summary: Execution address balances description: >- 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`. operationId: getExecutionAddressBalances parameters: - name: address in: path description: >- Ethereum account address to query. Provide a 0x-prefixed, 20-byte hex string (40 hexadecimal characters after 0x). required: true style: simple explode: false schema: $ref: '#/components/schemas/primitives.EthAddress' - name: token in: query description: >- Optional ERC-20 contract address to filter the result to a single token. Provide a 0x-prefixed, 20-byte hex address. required: false style: form explode: true schema: $ref: '#/components/schemas/primitives.EthAddress' responses: '200': description: >- Balances were retrieved successfully. The `data` object contains the address, native ETH balance, and a list of ERC-20 token balances. content: application/json: schema: allOf: - $ref: '#/components/schemas/types.ApiResponse' - type: object properties: data: $ref: '#/components/schemas/types.ApiEth1AddressResponse' '400': description: >- The request is invalid (for example, a malformed address or token filter). content: application/json: schema: $ref: '#/components/schemas/types.ApiErrorResponse' examples: invalidAddress: summary: Invalid address parameter value: status: 'ERROR: invalid address parameter' data: null invalidToken: summary: Invalid token filter parameter value: status: 'ERROR: invalid token parameter' data: null '500': description: An unexpected server error occurred while processing your request. content: application/json: schema: $ref: '#/components/schemas/types.ApiErrorResponse' examples: serverError: summary: Internal error value: status: 'ERROR: internal server error' data: null components: schemas: primitives.EthAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0xdAC17F958D2ee523a2206206994597C13D831ec7' types.ApiResponse: type: object description: Standard success envelope used by all API endpoints. properties: status: type: string description: >- HTTP-independent status of the API operation. For successful responses this is always "OK". enum: - OK data: description: Response payload specific to the endpoint. nullable: true x-omitempty: true types.ApiEth1AddressResponse: type: object description: >- Asset balances for a single execution-layer address, including native ETH and up to 200 ERC-20 token balances. properties: address: type: string description: >- Ethereum account address (0x-prefixed, 20-byte hex; 40 hex characters after 0x). example: '0x388c818ca8b9251b393131c08a736a67ccb19297' ether: type: string description: >- Native ETH balance as a decimal string in ETH units with up to 18 decimal places (non-negative, no scientific notation). example: '2.472194030644794345' tokens: type: array description: >- 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. items: $ref: '#/components/schemas/types.ApiEth1AddressERC20TokenResponse' types.ApiErrorResponse: type: object description: Standard error envelope returned when a request fails. properties: status: type: string description: >- Human-readable error indicator and message. The value begins with "ERROR:" followed by details. example: 'ERROR: ' data: type: string description: Optional additional context for the error. Null in most cases. nullable: true default: null types.ApiEth1AddressERC20TokenResponse: type: object description: ERC-20 token balance for the specified address. properties: address: type: string description: ERC-20 token contract address (0x-prefixed, 20-byte hex). example: '0xdac17f958d2ee523a2206206994597c13d831ec7' balance: type: string description: >- Token balance as a decimal string in token units; non-negative, no scientific notation. Precision follows the token's decimals. example: '122100' symbol: type: string description: Token symbol as defined by the ERC-20 contract. example: TOKEN1 securitySchemes: ApiKeyAuthQuery: type: apiKey in: query name: apikey description: '' ApiKeyAuthHeader: type: apiKey in: header name: apikey description: '' ````