{"openapi":"3.1.0","info":{"title":"Tezos Bakers API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tezosbakers-api","description":"oanor gateway"}],"tags":[{"name":"Staking"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/baker":{"get":{"operationId":"get_v1_baker","tags":["Staking"],"summary":"Full profile of one baker","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Tezos baker address (tz1.../tz2.../tz3...)","schema":{"type":"string"},"example":"tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/bakers":{"get":{"operationId":"get_v1_bakers","tags":["Staking"],"summary":"Active bakers ranked by staked balance","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"How many (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":[{"active":true,"address":"tz1cJTktkAEhxyWZAyQrjcqZJ3BeQYyQMvBt","stakers":0,"delegators":2,"staked_xtz":20543376.389555,"balance_xtz":20549966.145865,"delegated_xtz":2.220181},{"alias":"Coinbase Baker","active":true,"address":"tz1irJKkXS2DBWkU1NnmFQx1c1L7pbGg4yhk","stakers":0,"delegators":2809,"staked_xtz":13259662.2122,"balance_xtz":14655661.275982,"delegated_xtz":86520569.84476},{"active":true,"address":"tz3W7k9v3uniY1f2HQRKxymJybNvH3FgvZ5N","stakers":0,"delegators":1,"staked_xtz":8134288.899955,"balance_xtz":8134651.70262,"delegated_xtz":0.1},{"alias":"Tezos Foundation Baker 4","active":true,"address":"tz3UQN6nBQHofmgQ3pZannhiYE2CT7TEZFim","stakers":5,"delegators":6,"staked_xtz":5748159.315512,"balance_xtz":8059323.957814,"delegated_xtz":11725392.391377},{"alias":"TenX Protocols Baker","active":true,"address":"tz1NZMY994zzvGoccJzU3AXvveNe1EUMg8rq","stakers":1,"delegators":4,"staked_xtz":5679236.886665,"balance_xtz":5690705.905843,"delegated_xtz":1896338.060024},{"alias":"Tezos Foundation Baker 3","active":true,"address":"tz3UC5hM9uCUiqmAw1pHdxjAdGueQMd8u3wf","stakers":4,"delegators":7,"staked_xtz":5672451.799932,"balance_xtz":7979578.448611,"delegated_xtz":14090269.167977},{"alias":"Tezos Foundation Baker 1","active":true,"address":"tz3cqThj23Feu55KDynm7Vg81mCMpWDgzQZq","stakers":5,"delegators":17,"staked_xtz":5369170.596098,"balance_xtz":8302629.81692,"delegated_xtz":6024949.379586},{"alias":"Everstake","active":true,"address":"tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM","stakers":482,"delegators":60361,"staked_xtz":4914558.250282,"balance_xtz":6840252.762747,"delegated_xtz":33530350.076258},{"alias":"Tezos Foundation Baker 2","active":true,"address":"tz3ipHZQpBBFuxv7eKoFgGnTaU3RBhnS93yY","stakers":4,"delegators":6,"staked_xtz":4781433.857769,"balance_xtz":7599354.052526,"delegated_xtz":9772576.971628},{"alias":"Kraken Baker","active":true,"address":"tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv","stakers":81,"delegators":3831,"staked_xtz":4319722.872343,"balance_xtz":4515610.295371,"delegated_xtz":8883777.40561},{"alias":"Kiln","active":true,"address":"tz3dKooaL9Av4UY15AUx9uRGL5H6YyqoGSPV","stakers":18,"delegators":103,"staked_xtz":3087959.549659,"balance_xtz":3095564.073376,"delegated_xtz":26402038.606639},{"alias":"Chorus One - Stake Only","active":true,"address":"tz1eEnQhbwf6trb8Q8mPb2RaPkNk2rN7BKi8","stakers":26,"delegators":2484,"staked_xtz":3055232.976737,"balance_xtz":3115522.929318,"delegated_xtz":5020464.319933},{"alias":"Binance Baker","active":true,"address":"tz1S8MNvuFEUsWgjHvi3AxibRBf388NhT1q2","stakers":3,"delegators":978,"staked_xtz":2829323.098069,"balance_xtz":2831224.918874,"delegated_xtz":25482.594638},{"active":true,"address":"tz1cHuQiBTVDZJT591QG5KjS7h3QieGkzYut","stakers":3,"delegators":5,"staked_xtz":2464374.163522,"balance_xtz":2470370.242759,"delegated_xtz":2901932.628208},{"active":true,"address":"tz1Kt4P8BCaP93AEV4eA7gmpRryWt5hznjCP","stakers":0,"delegators":5,"staked_xtz":2242859.816013,"balance_xtz":2243419.060388,"delegated_xtz":6.000092},{"active":true,"address":"tz1TvWQRwL6GUXio97RiKRsoRbeB662e6je4","stakers":2,"delegators":2,"staked_xtz":2196422.795625,"balance_xtz":2196496.832196,"delegated_xtz":1.175928},{"active":true,"address":"tz1eDKeD934e22muFRzVHxZYvFFx39QKHyj3","stakers":2,"delegators":12,"staked_xtz":2191034.617532,"balance_xtz":2386365.748185,"delegated_xtz":11604691.79139},{"active":true,"address":"tz1WCHXtELv4C7NvUTf59bEgmRSBRkiVGLeJ","stakers":2,"delegators":2,"staked_xtz":2164804.607573,"balance_xtz":2164913.018031,"delegated_xtz":2.185478},{"active":true,"address":"tz1eCq647sXnC7qkCydJJ7RhzdAR1RcmfXFw","stakers":2,"delegators":2,"staked_xtz":2134536.378743,"balance_xtz":2134594.751922,"delegated_xtz":1.185928},{"alias":"P2P.org","active":true,"address":"tz1P2Po7YM526ughEsRbY4oR9zaUPDZjxFrb","stakers":75,"delegators":4576,"staked_xtz":2101461.556579,"balance_xtz":2146913.558632,"delegated_xtz":17189107.965606}],"source":"TzKT"},"meta":{"timestamp":"2026-06-14T08:03:54.834Z","request_id":"cb345660-306e-4bbb-86f0-aad29fa2bce5"},"status":"ok","message":"Bakers retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cycle":{"get":{"operationId":"get_v1_cycle","tags":["Staking"],"summary":"Current (or a given) Tezos protocol cycle","description":"","parameters":[{"name":"cycle","in":"query","required":false,"description":"Cycle index (omit for current)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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_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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6300,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":910,"monthly_call_quota":121000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3250,"monthly_call_quota":745000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9200,"monthly_call_quota":4710000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tezosbakers-api"}