# Tezos Bakers API > Read live Tezos staking and delegation data from the public TzKT indexer — no key. Tezos secures itself through "bakers" (its validators) that stake XTZ and accept delegations; this surfaces the layer that account- and operation-level APIs miss. Rank the active bakers by stake with their delegated balance, number of stakers and commission fee; look up any single baker for its full profile (balances in XTZ, stakers, delegation, activity); and read the current protocol cycle — its index, rights-snapshot level, total baking power and the number of bakers and delegators — so stakers can judge yield and decentralization before they delegate. The staking-and-baker layer every Tezos wallet, delegation dashboard, staker and analytics tool needs. Live from the indexer; short cache only. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/tezosbakers-api/..." ``` ## Pricing - **Free** (Free) — 6,300 calls/Mo, 3 req/s - **Starter** ($9/Mo) — 121,000 calls/Mo, 8 req/s - **Pro** ($33/Mo) — 745,000 calls/Mo, 20 req/s - **Business** ($92/Mo) — 4,710,000 calls/Mo, 50 req/s ## Endpoints ### Staking #### `GET /v1/baker` — Full profile of one baker **Parameters:** - `address` (query, required, string) — Tezos baker address (tz1.../tz2.../tz3...) Example: `tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tezosbakers-api/v1/baker?address=tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM" ``` **Response:** ```json { "data": { "fee": null, "note": "Full profile of a Tezos baker from TzKT: balances (in XTZ), stakers, delegation, commission and activity.", "alias": "Everstake", "active": true, "source": "TzKT", "address": "tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM", "stakers": 482, "revealed": true, "delegators": 60361, "public_key": "edpkuNVuqdPhCsrYqkq21qW2hYTSZWMjQQjfyogoPZ2AfqCmonziNh", "staked_xtz": 4914558.250282, "balance_xtz": 6840252.762747, "delegated_xtz": 33530350.076258, "last_activity": "2026-06-14T08:03:49Z", "first_activity": "2020-03-11T14:46:57Z", "total_staked_xtz": 10682031.746944, "external_staked_xtz": 5767473.496662 }, "meta": { "timestamp": "2026-06-14T08:03:54.725Z", "request_id": "1a131d74-907a-475e-8035-ddec5336527e" }, "status": "ok", "message": "Baker retrieved successfully", "success": true } ``` #### `GET /v1/bakers` — Active bakers ranked by staked balance **Parameters:** - `limit` (query, optional, string) — How many (1-100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tezosbakers-api/v1/bakers?limit=20" ``` **Response:** ```json { "data": { "note": "Active Tezos bakers ranked by staked balance (in XTZ). delegated_xtz is the balance delegated to them; fee is the baker's commission.", "count": 20, "bakers": [ { "fee": null, "alias": null, "active": true, "address": "tz1cJTktkAEhxyWZAyQrjcqZJ3BeQYyQMvBt", "stakers": 0, "delegators": 2, "staked_xtz": 20543376.389555, "balance_xtz": 20549966.145865, "delegated_xtz": 2.220181 }, { "fee": null, "alias": "Coinbase Baker", "active": true, "address": "tz1irJKkXS2DBWkU1NnmFQx1c1L7pbGg4yhk", "stakers": 0, "delegators": 2809, "staked_xtz": 13259662.2122, "balance_xtz": 14655661.275982, "delegated_xtz": 86520569.84476 }, { "fee": null, "alias": null, "active": true, "address": "tz3W7k9v3uniY1f2HQRKxymJybNvH3FgvZ5N", "stakers": 0, "delegators": 1, "staked_xtz": 8134288.899955, "balance_xtz": 8134651.70262, "delegated_xtz": 0.1 }, { "fee": null, "alias": "Tezos Foundation Baker 4", "ac …(truncated, see openapi.json for full schema) ``` #### `GET /v1/cycle` — Current (or a given) Tezos protocol cycle **Parameters:** - `cycle` (query, optional, string) — Cycle index (omit for current) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tezosbakers-api/v1/cycle" ``` **Response:** ```json { "data": { "note": "A Tezos protocol cycle: its level range, the rights-snapshot level, total baking power (in XTZ) and the number of bakers/delegators. Omit cycle for the current one.", "cycle": 1264, "source": "TzKT", "end_time": "2026-06-16T21:17:25Z", "last_level": 13670688, "start_time": "2026-06-15T21:17:31Z", "first_level": 13656289, "total_bakers": 217, "snapshot_level": 13627488, "total_delegators": null, "total_baking_power_xtz": 435477508.058707 }, "meta": { "timestamp": "2026-06-14T08:03:54.933Z", "request_id": "99bc465d-2673-4470-8578-d078a945e96f" }, "status": "ok", "message": "Cycle retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata & live sample **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tezosbakers-api/v1/meta" ``` **Response:** ```json { "data": { "sample": { "top_baker": "tz1cJTktkAEhxyWZAyQrjcqZJ3BeQYyQMvBt" }, "source": "public TzKT API (api.tzkt.io), keyless", "service": "tezosbakers-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/baker": "Full profile of one baker (address=tz1...).", "GET /v1/cycle": "The current (or a given) Tezos protocol cycle (optional cycle).", "GET /v1/bakers": "Active bakers ranked by staked balance (limit)." }, "description": "Read live Tezos staking and delegation data from the public TzKT indexer: rank active bakers by stake with their delegated balance/stakers/fee, look up any single baker's profile, and read the current protocol cycle (index, snapshot level, total baking power). The staking-and-baker layer for Tezos wallets, delegation dashboards and stakers. Live, short cache only.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-14T08:03:55.025Z", "request_id": "cb8ae207-91f0-4f1f-87a0-f19c2b00e11c" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/tezosbakers-api OpenAPI spec: https://www.oanor.com/api/tezosbakers-api/openapi.json