# Blockscout Address Counters

> Blockscout Address Counters 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-14).

Returns aggregate activity counters for a blockchain address on a specific chain, including transaction count, token transfer count, gas usage, and validation count

## Facts

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

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-counters-cf7ba7fd
```

Example prompt: Using Blockscout, can you pull up the activity counters for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — I want to see the total transaction count, token transfers, and gas usage.

## When to prefer this

Use this endpoint when you need a quick, aggregated summary of an address's on-chain activity without paginating through full transaction lists. It is ideal for due diligence, activity scoring, or dashboard widgets. Prefer this over full transaction list endpoints when you only need counts, not individual transaction details. The multichain support via chain_id makes it useful for cross-chain wallet profiling.

## Known failure modes

- Invalid or malformed address_hash returns an error or empty response
- Unsupported or invalid chain_id returns a 404 or error
- Address exists but has zero activity — counters return '0' strings
- Rate limiting or payment failure returns a 402 or 429 status
- Chain not indexed by Blockscout returns a not-found error

## 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 JSON object with four string-typed counters: transactions_count (total transactions sent/received), token_transfers_count (total ERC-20/ERC-721/ERC-1155 transfers), gas_usage_count (total gas consumed by the address), and validations_count (number of blocks validated, relevant for validators/miners).

## 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"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "gas_usage_count": "string",
  "validations_count": "string",
  "transactions_count": "string",
  "token_transfers_count": "string"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-address-counters-cf7ba7fd/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)