{"openapi":"3.1.0","info":{"title":"Tezos Bigmaps API","version":"1.0.0","description":"Read Tezos's on-chain key-value storage (bigmaps) live from the public TzKT indexer — no key. A bigmap is Tezos's lazily-deserialised on-chain map: the data structure smart contracts use for the big stuff — token ledgers (who owns what), NFT ownership, allowances and metadata. The Tezos contract explorer lists contracts and their interface, but it cannot browse the bigmaps themselves, read a bigmap's typed key/value schema, or page through its live key-value entries. This opens that. Browse and rank the bigmaps by size with their pointer, owning contract, path (e.g. \"ledger\"), tags and total/active key counts; read one bigmap's detail and its typed key/value schema (what shape each row's key and value take, e.g. an address-to-nat token ledger); and page through a bigmap's live key-value entries — the actual on-chain data, such as the address-to-balance rows of a token ledger or the owner rows of an NFT collection. The storage / data layer for Tezos explorers, indexers, token dashboards and analytics. Distinct from the Tezos on-chain reader (account state), the smart-contract explorer, the FA-token registry and the .tez naming reader. Live from the indexer; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tezosbigmaps-api","description":"oanor gateway"}],"tags":[{"name":"Bigmaps"},{"name":"Bigmap"},{"name":"Keys"},{"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/bigmaps":{"get":{"operationId":"get_v1_bigmaps","tags":["Bigmaps"],"summary":"Browse/rank bigmaps by key count","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Browse Tezos bigmaps — the on-chain key-value maps smart contracts use for token ledgers, NFT ownership, allowances and metadata — ranked by total key count. Each carries its pointer (ptr), owning contract, path (e.g. 'ledger'), tags and total/active key counts. Paginate with limit; read one in /v1/bigmap, its rows in /v1/keys.","count":25,"source":"TzKT","bigmaps":[{"ptr":511,"path":"ledger","tags":["ledger"],"active":true,"updates":21410421,"contract":"hic et nunc NFTs","last_level":13639260,"total_keys":7094521,"active_keys":7094521,"first_level":1365143,"contract_address":"KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton"},{"ptr":103258,"path":"asks","tags":[],"active":true,"updates":7734628,"contract":"objkt.com Marketplace v2","last_level":13639275,"total_keys":3373150,"active_keys":1010963,"first_level":2103248,"contract_address":"KT1WvzYHCNBvDSdwafTHv7nJ1dWmZ8GCYuuC"},{"ptr":399689,"path":"assets.ledger","tags":["ledger"],"active":true,"updates":3427522,"contract":"McLaren F1 Team 23/23 Collectibles","last_level":13526226,"total_keys":2859525,"active_keys":2714065,"first_level":3188468,"contract_address":"KT1BRADdqGk2eLmMqvyWzqVmPQ1RCBCbW5dY"},{"ptr":513,"path":"operators","tags":[],"active":true,"updates":3668100,"contract":"hic et nunc NFTs","last_level":13639265,"total_keys":2040567,"active_keys":1374314,"first_level":1365143,"contract_address":"KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton"},{"ptr":149768,"path":"ledger","tags":["ledger"],"active":true,"updates":4869622,"contract":"FXHASH GENTK v2","last_level":13638324,"total_keys":1925495,"active_keys":1925495,"first_level":2280661,"contract_address":"KT1U6EHmNxJTkvaWJ4ThczG4FSDaHC21ssvi"},{"ptr":6072,"path":"swaps","tags":[],"active":true,"updates":5405332,"contract":"hic et nunc Marketplace","last_level":13639036,"total_keys":1591471,"active_keys":822826,"first_level":1540787,"contract_address":"KT1HbQepzV1nVGg8QVznG7z4RcHseD5kwqBn"},{"ptr":22785,"path":"ledger","tags":["ledger"],"active":true,"updates":3239709,"contract":"FXHASH GENTK","last_level":13638636,"total_keys":1208932,"active_keys":1208932,"first_level":1832143,"contract_address":"KT1KEa8z6vWXDJrVqtMrAeDVzsvxat3kHaCE"},{"ptr":149787,"path":"listings","tags":[],"active":true,"updates":2040628,"contract":"FXHASH Marketplace v2","last_level":13638324,"total_keys":1131473,"active_keys":222319,"first_level":2280663,"contract_address":"KT1GbyoDi7H1sfXmimXpptZJuCdHMh66WS9u"},{"ptr":149771,"path":"token_data","tags":[],"active":true,"updates":2060533,"contract":"FXHASH GENTK v2","last_level":13629139,"total_keys":1030009,"active_keys":1030009,"first_level":2280661,"contract_address":"KT1U6EHmNxJTkvaWJ4ThczG4FSDaHC21ssvi"},{"ptr":149772,"path":"token_metadata","tags":["token_metadata"],"active":true,"updates":2060533,"contract":"FXHASH GENTK v2","last_level":13629139,"total_keys":1030009,"active_keys":1030009,"first_level":2280661,"contract_address":"KT1U6EHmNxJTkvaWJ4ThczG4FSDaHC21ssvi"},{"ptr":359181,"path":"token_metadata","tags":["token_metadata"],"active":true,"updates":1897066,"contract":"NFTimbre #1","last_level":11464034,"total_keys":999985,"active_keys":119923,"first_level":3033862,"contract_address":"KT1Qhu6nFTJLno4YELMSZR5krwaFnaEg7Qv6"},{"ptr":359182,"path":"ledger","tags":["ledger"],"active":true,"updates":1912690,"contract":"NFTimbre #1","last_level":13621383,"total_keys":999985,"active_keys":119923,"first_level":3033862,"contract_address":"KT1Qhu6nFTJLno4YELMSZR5krwaFnaEg7Qv6"},{"ptr":347453,"path":"assets.ledger","tags":["ledger"],"active":true,"updates":948453,"contract":"The Keys of Manchester United digital collectibles","last_level":13378048,"total_keys":910084,"active_keys":888239,"first_level":2972317,"contract_address":"KT1V7QCmuKpGsThwCNRALmsVfDAYopV98EEL"},{"ptr":347455,"path":"assets.token_metadata","tags":["token_metadata"],"active":true,"updates":888240,"contract":"The Keys of Manchester United digital collectibles","last_level":2988097,"total_keys":888239,"active_keys":888239,"first_level":2972317,"contract_address":"KT1V7QCmuKpGsThwCNRALmsVfDAYopV98EEL"},{"ptr":347456,"path":"assets.token_total_supply","tags":[],"active":true,"updates":1776479,"contract":"The Keys of Manchester United digital collectibles","last_level":2988097,"total_keys":888239,"active_keys":888239,"first_level":2972317,"contract_address":"KT1V7QCmuKpGsThwCNRALmsVfDAYopV98EEL"},{"ptr":522,"path":"royalties","tags":[],"active":true,"updates":880957,"contract":"hic et nunc Minter","last_level":13639242,"total_keys":880956,"active_keys":880956,"first_level":1365148,"contract_address":"KT1Hkg5qeNhfwpKW4fXvq7HGZB9z2EnmCCA9"},{"ptr":514,"path":"token_metadata","tags":["token_metadata"],"active":true,"updates":880957,"contract":"hic et nunc NFTs","last_level":13639242,"total_keys":880956,"active_keys":880956,"first_level":1365143,"contract_address":"KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton"},{"ptr":103260,"path":"offers","tags":[],"active":true,"updates":1664660,"contract":"objkt.com Marketplace v2","last_level":13612730,"total_keys":848308,"active_keys":31957,"first_level":2103248,"contract_address":"KT1WvzYHCNBvDSdwafTHv7nJ1dWmZ8GCYuuC"},{"ptr":509759,"path":"assets.ledger","tags":["ledger"],"active":true,"updates":852021,"contract":"Collect United: 23/24","last_level":13552132,"total_keys":726339,"active_keys":683783,"first_level":3997361,"contract_address":"KT1LBXXg9UFvyfdvPmRMc4JZQsYWdyPCS6ue"},{"ptr":684371,"path":"asks","tags":[],"active":true,"updates":1291155,"contract":"KT1SwbTqhSKF6Pdokiu1K4Fpi17ahPPzmt1X","last_level":13639326,"total_keys":665636,"active_keys":339559,"first_level":7038754,"contract_address":"KT1SwbTqhSKF6Pdokiu1K4Fpi17ahPPzmt1X"},{"ptr":149767,"path":"token_data","tags":[],"active":true,"updates":590647,"contract":"FXHASH Views Legacy","last_level":2285517,"total_keys":589146,"active_keys":589146,"first_level":2280660,"contract_address":"KT1WRpPyXHSCbTfDQFWVXbMpxxvf7Y7KChxc"},{"ptr":22788,"path":"token_data","tags":[],"active":true,"updates":1178223,"contract":"FXHASH GENTK","last_level":2493528,"total_keys":589146,"active_keys":589146,"first_level":1832143,"contract_address":"KT1KEa8z6vWXDJrVqtMrAeDVzsvxat3kHaCE"},{"ptr":22789,"path":"token_metadata","tags":["token_metadata"],"active":true,"updates":1178223,"contract":"FXHASH GENTK","last_level":2493528,"total_keys":589146,"active_keys":589146,"first_level":1832143,"contract_address":"KT1KEa8z6vWXDJrVqtMrAeDVzsvxat3kHaCE"},{"ptr":654290,"path":"assets.ledger","tags":["ledger"],"active":true,"updates":596651,"contract":"KT1RRTZ6DGnAPYTxXx4kzzQZFiZ8yo76pULU","last_level":13109939,"total_keys":583067,"active_keys":569886,"first_level":6162726,"contract_address":"KT1RRTZ6DGnAPYTxXx4kzzQZFiZ8yo76pULU"},{"ptr":654292,"path":"assets.token_total_supply","tags":[],"active":true,"updates":569887,"contract":"KT1RRTZ6DGnAPYTxXx4kzzQZFiZ8yo76pULU","last_level":9394906,"total_keys":569886,"active_keys":569886,"first_level":6162726,"contract_address":"KT1RRTZ6DGnAPYTxXx4kzzQZFiZ8yo76pULU"}]},"meta":{"timestamp":"2026-06-14T17:03:52.265Z","request_id":"015e8d90-1d58-43ae-8881-437ff6a949de"},"status":"ok","message":"Bigmaps 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/bigmap":{"get":{"operationId":"get_v1_bigmap","tags":["Bigmap"],"summary":"One bigmap detail + key/value schema","description":"","parameters":[{"name":"ptr","in":"query","required":false,"description":"Bigmap pointer (numeric); omit for the largest","schema":{"type":"string"},"example":"511"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ptr":511,"note":"One Tezos bigmap in full: its owning contract and path, total/active key counts, and its typed key/value schema (what shape each row's key and value take — e.g. an address→nat token ledger). Omit ptr to use the largest bigmap.","path":"ledger","tags":["ledger"],"active":true,"source":"TzKT","updates":21410421,"contract":"hic et nunc NFTs","key_type":{"args":[{"prim":"address"},{"prim":"nat"}],"prim":"pair"},"last_level":13639260,"total_keys":7094521,"value_type":{"prim":"nat"},"active_keys":7094521,"first_level":1365143,"contract_address":"KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton"},"meta":{"timestamp":"2026-06-14T17:03:52.360Z","request_id":"6ccd73a6-f8bd-4108-9624-b159364e6839"},"status":"ok","message":"Bigmap 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/keys":{"get":{"operationId":"get_v1_keys","tags":["Keys"],"summary":"A bigmap's live key-value entries","description":"","parameters":[{"name":"ptr","in":"query","required":false,"description":"Bigmap pointer (numeric); omit for the largest","schema":{"type":"string"},"example":"511"},{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ptr":"511","keys":[{"id":69977850,"key":{"nat":"881107","address":"KT1PHubm9HtyQEJ4BBpMTVomq6mhbfNZ9z5w"},"value":"1","active":true,"updates":1,"first_level":13639260},{"id":69977833,"key":{"nat":"881107","address":"tz1hghbrDGx33HendcHRAdKUDtdFoFP24uaE"},"value":"0","active":true,"updates":2,"first_level":13639242},{"id":69977826,"key":{"nat":"881106","address":"KT1PHubm9HtyQEJ4BBpMTVomq6mhbfNZ9z5w"},"value":"1","active":true,"updates":1,"first_level":13639236},{"id":69977820,"key":{"nat":"881106","address":"tz1gNa1o9LjxjR6T4iqyAUNTNz3QRzfNdr2E"},"value":"0","active":true,"updates":2,"first_level":13639227},{"id":69977789,"key":{"nat":"861355","address":"tz1g9jiDLMcadVEfMxMhToUWNB6hvMcMsFKY"},"value":"1","active":true,"updates":1,"first_level":13639168},{"id":69977743,"key":{"nat":"627160","address":"tz1LJmf4GUTrNsZVWXomSfqyWEWdNPo75Wz3"},"value":"1","active":true,"updates":1,"first_level":13639036},{"id":69977736,"key":{"nat":"706328","address":"tz1LJmf4GUTrNsZVWXomSfqyWEWdNPo75Wz3"},"value":"1","active":true,"updates":1,"first_level":13639019},{"id":69977729,"key":{"nat":"571904","address":"tz1LJmf4GUTrNsZVWXomSfqyWEWdNPo75Wz3"},"value":"1","active":true,"updates":1,"first_level":13639009},{"id":69977711,"key":{"nat":"879090","address":"tz1QRXxx7R8fAnCESAkDWzShRYkmPJnUztYU"},"value":"1","active":true,"updates":1,"first_level":13638981},{"id":69977709,"key":{"nat":"880622","address":"tz1QRXxx7R8fAnCESAkDWzShRYkmPJnUztYU"},"value":"1","active":true,"updates":1,"first_level":13638974},{"id":69977708,"key":{"nat":"880776","address":"tz1QRXxx7R8fAnCESAkDWzShRYkmPJnUztYU"},"value":"1","active":true,"updates":1,"first_level":13638971},{"id":69977707,"key":{"nat":"855846","address":"tz1QRXxx7R8fAnCESAkDWzShRYkmPJnUztYU"},"value":"1","active":true,"updates":1,"first_level":13638967},{"id":69977696,"key":{"nat":"881105","address":"KT1PHubm9HtyQEJ4BBpMTVomq6mhbfNZ9z5w"},"value":"5","active":true,"updates":1,"first_level":13638952},{"id":69977636,"key":{"nat":"869722","address":"tz1YeNvxVb5fv2Tf3mWzg4XuqcXMBFq9U45z"},"value":"1","active":true,"updates":1,"first_level":13638853},{"id":69977617,"key":{"nat":"881105","address":"tz1YywqDsZzQWa6JzXo11RpC6y4ABvDqQoAT"},"value":"15","active":true,"updates":2,"first_level":13638804},{"id":69977402,"key":{"nat":"576355","address":"tz1VNz1wpqSQdj4q1wdYSUgm3A5wh3t9BQCv"},"value":"1","active":true,"updates":1,"first_level":13638669},{"id":69977361,"key":{"nat":"881060","address":"tz1YeNvxVb5fv2Tf3mWzg4XuqcXMBFq9U45z"},"value":"1","active":true,"updates":1,"first_level":13638609},{"id":69977350,"key":{"nat":"101738","address":"tz1YeNvxVb5fv2Tf3mWzg4XuqcXMBFq9U45z"},"value":"1","active":true,"updates":1,"first_level":13638595},{"id":69977195,"key":{"nat":"881104","address":"KT1PHubm9HtyQEJ4BBpMTVomq6mhbfNZ9z5w"},"value":"1","active":true,"updates":1,"first_level":13638267},{"id":69977190,"key":{"nat":"881104","address":"tz1LhtY8hGemFQVjKAPoLRnHADipXmPDfdDu"},"value":"0","active":true,"updates":2,"first_level":13638262},{"id":69977141,"key":{"nat":"64660","address":"tz1hLRwrB8Mrj6K3bGg8z5hz4VTpkSFCx1FS"},"value":"0","active":true,"updates":2,"first_level":13638169},{"id":69977139,"key":{"nat":"560247","address":"tz1X568Wdkb1ZUs8qfVYcsZD31YQ4UV3sdY4"},"value":"1","active":true,"updates":1,"first_level":13638155},{"id":69977096,"key":{"nat":"828132","address":"tz1QUxGGnrDSiYQfoyPTMpa3DFBdCR6o2Tuy"},"value":"1","active":true,"updates":1,"first_level":13638055},{"id":69977093,"key":{"nat":"881103","address":"KT1PHubm9HtyQEJ4BBpMTVomq6mhbfNZ9z5w"},"value":"1","active":true,"updates":1,"first_level":13638052},{"id":69977087,"key":{"nat":"881103","address":"tz1P5BmwDjpPgmwbwwQFnHMgmWvMq4pJaAYE"},"value":"0","active":true,"updates":2,"first_level":13638039}],"note":"The live key-value entries of one Tezos bigmap — the actual on-chain data, such as the address→balance rows of a token ledger or the owner rows of an NFT collection. Each row carries its decoded key and value. Omit ptr to use the largest bigmap.","count":25,"source":"TzKT"},"meta":{"timestamp":"2026-06-14T17:03:52.448Z","request_id":"f50e5ad8-f46a-4012-bacf-3121ae69633c"},"status":"ok","message":"Bigmap keys 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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"largest":"hic et nunc NFTs/ledger"},"source":"public TzKT indexer (api.tzkt.io), keyless","service":"tezosbigmaps-api","endpoints":{"GET /v1/keys":"A bigmap's live key-value entries (ptr; omit for the largest).","GET /v1/meta":"This document.","GET /v1/bigmap":"One bigmap's detail and typed key/value schema (ptr; omit for the largest).","GET /v1/bigmaps":"Browse/rank bigmaps by key count (limit)."},"description":"Read Tezos's on-chain key-value storage (bigmaps) live from the public TzKT indexer: browse and rank bigmaps by size, read one bigmap's detail and typed key/value schema, and page through its live key-value entries — the actual on-chain data such as token-ledger rows. The storage / data layer for Tezos explorers, indexers and token dashboards. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:03:52.572Z","request_id":"b721afcd-520e-40de-a43d-0ef1fb20f4bb"},"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":9000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":810,"monthly_call_quota":170000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":910000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":8550,"monthly_call_quota":5600000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tezosbigmaps-api"}