{"uid":"cap__RJZsDMdDPF8YWpxupNEE","slug":"blockscout-celo-epoch-election-rewards-by-type-b7d66d1a","name":"Blockscout Celo Epoch Election Rewards by Type","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/%7Bnumber%7D/election-rewards/%7Btype%7D","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":{"type":{"type":"string"},"number":{"type":"string"},"chain_id":{"type":"string"}}},"queryParams":{"type":"object","properties":{"amount":{"type":"string"},"items_count":{"type":"integer"},"account_address_hash":{"type":"string"},"associated_account_address_hash":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"type":"string","token":{"name":"string","type":{},"symbol":"string","decimals":"string","icon_url":"string","reputation":"string","volume_24h":"string","bridge_type":"string","address_hash":"string","total_supply":"string","exchange_rate":"string","holders_count":"string","foreign_address":"string","origin_chain_id":"string","circulating_supply":"string","circulating_market_cap":"string"},"amount":"string","account":{"hash":"string","name":"string","is_scam":true,"metadata":{},"proxy_type":"string","reputation":"string","is_contract":true,"is_verified":true,"public_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"private_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"ens_domain_name":"string","implementations":[{"name":"string","address_hash":"string"}],"watchlist_names":[{"label":"string","display_name":"string"}]},"block_hash":"string","block_number":0,"epoch_number":0,"block_timestamp":"string","associated_account":{"hash":"string","name":"string","is_scam":true,"metadata":{},"proxy_type":"string","reputation":"string","is_contract":true,"is_verified":true,"public_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"private_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"ens_domain_name":"string","implementations":[{"name":"string","address_hash":"string"}],"watchlist_names":[{"label":"string","display_name":"string"}]}}],"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_hxicV5Ykalr6WVwizviIZ","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 election rewards for a specific Celo epoch and reward type (e.g. voter, validator, group) across a given blockchain network","exampleAgentPrompt":"Can you pull the voter election rewards for Celo epoch 500 on Blockscout? I want to see which accounts received rewards and how much.","exampleUseCases":[{"title":"Audit validator rewards for an epoch","prompt":"Show me all the validator election rewards from Celo epoch 450 — I want to see each validator's address, the reward amounts, and the associated accounts."},{"title":"Track voter rewards for a specific address","prompt":"Look up all voter-type election rewards for address 0xABC123... in Celo epoch 480 on Blockscout — I need to verify how much staking reward they received."},{"title":"Monitor group election reward distribution","prompt":"Fetch the group election rewards for Celo epoch 510 so I can analyze how rewards were distributed across validator groups this epoch."}],"resultDescription":"Returns a paginated list of election reward entries for the specified Celo epoch and reward type. Each item includes the reward amount, the recipient account (with hash, name, ENS, tags, proxy type, verification status), the associated account, the underlying token metadata (name, symbol, decimals, exchange rate, supply), block hash, block number, epoch number, and block timestamp. A next_page_params object is included for cursor-based pagination.","failureModes":["Invalid chain_id returns 404 or empty response","Unknown or future epoch number returns empty items array","Invalid reward type string returns 400 or empty results","Malformed account_address_hash query parameter returns 400","Rate limit exceeded or payment failure returns 402 or 429","Pagination with stale items_count may skip or duplicate items"],"whenToPreferThis":"Use this endpoint when you specifically need Celo epoch-level election reward data broken down by reward type (voter, validator, group, etc.) across a specific epoch number. It is ideal for auditing staking reward distributions, verifying reward receipt for a particular address, or analyzing validator/group performance over epochs. Prefer this over generic transaction lookups when the goal is structured epoch reward data rather than raw transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T18:58:29.526Z","isFirstParty":false}