{"uid":"cap_fMu9bdnVDWztG-0t9Lcrr","slug":"blockscout-celo-epochs-api-b1e29886","name":"Blockscout Celo Epochs API","description":"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","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/celo/epochs","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jO0a1tY6iIIFU0Ty7gQan","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves paginated list of Celo blockchain epoch data including block ranges, distribution details, and finalization status","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Celo validator rewards audit","prompt":"Pull the last 20 Celo epochs from Blockscout so I can audit the validator reward distributions — I need the epoch number, block range, and distribution breakdown for each."},{"title":"Monitor Celo epoch finalization","prompt":"Check Blockscout for recent Celo epochs and tell me which ones are finalized and which are still pending — show me the epoch numbers and their timestamps."},{"title":"Research Celo epoch history","prompt":"I'm analyzing Celo's blockchain history — can you fetch epoch data from Blockscout starting from epoch number 500, showing 25 epochs at a time with their start and end block numbers?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T18:30:01.684Z","isFirstParty":false}