# Blockscout Address Coin Balance History

> Blockscout Address Coin Balance History is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Retrieves the historical native coin balance changes for a specific address on a given blockchain network

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/addresses/%7Baddress_hash_param%7D/coin-balance-history
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-address-coin-balance-history-f7895a16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gSO_iA_d-5yLTzUHitSne

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-address-coin-balance-history-f7895a16
```

Example prompt: Can you pull the native coin balance history for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum (chain ID 1) using Blockscout, showing the last 50 balance change events?

## When to prefer this

Use this endpoint when you need a chronological, block-level record of native coin (ETH, MATIC, etc.) balance changes for a specific address on a specific chain. Prefer this over token transfer endpoints when you care about the native gas token balance rather than ERC-20 tokens. It is ideal for auditing, forensics, and timeline reconstruction of wallet activity. Blockscout's multichain support means you can query the same pattern across many EVM-compatible networks by simply changing the chain_id.

## Known failure modes

- Invalid or malformed address hash returns an error or empty result
- Unsupported chain_id returns a not-found or routing error
- No balance history exists for a new or inactive address — returns empty items array
- Pagination parameters out of range may return empty results
- Rate limiting or payment failure returns 402 or 429 status

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

Returns a paginated list of native coin balance change events for the address, each containing: the balance delta (change amount), the cumulative balance value after the change, the block number where the change occurred, the block timestamp, and the transaction hash that caused the change. Also includes next_page_params for cursor-based pagination through historical records.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      },
      "address_hash_param": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "items_count": {
       "type": "integer"
      },
      "block_number": {
       "type": "integer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "delta": "string",
    "value": "string",
    "block_number": 0,
    "block_timestamp": "string",
    "transaction_hash": "string"
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-address-coin-balance-history-f7895a16/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)