{"openapi":"3.1.0","info":{"title":"Tezos Smart Contract API","version":"1.0.0","description":"Browse Tezos smart contracts live from the public TzKT indexer — no key. On Tezos a smart contract is an originated KT1 account with Michelson code, on-chain storage and named entrypoints. The Tezos on-chain reader resolves a single address's account state, but it cannot browse the contract universe, rank contracts by balance or activity, read a contract's callable entrypoints, or read its code identity. This opens that. Browse and rank the deployed smart contracts with their KT1 address, XTZ balance, creator, lifetime transaction count and token activity; read one contract in full — its balance, creator, code/type hash (contracts sharing a code hash run identical Michelson) and current delegate; and read the named entrypoints a contract exposes — its callable interface, each method with its parameter schema. The contract layer for Tezos explorers, dApp dashboards, wallets and analytics. Distinct from the Tezos on-chain reader (per-address account state), the self-amending governance reader, the baker reader, 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/tezoscontracts-api","description":"oanor gateway"}],"tags":[{"name":"Contracts"},{"name":"Contract"},{"name":"Entrypoints"},{"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/contracts":{"get":{"operationId":"get_v1_contracts","tags":["Contracts"],"summary":"Browse/rank Tezos smart contracts","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 smart contracts (originated KT1 accounts) ranked by XTZ balance — each with its address, alias, balance, creator, lifetime transaction count and token activity. The discovery layer the per-address account reader can't give you. Paginate with limit; read one in /v1/contract, its interface in /v1/entrypoints.","count":25,"source":"TzKT","contracts":[{"address":"KT1CeFqjJRJPNVvhvznQrWfHad2jCiDZ6Lyj","creator":"tz1etHLky7fuVumvBDi92ogXQZZPESiFimWR","balance_xtz":15579954.372733,"tokens_count":0,"last_activity":"2026-06-14T17:02:16Z","first_activity":"2024-04-02T13:34:16Z","num_transactions":121385,"token_transfers_count":0},{"address":"KT1Rdn7gRZCgRYTCN5W3V878Rfqksahnx5zK","creator":"KT1CP1C8afHqdNfBsSE3ggQhzM2iMHd4cRyt","balance_xtz":11603641.834963,"tokens_count":0,"last_activity":"2026-06-09T14:29:10Z","first_activity":"2024-04-13T19:13:59Z","num_transactions":588,"token_transfers_count":0},{"alias":"Sirius DEX","address":"KT1TxqZ8QtKvLu3V3JH7Gx58n7Co8pgtpQU5","creator":"tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU","balance_xtz":6040917.686481,"tokens_count":0,"last_activity":"2026-06-14T15:04:46Z","first_activity":"2021-05-05T22:18:21Z","num_transactions":851605,"token_transfers_count":225846},{"address":"KT1EGHbTvZq7Lu6x6q6Hq7m6TD8DpEYKpUha","creator":"tz1Wf1K9qbqYUKvRRkwCFJ2DgoLesRCTkt2P","balance_xtz":3566660.634,"tokens_count":0,"last_activity":"2026-06-13T14:32:16Z","first_activity":"2021-06-02T06:56:02Z","num_transactions":2847,"token_transfers_count":0},{"address":"KT1MfgCNUdkNES1pBJ6uJVHyHZw79DjRZzw5","creator":"KT1Mgy95DVzqVBNYhsW93cyHuB57Q94UFhrh","balance_xtz":1785431,"tokens_count":0,"last_activity":"2026-06-06T04:25:10Z","first_activity":"2021-12-15T17:38:46Z","num_transactions":3925,"token_transfers_count":1},{"address":"KT1BjuSU32EnHWwD5wHPAH9xPnqrRKPmsMRW","creator":"KT1Mgy95DVzqVBNYhsW93cyHuB57Q94UFhrh","balance_xtz":928278,"tokens_count":0,"last_activity":"2026-03-27T18:38:31Z","first_activity":"2021-03-02T03:17:27Z","num_transactions":125,"token_transfers_count":0},{"address":"KT1PyVhKJpYGmQS9hoe2NxVdXeAFCDPW4w9J","creator":"tz1Mj7RzPmMAqDUNFBn5t5VbXmWW4cSUAdtT","balance_xtz":911085.449281,"tokens_count":0,"last_activity":"2026-03-27T15:05:13Z","first_activity":"2022-09-02T06:05:44Z","num_transactions":1352,"token_transfers_count":571},{"alias":"Kolibri Stability Fund","address":"KT1AvxXZ3dgnvmUuuv7vCNeDRmxcZaArhPBy","creator":"tz1hoversaMZ1p4ceUn9HGhnc2r4UYDKWQUN","balance_xtz":473159.814468,"tokens_count":0,"last_activity":"2026-06-10T14:29:52Z","first_activity":"2021-12-09T22:57:50Z","num_transactions":1884,"token_transfers_count":6148},{"address":"KT19dEWPemiL7iLqaWPzX9hMunvn2yM6p91M","creator":"tz2KK72Czsiwf2podiERQSXHEUNcBqwXNC32","balance_xtz":466002.949131,"tokens_count":0,"last_activity":"2026-06-14T12:14:40Z","first_activity":"2025-09-24T08:14:20Z","num_transactions":200,"token_transfers_count":0},{"address":"KT1WxiKVR9q3UxovXRpR8SRMQpv9tsZeQW2V","creator":"KT1TcCSR24TmDvwTfHkyWbwMB111gtNYxEcA","balance_xtz":368538.244701,"tokens_count":0,"last_activity":"2026-06-05T20:35:55Z","first_activity":"2024-05-06T13:17:21Z","num_transactions":1231,"token_transfers_count":0},{"address":"KT1EowsfjUeZmgBPgJa6NCcvHCrGUMmRPNy3","creator":"KT1DHndgk8ah1MLfciDnCV2zPJrVbnnAH9fd","balance_xtz":352947.5981,"tokens_count":0,"last_activity":"2026-06-10T12:24:10Z","first_activity":"2026-03-30T06:09:19Z","num_transactions":56,"token_transfers_count":0},{"address":"KT1KW47EwCqsE5C2gwdyo13cVonf3RooU7Lz","creator":"KT1TcCSR24TmDvwTfHkyWbwMB111gtNYxEcA","balance_xtz":294063.955929,"tokens_count":0,"last_activity":"2026-06-13T21:30:01Z","first_activity":"2024-04-06T17:43:11Z","num_transactions":1278,"token_transfers_count":0},{"address":"KT1SwbTqhSKF6Pdokiu1K4Fpi17ahPPzmt1X","creator":"tz1TWrPXuG3T3rR9NR5EqsBegJMwiMcobjkt","balance_xtz":234171.273018,"tokens_count":0,"last_activity":"2026-06-14T17:02:52Z","first_activity":"2024-11-05T16:32:15Z","num_transactions":3567893,"token_transfers_count":4},{"address":"KT1A7mVmLLZBjuNSUhNM4oNbRN6TK6JM8cba","creator":"tz2BaRc3m7swRBKRERafFptR4BN7ijFoRirL","balance_xtz":211930.780788,"tokens_count":0,"last_activity":"2026-06-12T11:53:46Z","first_activity":"2022-03-10T11:42:34Z","num_transactions":4048,"token_transfers_count":1},{"alias":"XTZ/YOU CPMM youves","address":"KT1XFnhsV8Yd5FaaZY4ktR7Qt8fBMdxgZ6qh","creator":"tz1YY1LvD6TFH4z74pvxPQXBjAKHE5tB5Q8f","balance_xtz":188542.359758,"tokens_count":0,"last_activity":"2026-06-14T16:54:10Z","first_activity":"2024-09-17T09:28:30Z","num_transactions":132638,"token_transfers_count":23660},{"address":"KT1LKY5ex9vqzWDkRTnFjLoQkwvufYzwpKw5","creator":"KT1TcCSR24TmDvwTfHkyWbwMB111gtNYxEcA","balance_xtz":187294.681421,"tokens_count":0,"last_activity":"2026-06-13T22:34:37Z","first_activity":"2025-07-22T11:34:08Z","num_transactions":183,"token_transfers_count":0},{"address":"KT1FZ6YemJgtYbzVXToharnmRLnqC5pqiB99","creator":"KT1DHndgk8ah1MLfciDnCV2zPJrVbnnAH9fd","balance_xtz":152493.43712,"tokens_count":0,"last_activity":"2026-06-10T22:23:52Z","first_activity":"2022-09-29T17:46:14Z","num_transactions":2288,"token_transfers_count":0},{"address":"KT1CMvz1pBQBUnHxhwrSccuPjgvBhgCtBpt4","creator":"KT1Mgy95DVzqVBNYhsW93cyHuB57Q94UFhrh","balance_xtz":150601.839571,"tokens_count":0,"last_activity":"2026-06-11T11:19:19Z","first_activity":"2021-03-07T04:07:49Z","num_transactions":2416,"token_transfers_count":1},{"address":"KT1LKSuhpbqhfgTh162DH9qJgBbHRQiq8row","creator":"KT1Mgy95DVzqVBNYhsW93cyHuB57Q94UFhrh","balance_xtz":147872.907353,"tokens_count":0,"last_activity":"2026-06-13T22:07:49Z","first_activity":"2026-04-03T11:20:22Z","num_transactions":333,"token_transfers_count":0},{"alias":"Tezos Domains Treasury","address":"KT1BzeXvLtPR83aj5FHemXmia6DmdXkeV3Uk","creator":"tz1hVdCU65CGZrqMkZ2v5YA826DSkQTbv5uh","balance_xtz":141679.689345,"tokens_count":0,"last_activity":"2026-06-14T14:41:58Z","first_activity":"2023-12-31T14:52:51Z","num_transactions":27085,"token_transfers_count":4},{"address":"KT1VQ5TEVgwSPLUPioMRfmtSqA2B515pP3AS","creator":"tz2KrVWh7Pji8kp71pscoCXfbJq1abctc7ok","balance_xtz":130256.918296,"tokens_count":0,"last_activity":"2026-06-14T14:42:04Z","first_activity":"2023-05-30T19:02:57Z","num_transactions":579653,"token_transfers_count":364567},{"alias":"objkt.com Marketplace v2","address":"KT1WvzYHCNBvDSdwafTHv7nJ1dWmZ8GCYuuC","creator":"tz1TWrPXuG3T3rR9NR5EqsBegJMwiMcobjkt","balance_xtz":108226.678338,"tokens_count":0,"last_activity":"2026-06-14T16:57:46Z","first_activity":"2022-02-09T14:55:44Z","num_transactions":21866733,"token_transfers_count":39},{"address":"KT1XsC1D6FgkGPXNSU67J5hBRt9XqLkPpD6b","creator":"tz1hD63wN8p9V8o5ARU7wA7RKAQvBAwkeTr7","balance_xtz":103939.92615,"tokens_count":0,"last_activity":"2026-06-14T14:36:04Z","first_activity":"2025-02-27T04:18:32Z","num_transactions":49356,"token_transfers_count":0},{"alias":"FXHASH Marketplace v2","address":"KT1GbyoDi7H1sfXmimXpptZJuCdHMh66WS9u","creator":"tz1fepn7jZsCYBqCDhpM63hzh9g2Ytqk4Tpv","balance_xtz":99844.034757,"tokens_count":0,"last_activity":"2026-06-14T15:47:52Z","first_activity":"2022-04-14T15:37:59Z","num_transactions":5884844,"token_transfers_count":2040675},{"address":"KT1A7WfHGsH4iUtjE8cTwWRDGNzLGLbesPCp","creator":"KT1Mgy95DVzqVBNYhsW93cyHuB57Q94UFhrh","balance_xtz":83649.385079,"tokens_count":0,"last_activity":"2026-06-10T00:26:40Z","first_activity":"2021-07-17T04:37:38Z","num_transactions":725,"token_transfers_count":1}]},"meta":{"timestamp":"2026-06-14T17:03:52.883Z","request_id":"608d2349-18c8-4f26-984e-51063db04fa7"},"status":"ok","message":"Contracts 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/contract":{"get":{"operationId":"get_v1_contract","tags":["Contract"],"summary":"One contract in full","description":"","parameters":[{"name":"address","in":"query","required":false,"description":"Contract address (KT1...); omit for the highest-balance","schema":{"type":"string"},"example":"KT1CeFqjJRJPNVvhvznQrWfHad2jCiDZ6Lyj"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"One Tezos smart contract in full: its XTZ balance, creator, lifetime transaction and token activity, code/type hash (contracts sharing a code hash run identical Michelson) and current delegate. Omit address to use the highest-balance contract.","source":"TzKT","address":"KT1CeFqjJRJPNVvhvznQrWfHad2jCiDZ6Lyj","creator":"tz1etHLky7fuVumvBDi92ogXQZZPESiFimWR","code_hash":252039085,"type_hash":738638697,"balance_xtz":15579954.372733,"tokens_count":0,"last_activity":"2026-06-14T17:02:16Z","first_activity":"2024-04-02T13:34:16Z","num_originations":1,"num_transactions":121385,"active_tokens_count":0,"token_transfers_count":0},"meta":{"timestamp":"2026-06-14T17:03:52.986Z","request_id":"74c356b5-4bd0-4cfc-85e1-cea13979c072"},"status":"ok","message":"Contract 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/entrypoints":{"get":{"operationId":"get_v1_entrypoints","tags":["Entrypoints"],"summary":"A contract's named entrypoints","description":"","parameters":[{"name":"address","in":"query","required":false,"description":"Contract address (KT1...); omit for the highest-balance","schema":{"type":"string"},"example":"KT1CeFqjJRJPNVvhvznQrWfHad2jCiDZ6Lyj"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The named entrypoints a Tezos contract exposes — its callable interface. Each entrypoint is a method (e.g. transfer, mint, burn) with its parameter schema. This is how a wallet or dApp knows what calls a contract accepts. Omit address to use the highest-balance contract.","count":2,"source":"TzKT","address":"KT1CeFqjJRJPNVvhvznQrWfHad2jCiDZ6Lyj","entrypoints":[{"name":"burn","unused":false,"parameters":{"schema:object":{"ticket:ticket":{"amount:nat":"nat","content:object":{"nat:nat":"nat","bytes:?bytes":"bytes"},"address:address":"address"},"address:address":"address"}}},{"name":"mint","unused":false,"parameters":{"schema:address":"address"}}]},"meta":{"timestamp":"2026-06-14T17:03:53.085Z","request_id":"fd666632-a235-43eb-ba2b-7c0be34ac083"},"status":"ok","message":"Entrypoints 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":{"top_contract":"KT1CeFqjJRJPNVvhvznQrWfHad2jCiDZ6Lyj"},"source":"public TzKT indexer (api.tzkt.io), keyless","service":"tezoscontracts-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/contract":"One contract in full: balance, creator, code hash, activity (address; omit for the top).","GET /v1/contracts":"Browse/rank smart contracts by balance (limit).","GET /v1/entrypoints":"A contract's named entrypoints / callable interface (address; omit for the top)."},"description":"Browse Tezos smart contracts live from the public TzKT indexer: rank originated KT1 contracts by balance and activity, read one contract in full (balance, creator, code hash, token activity), and read a contract's named entrypoints (its callable interface). The contract layer for Tezos explorers, dApp dashboards and analytics. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:03:53.331Z","request_id":"6e1855c5-0593-4749-bd8e-78c53edc4d51"},"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":8800,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":850,"monthly_call_quota":166000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2960,"monthly_call_quota":870000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":8400,"monthly_call_quota":5350000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tezoscontracts-api"}