{"openapi":"3.1.0","info":{"title":"Nano API","version":"1.0.0","description":"Live on-chain data from the Nano network (XNO), a feeless, instant cryptocurrency with a block-lattice architecture where every account has its own blockchain and consensus is reached by Open Representative Voting (ORV): an account's confirmed XNO balance, receivable balance, block count and delegated representative; an account's own chain of blocks; a single block's amount, balance, height and confirmation; and the network's total, cemented and unchecked block counts plus the online voting weight securing it.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nano-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Account"},{"name":"Block"},{"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live Nano block counts and online ORV voting weight","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"nano","source":"Nano","feeless":true,"consensus":"Open Representative Voting (ORV)","native_token":"XNO","total_blocks":220091712,"cemented_blocks":220091712,"unchecked_blocks":2286,"peers_stake_total_nano":86766181.53094324,"online_stake_total_nano":86938967.62229627,"online_weight_minimum_nano":60000000,"online_weight_quorum_percent":67},"meta":{"timestamp":"2026-06-10T13:59:45.068Z","request_id":"e84b78c1-6f04-428f-9bd1-2444f6903659"},"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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"An account XNO balance, receivable and representative","description":"","parameters":[{"name":"account","in":"query","required":true,"description":"Nano account (nano_...)","schema":{"type":"string"},"example":"nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Nano","account":"nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg","frontier":"44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279","modified":"2021-02-22T22:55:19.000Z","balance_raw":"437022401290003970326450322946","block_count":52,"balance_nano":0.4370224,"representative":"nano_1anrzcuwe64rwxzcco8dkhpyxpi8kd7zsjc1oeimpc3ppca4mrjtwnqposrs","receivable_nano":1.0e-5},"meta":{"timestamp":"2026-06-10T13:59:45.360Z","request_id":"38929330-8656-45ac-9a11-3cf29b59ed5f"},"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/history":{"get":{"operationId":"get_v1_history","tags":["Account"],"summary":"An account own chain of blocks (block-lattice)","description":"","parameters":[{"name":"account","in":"query","required":true,"description":"Nano account (nano_...)","schema":{"type":"string"},"example":"nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg"},{"name":"count","in":"query","required":false,"description":"Number of blocks (1-50)","schema":{"type":"string"},"example":"15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":15,"source":"Nano","account":"nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg","history":[{"hash":"44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279","time":"2021-02-22T22:55:19.000Z","type":"send","height":52,"confirmed":true,"amount_nano":1,"counterparty":"nano_3j834c8c83qtejze6wagothgjj7oq9p1dewgbpycy7dcq1ux1tb7qspinyx5"},{"hash":"DBC054BDCAB0C30980A06A5F698AD4F9001607E4480B37880D53E7DDF043D962","time":"2021-02-22T22:55:19.000Z","type":"receive","height":51,"confirmed":true,"amount_nano":1.3886,"counterparty":"nano_17oc98sqccfqqfah8jggkziu8i6ar8biq7syxqcd6e1sagje11gts88gfj95"},{"hash":"27358427EE3E8AE5612BA12070CBAA4FD72994ED085DDC0397CE98AFC4FBE161","time":"2019-12-17T20:06:00.000Z","type":"receive","height":49,"confirmed":true,"amount_nano":0,"counterparty":"nano_35qbo76yw138whnqmtbascunw3ooqfa1zgofz75cw65ikxa9ibyxoz36bx8t"},{"hash":"A4ADA0C72F40BD51AABCA716EDE673EF70BF1E2853E3F320A1E74A73824996ED","time":"2019-12-17T20:05:58.000Z","type":"receive","height":48,"confirmed":true,"amount_nano":0,"counterparty":"nano_1o953as4bq4yeh5e4d48meiyhgxzi6qdusb87dawfdyd1qm655x4g5rk8di8"},{"hash":"2DE0A27C3C7DE24692B09D9E4E5E27548077BD673DC3799DC6080746AF986A83","time":"2019-12-09T18:14:30.000Z","type":"receive","height":47,"confirmed":true,"amount_nano":0.004,"counterparty":"nano_3g3i5r8nge4g4bpq63977jsqpno1u7faojkd1u53mm8osqhm8xzyct7puwfz"},{"hash":"397EF2011D4A225BAB89E48118FE4FD3FD1429F73F08FD15CE6CC3D0C98A31EF","time":"2019-12-09T18:14:30.000Z","type":"receive","height":46,"confirmed":true,"amount_nano":0.00102455,"counterparty":"nano_34prihdxwz3u4ps8qjnn14p7ujyewkoxkwyxm3u665it8rg5rdqw84qrypzk"},{"hash":"020A26E8094BD8213E2B5E196A242D8BAB05A8F667952A7B48E2CA4AC1DF0278","time":"2019-12-09T18:14:21.000Z","type":"receive","height":45,"confirmed":true,"amount_nano":0.00104332,"counterparty":"nano_3x7cjioqahgs5ppheys6prpqtb4rdknked83chf97bot1unrbdkaux37t31b"},{"hash":"1C277C20843C174BA5673FA87A8CCD494A8331FF2FAB4920B7BB5427A1E939BC","time":"2019-12-09T18:13:40.000Z","type":"receive","height":44,"confirmed":true,"amount_nano":0.00077366,"counterparty":"nano_3crauakkxnew39w9q381w7yxhtee71yyrj59rowwexmhukmjmiikrtgeqfsa"},{"hash":"2921BD85AB74904AFA667F3B409CF97C7C7BE8FB4C38FBD7691D01D7057D0B03","time":"2019-12-09T18:13:40.000Z","type":"receive","height":43,"confirmed":true,"amount_nano":0.00134129,"counterparty":"nano_18jsbi6qgbi3eqq8q1utuzwurnuz476yehxnwxxeckm54gpcm9g5wokmj897"},{"hash":"45C94011938A5CC817D21338BF06302060322A4AA0DEE9E07D77567C432A26F3","time":"2019-12-09T18:12:12.000Z","type":"receive","height":42,"confirmed":true,"amount_nano":0.00038475,"counterparty":"nano_18jsbi6qgbi3eqq8q1utuzwurnuz476yehxnwxxeckm54gpcm9g5wokmj897"},{"hash":"B75D1B1E3F34B05B91D4637125173A6A31F248D4131C9F69F93738D3588558F4","time":"2019-12-09T18:11:50.000Z","type":"receive","height":41,"confirmed":true,"amount_nano":1.0e-5,"counterparty":"nano_1d1gd38o54fy44ifspd3axrfjcmr8uudgpw8coejorsq7ygjhdmt7r71ackd"},{"hash":"95251ECE84E8AAC9837B05A585BC1460E78B3A92DD517C3E702EFEF3C544F8BA","time":"2019-12-09T18:11:50.000Z","type":"receive","height":40,"confirmed":true,"amount_nano":0.001,"counterparty":"nano_1d1gd38o54fy44ifspd3axrfjcmr8uudgpw8coejorsq7ygjhdmt7r71ackd"},{"hash":"6058C8DCA30499EFE9DC736C7227C18FC2583F55907BA75A8B88273D75245DDC","time":"2019-12-09T18:11:50.000Z","type":"receive","height":39,"confirmed":true,"amount_nano":1.0e-5,"counterparty":"nano_1uua66gesfuwm7pbsw6u95em7957jfegxsghpxp7w67wjyurowegdswamd1d"},{"hash":"5DCA56F3BC602D7C5F197BA7D483F47A2DA1C526171C9B258BC2B7C903CE7BBD","time":"2019-12-09T18:11:49.000Z","type":"receive","height":38,"confirmed":true,"amount_nano":0.01,"counterparty":"nano_1jscbqmj5enjg353a15qj9pism6we5q31d7hu8gxjik6exgkekmucntu7wum"},{"hash":"24BB8A130942EDE303BCBCDCFED8600923250839BD02B4C72FEA362E31E99941","time":"2019-12-09T18:10:56.000Z","type":"receive","height":37,"confirmed":true,"amount_nano":1.0e-5,"counterparty":"nano_16n59xd5ga1gpd3856kgsktafjkoedzzwqrb8eknhxfwab47rc3uoxjcpnzg"}]},"meta":{"timestamp":"2026-06-10T13:59:46.048Z","request_id":"c9350f1b-9a11-42af-ae29-720c6b4e147a"},"status":"ok","message":"History 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/block":{"get":{"operationId":"get_v1_block","tags":["Block"],"summary":"A single block amount, balance and confirmation","description":"","parameters":[{"name":"hash","in":"query","required":true,"description":"Block hash (64 hex)","schema":{"type":"string"},"example":"44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hash":"44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279","link":"C4C1128CA306FA647EC2710EAE9EE8C4B5B9EC05B38E4DBCAF156AB837D06925","time":"2021-02-22T22:55:19.000Z","type":"state","height":52,"source":"Nano","account":"nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg","subtype":"send","confirmed":true,"amount_nano":1,"balance_nano":0.4370224,"representative":"nano_1anrzcuwe64rwxzcco8dkhpyxpi8kd7zsjc1oeimpc3ppca4mrjtwnqposrs"},"meta":{"timestamp":"2026-06-10T13:59:46.294Z","request_id":"084776bd-4618-4e79-97ba-ad595d9adb8e"},"status":"ok","message":"Block 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 and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Nano RPC via a public node (rpc.nano.to, live)","service":"nano-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/block":"A single block's amount, balance and confirmation (hash=64 hex).","GET /v1/account":"An account's XNO balance, receivable and representative (account=nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg).","GET /v1/history":"An account's own chain of blocks (account=nano_…, count=15).","GET /v1/network":"Block counts and online ORV voting weight."},"description":"Live on-chain data from the Nano network (XNO), a feeless, instant cryptocurrency with a block-lattice architecture where every account has its own blockchain and consensus is reached by Open Representative Voting (ORV), via a public Nano RPC node. The account endpoint returns an account's confirmed XNO balance, receivable balance, block count and delegated representative; the history endpoint returns an account's own chain of blocks; the block endpoint returns a single block's amount, balance, height and confirmation; the network endpoint returns the total, cemented and unchecked block counts and the online voting weight securing the network. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, EOS, Internet Computer and EVM on-chain APIs and from price feeds — this is Nano's own block-lattice account chains and ORV voting weight.","total_blocks":220091712,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T13:59:46.554Z","request_id":"9a38d171-6aa1-4d4a-8e96-d0349bbf4a72"},"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":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":135000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2100,"monthly_call_quota":880000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5500,"monthly_call_quota":4620000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nano-api"}