# Blockscout Celo Epochs API

> Blockscout Celo Epochs 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).

Retrieves paginated list of Celo blockchain epoch data including block ranges, distribution details, and finalization status

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/celo/epochs
- 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-celo-epochs-api-b1e29886
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fMu9bdnVDWztG-0t9Lcrr

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-celo-epochs-api-b1e29886
```

Example prompt: Can you pull the latest Celo epoch data from Blockscout, showing me the block ranges, distribution details, and whether each epoch is finalized? Fetch 10 items per page.

## When to prefer this

Use this endpoint when you specifically need Celo epoch-level blockchain data — including validator distribution info, epoch finalization status, and block ranges — from Blockscout's indexed chain data. Prefer this over generic blockchain RPC calls when you need structured, paginated epoch history without running your own node.

## Known failure modes

- Invalid chain_id returns 404 or empty result
- Epoch number out of range returns empty items array
- Malformed query params return 400 Bad Request
- Payment not included or insufficient returns 402 Payment Required
- Rate limiting or network timeout returns 503 or timeout 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

A paginated JSON response containing an array of Celo epoch objects, each with an epoch number, type string, timestamp, start block number, end block number, distribution object, and finalization boolean. Also includes next_page_params for cursor-based pagination.

## 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"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "number": {
       "type": "integer"
      },
      "items_count": {
       "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": [
   {
    "type": "string",
    "number": 0,
    "timestamp": "string",
    "distribution": {},
    "is_finalized": true,
    "end_block_number": 0,
    "start_block_number": 0
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-celo-epochs-api-b1e29886/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)