# Blockscout Chain Stats API

> Blockscout Chain Stats API 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-12).

Returns aggregate blockchain statistics for a specific chain including gas prices, market cap, total transactions, and network utilization

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/stats
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-chain-stats-api-639bcb2c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_owtHc_2uIEUg1DLhRIfpr

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-chain-stats-api-639bcb2c
```

Example prompt: Pull the current chain stats for Ethereum from Blockscout — I want to see gas prices, total transactions, market cap, and network utilization right now.

## When to prefer this

Use this endpoint when you need a comprehensive snapshot of a specific blockchain network's health and activity metrics — gas prices, transaction volumes, coin pricing, and network utilization — in a single call. Prefer this over individual metric endpoints when you need multiple stats at once, or when building dashboards that monitor chain-level KPIs. It is especially useful for gas price awareness before submitting transactions, or for comparing network activity across chains supported by Blockscout.

## Known failure modes

- Invalid or unsupported chain_id returns 404 or empty response
- Chain not indexed by Blockscout returns error or null fields
- Rate limiting or payment failure returns 402 or 429
- Temporary data staleness if gas price update interval has not elapsed
- Some fields like TVL or secondary_coin_price may be null for chains without those metrics

## 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

A JSON object containing chain-level statistics including TVL, native coin price and image, coin price change percentage, gas prices object, static gas price, gas used today, total gas used, total blocks, total addresses, total transactions, transactions today, average block time, network utilization percentage, and timestamps for gas price updates.

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tvl": "string",
  "coin_image": "string",
  "coin_price": "string",
  "gas_prices": {},
  "market_cap": "string",
  "total_blocks": "string",
  "gas_used_today": {},
  "total_gas_used": "string",
  "total_addresses": "string",
  "static_gas_price": "string",
  "average_block_time": 0,
  "total_transactions": "string",
  "transactions_today": "string",
  "gas_price_updated_at": "string",
  "gas_prices_update_in": 0,
  "secondary_coin_image": "string",
  "secondary_coin_price": "string",
  "coin_price_change_percentage": 0,
  "network_utilization_percentage": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-chain-stats-api-639bcb2c/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)