{"openapi":"3.1.0","info":{"title":"Internet Computer API","version":"1.0.0","description":"Live on-chain data from the Internet Computer (ICP), a blockchain that runs software as tamper-proof canisters on a network of independent subnets: the live network state (block height, running and stopped canisters, node count, number of subnets, message-execution rate), a ledger account's ICP balance and transaction count, a canister's type, controllers, name and subnet, and the subnets that shard the Internet Computer with their type, canisters, nodes and throughput.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/icp-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Account"},{"name":"Canister"},{"name":"Subnets"},{"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 IC state: block height, canisters, nodes, subnets","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"internet-computer","source":"Internet Computer","subnets":58,"up_nodes":683,"total_nodes":712,"block_height":8307257176,"native_token":"ICP","running_canisters":1152617,"stopped_canisters":102795,"message_execution_rate":616994269.26},"meta":{"timestamp":"2026-06-10T13:59:49.784Z","request_id":"fe18a72b-9001-4941-97c3-4a7956b151d2"},"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":"A ledger account ICP balance and transaction count","description":"","parameters":[{"name":"account","in":"query","required":true,"description":"ICP account identifier (64 hex)","schema":{"type":"string"},"example":"e7a879ea563d273c46dd28c1584eaa132fad6f3e316615b3eb657d067f3519b5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Internet Computer","account":"e7a879ea563d273c46dd28c1584eaa132fad6f3e316615b3eb657d067f3519b5","suspicious":false,"updated_at":"2025-05-06T03:27:44.000Z","balance_e8s":12000010000,"balance_icp":120.0001,"transaction_count":212647},"meta":{"timestamp":"2026-06-10T13:59:50.323Z","request_id":"798254fd-e1b6-42c4-bd9d-497ac5a96751"},"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/canister":{"get":{"operationId":"get_v1_canister","tags":["Canister"],"summary":"A canister type, controllers, name and subnet","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Canister id (principal)","schema":{"type":"string"},"example":"ryjl3-tyaaa-aaaaa-aaaba-cai"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"ICP Ledger","source":"Internet Computer","subnet_id":"tdb26-jop6k-aogll-7ltgs-eruif-6kk7m-qpktf-gdiqx-mxtrf-vb5e6-eqe","canister_id":"ryjl3-tyaaa-aaaaa-aaaba-cai","controllers":["r7inp-6aaaa-aaaaa-aaabq-cai"],"module_hash":"51f4be010f23064137defacd627ffbec024c5133210c68ca3b80ab8f257101d6","canister_type":"ledger"},"meta":{"timestamp":"2026-06-10T13:59:50.612Z","request_id":"a703531e-093d-46ca-833b-e965e9403b86"},"status":"ok","message":"Canister 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/subnets":{"get":{"operationId":"get_v1_subnets","tags":["Subnets"],"summary":"The subnets that shard the Internet Computer","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of subnets (1-100)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":49,"source":"Internet Computer","subnets":[{"type":"verified_application","subnet_id":"eq6en-6jqla-fbu5s-daskr-h6hx2-376n5-iqabl-qgrng-gfqmv-n3yjr-mqe","total_nodes":13,"running_canisters":93273,"memory_usage_bytes":513213972677,"message_execution_rate":38},{"type":"application","subnet_id":"2fq7c-slacv-26cgz-vzbx2-2jrcs-5edph-i5s2j-tck77-c3rlz-iobzx-mqe","total_nodes":13,"running_canisters":92713,"memory_usage_bytes":575589074005,"message_execution_rate":134},{"type":"verified_application","subnet_id":"4zbus-z2bmt-ilreg-xakz4-6tyre-hsqj4-slb4g-zjwqo-snjcc-iqphi-3qe","total_nodes":13,"running_canisters":72735,"memory_usage_bytes":441010287176,"message_execution_rate":36},{"type":"application","subnet_id":"o3ow2-2ipam-6fcjo-3j5vt-fzbge-2g7my-5fz2m-p4o2t-dwlc4-gt2q7-5ae","total_nodes":13,"running_canisters":63409,"memory_usage_bytes":198029847089,"message_execution_rate":16},{"type":"application","subnet_id":"mpubz-g52jc-grhjo-5oze5-qcj74-sex34-omprz-ivnsm-qvvhr-rfzpv-vae","total_nodes":13,"running_canisters":61844,"memory_usage_bytes":307779410644,"message_execution_rate":34},{"type":"application","subnet_id":"qdvhd-os4o2-zzrdw-xrcv4-gljou-eztdp-bj326-e6jgr-tkhuc-ql6v2-yqe","total_nodes":13,"running_canisters":59300,"memory_usage_bytes":276017034268,"message_execution_rate":82},{"type":"application","subnet_id":"cv73p-6v7zi-u67oy-7jc3h-qspsz-g5lrj-4fn7k-xrax3-thek2-sl46v-jae","total_nodes":13,"running_canisters":57613,"memory_usage_bytes":270031065384,"message_execution_rate":243},{"type":"application","subnet_id":"opn46-zyspe-hhmyp-4zu6u-7sbrh-dok77-m7dch-im62f-vyimr-a3n2c-4ae","total_nodes":13,"running_canisters":46429,"memory_usage_bytes":331188035798,"message_execution_rate":127},{"type":"application","subnet_id":"lspz2-jx4pu-k3e7p-znm7j-q4yum-ork6e-6w4q6-pijwq-znehu-4jabe-kqe","total_nodes":13,"running_canisters":46152,"memory_usage_bytes":242415299900,"message_execution_rate":25},{"type":"application","subnet_id":"e66qm-3cydn-nkf4i-ml4rb-4ro6o-srm5s-x5hwq-hnprz-3meqp-s7vks-5qe","total_nodes":13,"running_canisters":41671,"memory_usage_bytes":223125103943,"message_execution_rate":1209},{"type":"application","subnet_id":"brlsh-zidhj-3yy3e-6vqbz-7xnih-xeq2l-as5oc-g32c4-i5pdn-2wwof-oae","total_nodes":13,"running_canisters":41147,"memory_usage_bytes":560806970873,"message_execution_rate":39},{"type":"application","subnet_id":"gmq5v-hbozq-uui6y-o55wc-ihop3-562wb-3qspg-nnijg-npqp5-he3cj-3ae","total_nodes":13,"running_canisters":40198,"memory_usage_bytes":297751636140,"message_execution_rate":128},{"type":"application","subnet_id":"pjljw-kztyl-46ud4-ofrj6-nzkhm-3n4nt-wi3jt-ypmav-ijqkt-gjf66-uae","total_nodes":13,"running_canisters":38645,"memory_usage_bytes":247309705452,"message_execution_rate":58},{"type":"application","subnet_id":"nl6hn-ja4yw-wvmpy-3z2jx-ymc34-pisx3-3cp5z-3oj4a-qzzny-jbsv3-4qe","total_nodes":13,"running_canisters":37775,"memory_usage_bytes":384197632643,"message_execution_rate":45},{"type":"application","subnet_id":"6pbhf-qzpdk-kuqbr-pklfa-5ehhf-jfjps-zsj6q-57nrl-kzhpd-mu7hc-vae","total_nodes":13,"running_canisters":36251,"memory_usage_bytes":288442099475,"message_execution_rate":32},{"type":"application","subnet_id":"jtdsg-3h6gi-hs7o5-z2soi-43w3z-soyl3-ajnp3-ekni5-sw553-5kw67-nqe","total_nodes":13,"running_canisters":33638,"memory_usage_bytes":197231959114,"message_execution_rate":32},{"type":"application","subnet_id":"k44fs-gm4pv-afozh-rs7zw-cg32n-u7xov-xqyx3-2pw5q-eucnu-cosd4-uqe","total_nodes":13,"running_canisters":30105,"memory_usage_bytes":443540084252,"message_execution_rate":36},{"type":"application","subnet_id":"fuqsr-in2lc-zbcjj-ydmcw-pzq7h-4xm2z-pto4i-dcyee-5z4rz-x63ji-nae","total_nodes":13,"running_canisters":29505,"memory_usage_bytes":277158705286,"message_execution_rate":41},{"type":"application","subnet_id":"3hhby-wmtmw-umt4t-7ieyg-bbiig-xiylg-sblrt-voxgt-bqckd-a75bf-rqe","total_nodes":13,"running_canisters":27600,"memory_usage_bytes":1346022622589,"message_execution_rate":38},{"type":"application","subnet_id":"lhg73-sax6z-2zank-6oer2-575lz-zgbxx-ptudx-5korm-fy7we-kh4hl-pqe","total_nodes":13,"running_canisters":25701,"memory_usage_bytes":310312528962,"message_execution_rate":1479},{"type":"application","subnet_id":"bkfrj-6k62g-dycql-7h53p-atvkj-zg4to-gaogh-netha-ptybj-ntsgw-rqe","total_nodes":13,"running_canisters":25229,"memory_usage_bytes":45477668813,"message_execution_rate":4},{"type":"verified_application","subnet_id":"5kdm2-62fc6-fwnja-hutkz-ycsnm-4z33i-woh43-4cenu-ev7mi-gii6t-4ae","total_nodes":13,"running_canisters":19216,"memory_usage_bytes":0,"message_execution_rate":21},{"type":"verified_application","subnet_id":"ejbmu-grnam-gk6ol-6irwa-htwoj-7ihfl-goimw-hlnvh-abms4-47v2e-zqe","total_nodes":13,"running_canisters":17280,"memory_usage_bytes":208755865669,"message_execution_rate":43},{"type":"application","subnet_id":"4ecnw-byqwz-dtgss-ua2mh-pfvs7-c3lct-gtf4e-hnu75-j7eek-iifqm-sqe","total_nodes":13,"running_canisters":14661,"memory_usage_bytes":310898673908,"message_execution_rate":56},{"type":"application","subnet_id":"yinp6-35cfo-wgcd2-oc4ty-2kqpf-t4dul-rfk33-fsq3r-mfmua-m2ngh-jqe","total_nodes":13,"running_canisters":14573,"memory_usage_bytes":342368128750,"message_execution_rate":116},{"type":"verified_application","subnet_id":"pae4o-o6dxf-xki7q-ezclx-znyd6-fnk6w-vkv5z-5lfwh-xym2i-otrrw-fqe","total_nodes":13,"running_canisters":10868,"memory_usage_bytes":207315431639,"message_execution_rate":0},{"type":"verified_application","subnet_id":"snjp4-xlbw4-mnbog-ddwy6-6ckfd-2w5a2-eipqo-7l436-pxqkh-l6fuv-vae","total_nodes":13,"running_canisters":10399,"memory_usage_bytes":280878302381,"message_execution_rate":39},{"type":"verified_application","subnet_id":"csyj4-zmann-ys6ge-3kzi6-onexi-obayx-2fvak-zersm-euci4-6pslt-lae","total_nodes":13,"running_canisters":9590,"memory_usage_bytes":264113855683,"message_execution_rate":0},{"type":"verified_application","subnet_id":"w4asl-4nmyj-qnr7c-6cqq4-tkwmt-o26di-iupkq-vx4kt-asbrx-jzuxh-4ae","total_nodes":13,"running_canisters":8931,"memory_usage_bytes":226955054663,"message_execution_rate":60},{"type":"verified_application","subnet_id":"shefu-t3kr5-t5q3w-mqmdq-jabyv-vyvtf-cyyey-3kmo4-toyln-emubw-4qe","total_nodes":13,"running_canisters":8904,"memory_usage_bytes":322794848938,"message_execution_rate":41},{"type":"verified_application","subnet_id":"io67a-2jmkw-zup3h-snbwi-g6a5n-rm5dn-b6png-lvdpl-nqnto-yih6l-gqe","total_nodes":13,"running_canisters":8797,"memory_usage_bytes":429590904552,"message_execution_rate":32},{"type":"verified_application","subnet_id":"qxesv-zoxpm-vc64m-zxguk-5sj74-35vrb-tbgwg-pcird-5gr26-62oxl-cae","total_nodes":13,"running_canisters":8297,"memory_usage_bytes":230808633157,"message_execution_rate":18},{"type":"application","subnet_id":"4utr6-xo2fz-v7fsb-t3wsg-k7sfl-cj2ba-ghdnd-kcrfo-xavdb-ebean-mqe","total_nodes":13,"running_canisters":8245,"memory_usage_bytes":218170646552,"message_execution_rate":23},{"type":"application","subnet_id":"c4isl-65rwf-emhk5-5ta5m-ngl73-rgrl3-tcc56-2hkja-4erqd-iivmy-7ae","total_nodes":13,"running_canisters":7441,"memory_usage_bytes":224254739282,"message_execution_rate":19},{"type":"application","subnet_id":"pzp6e-ekpqk-3c5x7-2h6so-njoeq-mt45d-h3h6c-q3mxf-vpeq5-fk5o7-yae","total_nodes":34,"running_canisters":3903,"memory_usage_bytes":68718394568,"message_execution_rate":1539},{"type":"application","subnet_id":"x33ed-h457x-bsgyx-oqxqf-6pzwv-wkhzr-rm2j3-npodi-purzm-n66cg-gae","total_nodes":34,"running_canisters":306,"memory_usage_bytes":22216459412,"message_execution_rate":281},{"type":"application","subnet_id":"3zsyy-cnoqf-tvlun-ymf55-tkpca-ox7uw-kfxoh-7khwq-2gz43-wafem-lqe","total_nodes":13,"running_canisters":88,"memory_usage_bytes":6187376100,"message_execution_rate":0},{"type":"system","subnet_id":"tdb26-jop6k-aogll-7ltgs-eruif-6kk7m-qpktf-gdiqx-mxtrf-vb5e6-eqe","total_nodes":40,"running_canisters":18,"memory_usage_bytes":30059454285,"message_execution_rate":329},{"type":"system","subnet_id":"uzr34-akd3s-xrdag-3ql62-ocgoh-ld2ao-tamcv-54e7j-krwgb-2gm4z-oqe","total_nodes":34,"running_canisters":8,"memory_usage_bytes":24106248562,"message_execution_rate":53},{"type":"system","subnet_id":"w4rem-dv5e3-widiz-wbpea-kbttk-mnzfm-tzrc7-svcj3-kbxyb-zamch-hqe","total_nodes":13,"running_canisters":8,"memory_usage_bytes":213028409534,"message_execution_rate":7},{"type":"application","subnet_id":"re2t4-faa75-v3vhk-kdmdr-uyrkl-aik2l-ixd6u-p3fyr-zlfkc-6c5af-zae","total_nodes":7,"running_canisters":3,"memory_usage_bytes":56203817,"message_execution_rate":0},{"type":"application","subnet_id":"2zs4v-uoqha-xsuun-lveyr-i4ktc-5y3ju-aysud-niobd-gxnqa-ctqem-hae","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0},{"type":"application","subnet_id":"6excn-doq5g-bmrxd-3774i-hjnn2-3ovbo-xjwz7-3yozt-fsbzx-bethy-bae","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0},{"type":"application","subnet_id":"kp5jj-kpgmn-f4ohx-uqot6-wtbbr-lmtqv-kpkaf-gcksv-snkwm-43kmy-iae","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0},{"type":"application","subnet_id":"mkbc3-fzim5-s5pye-pbnzo-uj5yv-raphe-ceecn-ejd6g-5poxm-dzuot-iae","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0},{"type":"application","subnet_id":"rtvil-s5u5d-jbj7o-prlhw-bzlr5-3j5kn-2iu7a-jq2hl-avkhn-w7oa7-6ae","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0},{"type":"application","subnet_id":"vcpt7-niq42-6snup-7kcgy-cndz6-srq6n-h6vwi-oswri-a3guc-v5ssd-5qe","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0},{"type":"application","subnet_id":"xlkub-3thlm-uha3c-hqmfw-qykp5-6rldi-hpfxy-nwyxy-w6bbk-tpg5h-vqe","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0},{"type":"application","subnet_id":"xok3w-cnepj-fg6aa-cjitt-uoxod-4ddsy-nc7dq-zwudz-o6jar-rzstb-gqe","total_nodes":7,"running_canisters":0,"memory_usage_bytes":0,"message_execution_rate":0}],"total_subnets":49},"meta":{"timestamp":"2026-06-10T13:59:51.351Z","request_id":"51521a68-65ec-4777-8b12-8dd67944ccdb"},"status":"ok","message":"Subnets 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":"Internet Computer dashboard and ledger APIs (internetcomputer.org, live)","service":"icp-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/account":"A ledger account's ICP balance and transaction count (account=64 hex).","GET /v1/network":"Live IC state: block height, canisters, nodes, subnets, message rate.","GET /v1/subnets":"The subnets that shard the Internet Computer (limit=50).","GET /v1/canister":"A canister's type, controllers, name and subnet (id=ryjl3-tyaaa-aaaaa-aaaba-cai)."},"description":"Live on-chain data from the Internet Computer (ICP), a blockchain that runs software as tamper-proof canisters on a network of independent subnets, via the public IC dashboard and ledger APIs. The network endpoint returns the block height, running and stopped canisters, node count, number of subnets and message-execution rate; the account endpoint returns a ledger account's ICP balance and transaction count; the canister endpoint returns a canister's type, controllers, name and subnet; the subnets endpoint returns the replica groups that shard the IC with their type, canisters, nodes and throughput. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, Celestia, EOS and EVM on-chain APIs and from price feeds — this is the IC's own canister, subnet and ICP-ledger model.","block_height":8307257613,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T13:59:51.820Z","request_id":"886df30b-871c-4335-91fc-decb46fc7dae"},"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":10000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":900,"monthly_call_quota":140000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":892000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5900,"monthly_call_quota":4660000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/icp-api"}