{"openapi":"3.1.0","info":{"title":"Tezos (XTZ) On-Chain API","version":"1.0.0","description":"Live on-chain data from the Tezos blockchain (XTZ), a self-amending liquid-proof-of-stake Layer 1, served from the public TzKT indexer API — no key, nothing cached. The account endpoint returns any address's state: its XTZ balance, account type, the baker it delegates to, its staked balance, transaction count and first-activity date. The tokens endpoint returns the FA1.2 and FA2 token balances an address holds, with the token contract, symbol and decoded amount. The operations endpoint returns the account's most recent transactions with the counterparty, amount, status and time. The network endpoint returns the live chain state: the head block level, the current cycle, the active protocol and the total XTZ supply. Everything is read live from TzKT, nothing stored. This is the Tezos on-chain layer for any wallet, explorer, baking, NFT or analytics app. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, EVM and Solana on-chain APIs and from price feeds — this is Tezos account state, delegation, token balances, operations and ledger health. 4 endpoints, no key on our side.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tezos-api","description":"oanor gateway"}],"tags":[{"name":"Tezos"},{"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/account":{"get":{"operationId":"get_v1_account","tags":["Tezos"],"summary":"An address state + delegation","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Tezos address (tz1/tz2/tz3/KT1)","schema":{"type":"string"},"example":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"user","source":"Tezos (TzKT)","address":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","xtz_balance":534853.889891,"last_activity":"2026-06-09T20:21:40Z","first_activity":"2018-06-30T17:39:57Z","staked_balance":0,"num_activations":0,"num_transactions":220837},"meta":{"timestamp":"2026-06-09T20:24:40.010Z","request_id":"56e3f5e5-89b5-4c46-ae84-8dd9ae59044a"},"status":"ok","message":"Account 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/network":{"get":{"operationId":"get_v1_network","tags":["Tezos"],"summary":"Live Tezos chain state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"mainnet","cycle":1258,"level":13570281,"source":"Tezos (TzKT)","protocol":"PtTALLiNtPec7mE7yY4m3k26J8Qukef3E3ehzhfXgFZKGtDdAXu","timestamp":"2026-06-09T20:24:34Z","total_frozen_xtz":329050344.089066,"total_supply_xtz":1107384845.842752,"circulating_supply_xtz":1087399190.82335},"meta":{"timestamp":"2026-06-09T20:24:40.259Z","request_id":"fab53393-ef05-43a5-b6b4-4ceef9ff330d"},"status":"ok","message":"Network state 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/operations":{"get":{"operationId":"get_v1_operations","tags":["Tezos"],"summary":"Recent transactions","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Tezos address","schema":{"type":"string"},"example":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"},{"name":"limit","in":"query","required":false,"description":"Max operations (1-100, default 20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"Tezos (TzKT)","address":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","operations":[{"hash":"onee1V3TBTViQFoa6jPfTHT8TAB7jyCt6z4ewQnbFF1uPuRpJcf","time":"2026-06-09T20:21:40Z","type":"transaction","level":13570252,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":3.841967},{"hash":"op2khzKAY6ywXpFN5U4sSQi1P2eLqmtKGL1uQgFbZ5Lpxj4kkQk","time":"2026-06-09T20:14:55Z","type":"transaction","level":13570186,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.021528},{"hash":"opBXK7p6L5YPrY7npwDGDD7dxhuQjytJCJLTAfvX7SJ4RZWJm44","time":"2026-06-09T20:00:52Z","type":"transaction","level":13570047,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.05131},{"hash":"oo4gEXZ7PdWXvCZxX9Rp7PCaR5TEWjNpkTYGYhdLPMmPkFHVHMg","time":"2026-06-09T19:58:16Z","type":"transaction","level":13570021,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.020378},{"hash":"ooED6R5YQf8D38tBLGVAV53CbqGiskNjRiGsiHUEoNEVyGfkLEb","time":"2026-06-09T19:33:43Z","type":"transaction","level":13569780,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.022832},{"hash":"opTE7hBPMCAz7FdCtCopr89d3gXgo1kYxmBb9R8PopWyqg1N4LP","time":"2026-06-09T17:20:25Z","type":"transaction","level":13568453,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.020366},{"hash":"opRjqjtVyFQ1XL2S1gmZPzewVPZUD4MvBE58f7UndhQiht4Vj8o","time":"2026-06-09T16:39:22Z","type":"transaction","level":13568050,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":13.841758},{"hash":"op49CgsuySiZsfLLHohcx5JJHfwNZEHoSRuK413c4J91uhGF3dA","time":"2026-06-09T16:22:40Z","type":"transaction","level":13567883,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.022102},{"hash":"opGo75Xu694PctM8Af3vdHez6bazd95TbSERpdrQSjA6tBWVdXB","time":"2026-06-09T16:21:46Z","type":"transaction","level":13567874,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.030415},{"hash":"ooZ1UxaHp7PdVQ8tw3XwMmCjB2cujbpFksZML8v4wkXy9NGJfcT","time":"2026-06-09T16:08:49Z","type":"transaction","level":13567749,"sender":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","status":"applied","target":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","amount_xtz":0.033127}]},"meta":{"timestamp":"2026-06-09T20:24:40.533Z","request_id":"41415e7b-d541-43e5-a658-c5c66542b0eb"},"status":"ok","message":"Operations 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/tokens":{"get":{"operationId":"get_v1_tokens","tags":["Tezos"],"summary":"FA1.2/FA2 token balances","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Tezos address","schema":{"type":"string"},"example":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"},{"name":"limit","in":"query","required":false,"description":"Max tokens (1-100, default 30)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Tezos (TzKT)","tokens":[{"name":"Tezos staking reward campaign","symbol":"You won 1000 Tezos!","balance":1000,"contract":"KT18j785rB3G4wXxEpqwwG2hJ2iZrjLAbeo7","decimals":18,"standard":"fa2","token_id":"0"},{"name":"Anger","symbol":"ANG","balance":54.82992009,"contract":"KT1KdV9rehYa7qM5wuNKm6verqYhSi17kRch","decimals":9,"standard":"fa2","token_id":"0"},{"name":"Kolibri DAO","symbol":"kdao.app","balance":48000,"contract":"KT1LrmBr6fgM2eFSNLRJm4H17gAxVXJH2FCB","decimals":6,"standard":"fa1.2","token_id":"0"},{"name":"Kolibri DAO","symbol":"kdao.app","balance":24000,"contract":"KT1WKtfmeZUXUDT2wzsx4DYNF9LSbMijnxNn","decimals":6,"standard":"fa1.2","token_id":"0"},{"name":"Everstake.app","symbol":"STKR","balance":24000,"contract":"KT1DDgiZ5bS6pfnNL8wwXdszXZHbwxFPTX3t","decimals":6,"standard":"fa1.2","token_id":"0"},{"name":"Kolibri DAO","symbol":"kdao.app","balance":18000,"contract":"KT1QVjkhUPCuAr7CzwpkiauNpKg7QWHAogur","decimals":6,"standard":"fa1.2","token_id":"0"},{"name":"Kolibri DAO","symbol":"kdao.app","balance":18000,"contract":"KT1HEBS2qDsGkrawacrWJfDgpqrvcjSuWFW1","decimals":6,"standard":"fa1.2","token_id":"0"},{"name":"Kolibri DAO","symbol":"kdao.app","balance":12800,"contract":"KT1UE2UpjSJa3tbBMTCY9H9qpPtakVJDHDps","decimals":6,"standard":"fa1.2","token_id":"0"},{"name":"Smartlink","symbol":"SMAK","balance":11327140.2,"contract":"KT1TwzD6zV3WeJ39ukuqxcfK2fJCnhvrdN1X","decimals":3,"standard":"fa1.2","token_id":"0"},{"name":"Milk","symbol":"MILK","balance":64.43721613,"contract":"KT1EBpRMdK98rPpaXqJeW4822WAdwXYNL64d","decimals":8,"standard":"fa2","token_id":"0"}],"address":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","token_count":10},"meta":{"timestamp":"2026-06-09T20:24:40.704Z","request_id":"b54a3d6c-db99-45c3-8a89-0103dfff76f5"},"status":"ok","message":"Tokens 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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"TzKT public indexer API (live)","service":"tezos-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/tokens":"An address's FA1.2/FA2 token balances (address=, limit).","GET /v1/account":"An address's state + delegation (address=tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU).","GET /v1/network":"Live Tezos chain state: head level, cycle, protocol, total supply.","GET /v1/operations":"An address's recent transactions (address=, limit)."},"head_level":13570281,"description":"Live on-chain data from the Tezos blockchain (XTZ) via the public TzKT indexer: any address's state (XTZ balance, type, the baker it delegates to, staked balance, transaction count, first/last activity); its FA1.2 and FA2 token balances with contract, symbol and decoded amount; its recent transactions (counterparty, amount, status, time); and the live chain state (head level, cycle, protocol, total XTZ supply). Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, EVM and Solana on-chain APIs and from price feeds — this is Tezos account state, delegation, token balances, operations and ledger health.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T20:24:40.867Z","request_id":"7b90dabe-a416-4d8f-8969-68dd0dc78556"},"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":3800,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1300,"monthly_call_quota":98000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3000,"monthly_call_quota":590000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7100,"monthly_call_quota":3100000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tezos-api"}