{"openapi":"3.1.0","info":{"title":"Nano Representatives & Consensus API","version":"1.0.0","description":"Nano's Open Representative Voting (ORV) consensus — the representative layer — live from the public Nano RPC, no key, nothing cached. Nano has no miners and no staking rewards: every account delegates its balance as voting weight to a representative, and online representatives vote to confirm transactions, with a quorum threshold securing the network. The base Nano reader covers accounts, blocks and history, but not the representative layer; this opens it. Rank the online representatives by delegated voting weight (in NANO), each with its share of total online stake and whether it clears the 0.1%-of-online-stake principal-representative threshold that earns a vote in consensus. Look up a single representative by address for its weight, stake share, principal status and whether it is currently online and voting. And read the live confirmation quorum — the total online voting stake, the trended and peer stake, the quorum delta and percentage, and the minimum weight a representative needs to count. The consensus-and-voting layer for Nano wallets, representative dashboards, delegators and analytics. Live from rpc.nano.to and peer nodes.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nanoreps-api","description":"oanor gateway"}],"tags":[{"name":"Representatives"},{"name":"Consensus"},{"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/representative":{"get":{"operationId":"get_v1_representative","tags":["Representatives"],"summary":"One representative: weight, share, principal & online status","description":"","parameters":[{"name":"account","in":"query","required":false,"description":"Nano address (omit for the top representative)","schema":{"type":"string"},"example":"nano_3rw4un6ys57hrb39sy1qx8qy5wukst1iiponztrz9qiz6qqa55kxzx4491or"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A single Nano representative's delegated voting weight (in NANO), its share of online stake, whether it is a principal representative and whether it is currently online and voting. Omit account for the top online representative.","source":"Nano RPC","account":"nano_3rw4un6ys57hrb39sy1qx8qy5wukst1iiponztrz9qiz6qqa55kxzx4491or","is_online":true,"weight_pct":1.8042,"weight_nano":1572962.75,"is_principal":true},"meta":{"timestamp":"2026-06-14T17:04:36.128Z","request_id":"ac2c8c45-6a25-4571-914d-1a87ac663635"},"status":"ok","message":"Representative 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/representatives":{"get":{"operationId":"get_v1_representatives","tags":["Representatives"],"summary":"Online representatives ranked by voting weight, with stake share","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max representatives (1-200)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Online Nano representatives ranked by delegated voting weight (in NANO). weight_pct is the share of total online voting stake; is_principal flags representatives above the 0.1%-of-online-stake threshold that earns a vote in consensus.","count":30,"source":"Nano RPC","online_count":75,"representatives":[{"account":"nano_37imps4zk1dfahkqweqa91xpysacb7scqxf3jqhktepeofcxqnpx531b3mnt","weight_pct":27.7117,"weight_nano":24160266.75,"is_principal":true},{"account":"nano_1natrium1o3z5519ifou7xii8crpxpk8y65qmkih8e8bpsjri651oza8imdd","weight_pct":9.1839,"weight_nano":8006935.87,"is_principal":true},{"account":"nano_1wcxcjbwnnsdpee3d9i365e8bcj1uuyoqg9he5zjpt3r57dnjqe3gdc184ck","weight_pct":6.2384,"weight_nano":5438931.29,"is_principal":true},{"account":"nano_14j1gqkn8pekpsapqd8c3kciapphaysf6mgw1spsojzzr6qrtskd9dxtopo7","weight_pct":3.874,"weight_nano":3377539.79,"is_principal":true},{"account":"nano_1anrzcuwe64rwxzcco8dkhpyxpi8kd7zsjc1oeimpc3ppca4mrjtwnqposrs","weight_pct":3.4827,"weight_nano":3036378.47,"is_principal":true},{"account":"nano_3pczxuorp48td8645bs3m6c3xotxd3idskrenmi65rbrga5zmkemzhwkaznh","weight_pct":3.2344,"weight_nano":2819892.35,"is_principal":true},{"account":"nano_3arg3asgtigae3xckabaaewkx3bzsh7nwz7jkmjos79ihyaxwphhm6qgjps4","weight_pct":3.0929,"weight_nano":2696509.04,"is_principal":true},{"account":"nano_3jwrszth46rk1mu7rmb4rhm54us8yg1gw3ipodftqtikf5yqdyr7471nsg1k","weight_pct":2.9323,"weight_nano":2556535.39,"is_principal":true},{"account":"nano_3msc38fyn67pgio16dj586pdrceahtn75qgnx7fy19wscixrc8dbb3abhbw6","weight_pct":2.4261,"weight_nano":2115146.05,"is_principal":true},{"account":"nano_1wenanoqm7xbypou7x3nue1isaeddamjdnc3z99tekjbfezdbq8fmb659o7t","weight_pct":2.2615,"weight_nano":1971661.04,"is_principal":true},{"account":"nano_1tk8h3yzkibbsti8upkfa69wqafz6mzfzgu8bu5edaay9k7hidqdunpr4tb6","weight_pct":2.1402,"weight_nano":1865904.39,"is_principal":true},{"account":"nano_3chartsi6ja8ay1qq9xg3xegqnbg1qx76nouw6jedyb8wx3r4wu94rxap7hg","weight_pct":2.062,"weight_nano":1797749.85,"is_principal":true},{"account":"nano_3rw4un6ys57hrb39sy1qx8qy5wukst1iiponztrz9qiz6qqa55kxzx4491or","weight_pct":1.8042,"weight_nano":1572962.75,"is_principal":true},{"account":"nano_1zuksmn4e8tjw1ch8m8fbrwy5459bx8645o9euj699rs13qy6ysjhrewioey","weight_pct":1.4891,"weight_nano":1298269.75,"is_principal":true},{"account":"nano_3patrick68y5btibaujyu7zokw7ctu4onikarddphra6qt688xzrszcg4yuo","weight_pct":1.4322,"weight_nano":1248642.87,"is_principal":true},{"account":"nano_3g6ue89jij6bxaz3hodne1c7gzgw77xawpdz4p38siu145u3u17c46or4jeu","weight_pct":1.4022,"weight_nano":1222502.4,"is_principal":true},{"account":"nano_318uu1tsbios3kp4dts5b6zy1y49uyb88jajfjyxwmozht8unaxeb43keork","weight_pct":1.3672,"weight_nano":1191985.73,"is_principal":true},{"account":"nano_3pg8khw8gs94c1qeq9741n99ubrut8sj3n9kpntim1rm35h4wdzirofazmwt","weight_pct":1.2804,"weight_nano":1116324.61,"is_principal":true},{"account":"nano_1iuz18n4g4wfp9gf7p1s8qkygxw7wx9qfjq6a9aq68uyrdnningdcjontgar","weight_pct":1.2633,"weight_nano":1101430.85,"is_principal":true},{"account":"nano_1jtx5p8141zjtukz4msp1x93st7nh475f74odj8673qqm96xczmtcnanos1o","weight_pct":1.1292,"weight_nano":984469.96,"is_principal":true},{"account":"nano_3o7uzba8b9e1wqu5ziwpruteyrs3scyqr761x7ke6w1xctohxfh5du75qgaj","weight_pct":1.0775,"weight_nano":939443.64,"is_principal":true},{"account":"nano_3dmtrrws3pocycmbqwawk6xs7446qxa36fcncush4s1pejk16ksbmakis78m","weight_pct":0.8553,"weight_nano":745714.71,"is_principal":true},{"account":"nano_3ktybzzy14zxgb6osbhcc155pwk7osbmf5gbh5fo73bsfu9wuiz54t1uozi1","weight_pct":0.8401,"weight_nano":732402.28,"is_principal":true},{"account":"nano_35btiz1mgfwp95c3ckazmzbp5gepduxtijuijd9xebeau8u1gsbea41smjca","weight_pct":0.8059,"weight_nano":702623.88,"is_principal":true},{"account":"nano_33ad5app7jeo6jfe9ure6zsj8yg7knt6c1zrr5yg79ktfzk5ouhmpn6p5d7p","weight_pct":0.7283,"weight_nano":634965.92,"is_principal":true},{"account":"nano_15nt4cis8ac184q9mj7bedww9ay9zh5jk5k7sj9ypmz44twjcpz3cn6oijir","weight_pct":0.7271,"weight_nano":633947.76,"is_principal":true},{"account":"nano_34amtofxstsfyqcgphp8piij9u33widykq9wbz6ysjpxhbgmqu8btu1eexer","weight_pct":0.6888,"weight_nano":600531.42,"is_principal":true},{"account":"nano_1hza3f7wiiqa7ig3jczyxj5yo86yegcmqk3criaz838j91sxcckpfhbhhra1","weight_pct":0.6814,"weight_nano":594060.49,"is_principal":true},{"account":"nano_1awsn43we17c1oshdru4azeqjz9wii41dy8npubm4rg11so7dx3jtqgoeahy","weight_pct":0.6565,"weight_nano":572384.9,"is_principal":true},{"account":"nano_1banexkcfuieufzxksfrxqf6xy8e57ry1zdtq9yn7jntzhpwu4pg4hajojmq","weight_pct":0.6433,"weight_nano":560890.57,"is_principal":true}],"online_stake_nano":87184293.54},"meta":{"timestamp":"2026-06-14T17:04:36.246Z","request_id":"596f0601-5c75-4e73-b3ed-662fdea55b35"},"status":"ok","message":"Representatives 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/quorum":{"get":{"operationId":"get_v1_quorum","tags":["Consensus"],"summary":"Live confirmation quorum: online stake, quorum delta & percentage, minimum weight","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live Nano confirmation quorum: the total online voting stake, the trended and peer stake, the quorum delta (weight needed to confirm), the quorum percentage and the minimum weight a representative needs to count. This is the health of ORV consensus.","source":"Nano RPC","quorum_delta_nano":58413476.67,"peers_stake_total_nano":87008339.23,"online_stake_total_nano":87184293.54,"trended_stake_total_nano":86957655.44,"online_weight_minimum_nano":60000000,"online_weight_quorum_percent":67},"meta":{"timestamp":"2026-06-14T17:04:36.347Z","request_id":"3008a518-1069-4334-82c6-702a16a01351"},"status":"ok","message":"Quorum 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":{"online_reps":75,"top_weight_nano":24160266.75},"source":"public Nano RPC (rpc.nano.to and peers), keyless","service":"nanoreps-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/quorum":"Live confirmation quorum: online stake, quorum delta & percentage, minimum weight.","GET /v1/representative":"One representative's weight, share, principal & online status (account; omit for top).","GET /v1/representatives":"Online representatives ranked by voting weight, with stake share (limit)."},"description":"Read Nano's Open Representative Voting (ORV) consensus live from the public Nano RPC: rank online representatives by delegated voting weight (in NANO) with their share of online stake and principal-representative status; look up a single representative's weight by address; and read the live confirmation quorum (online stake, quorum delta and percentage, minimum weight). The consensus-and-voting layer for Nano wallets, representative dashboards and delegators. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:04:36.431Z","request_id":"c52e83e0-76f8-44e9-be44-e96e583a1bee"},"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":7150,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":890,"monthly_call_quota":129000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3450,"monthly_call_quota":792000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9250,"monthly_call_quota":4880000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nanoreps-api"}