# Blockscout Celo Epoch Election Rewards by Type

> Blockscout Celo Epoch Election Rewards by Type 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-11).

Retrieves paginated election rewards for a specific Celo epoch and reward type (e.g. voter, validator, group) across a given blockchain network

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/celo/epochs/%7Bnumber%7D/election-rewards/%7Btype%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-celo-epoch-election-rewards-by-type-b7d66d1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__RJZsDMdDPF8YWpxupNEE

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-epoch-election-rewards-by-type-b7d66d1a
```

Example prompt: Can you pull the voter election rewards for Celo epoch 500 on Blockscout? I want to see which accounts received rewards and how much.

## When to prefer this

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.

## Known failure modes

- 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

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

## 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": {
      "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-celo-epoch-election-rewards-by-type-b7d66d1a/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)