{"openapi":"3.1.0","info":{"title":"Aptos (APT) On-Chain API","version":"1.0.0","description":"Live on-chain data from the Aptos blockchain (APT), a high-throughput Move-based Layer 1, served straight from the official public Aptos fullnode REST API — no key, nothing cached. The account endpoint returns any address's state: its sequence number, authentication key, APT balance and how many on-chain resources it holds. The balance endpoint returns the balance of APT or any coin or fungible asset for an address, handling both the classic coin standard and the newer fungible-asset standard in one call. The resources endpoint lists the Move resource types an account holds — its coins, stores, staking and module data — the structural view of what lives at an address. The transactions endpoint returns the account's most recent transactions with the version, hash, entry function, success flag, gas used and time. The network endpoint returns the live chain state: chain id, the latest ledger version and block height, the epoch and the ledger timestamp. Everything is read live from the fullnode, nothing stored. This is the Aptos on-chain layer for any wallet, explorer, payments, gaming or analytics app. Distinct from the XRP Ledger, Stellar, TRON, EVM and Solana on-chain APIs and from price feeds — this is Aptos account state, balances, Move resources, transactions and ledger health. 5 endpoints, no key on our side.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/aptos-api","description":"oanor gateway"}],"tags":[{"name":"Aptos"},{"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/account":{"get":{"operationId":"get_v1_account","tags":["Aptos"],"summary":"An address's state","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Aptos address (0x...)","schema":{"type":"string"},"example":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Aptos","address":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","apt_balance":32794.6384777,"resource_count":1,"sequence_number":31015,"authentication_key":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d"},"meta":{"timestamp":"2026-06-09T20:24:51.673Z","request_id":"59304cc8-b8e1-482a-bae3-9645fd30144e"},"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/balance":{"get":{"operationId":"get_v1_balance","tags":["Aptos"],"summary":"Balance of APT or any asset","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Aptos address (0x...)","schema":{"type":"string"},"example":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d"},{"name":"asset","in":"query","required":false,"description":"APT (default), an FA address or a coin type","schema":{"type":"string"},"example":"APT"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"asset":"0xa","source":"Aptos","address":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","balance":32794.6300932,"balance_raw":"3279463009320","decimals_assumed":8},"meta":{"timestamp":"2026-06-09T20:24:51.935Z","request_id":"06c3b36d-68ca-402b-89f5-c882e5ec96c7"},"status":"ok","message":"Balance 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/network":{"get":{"operationId":"get_v1_network","tags":["Aptos"],"summary":"Live Aptos chain state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"epoch":16115,"source":"Aptos","chain_id":1,"git_hash":"7f0840cc711a8415e765e15a6bf06955107df741","node_role":"full_node","block_height":"820275931","ledger_version":"5654251983","ledger_timestamp":"2026-06-09T20:24:51.978Z"},"meta":{"timestamp":"2026-06-09T20:24:52.176Z","request_id":"1dbffce3-e122-420a-9256-a64772c58945"},"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/resources":{"get":{"operationId":"get_v1_resources","tags":["Aptos"],"summary":"Move resource types an account holds","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Aptos address (0x...)","schema":{"type":"string"},"example":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d"},{"name":"limit","in":"query","required":false,"description":"Max types (default 100)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Aptos","address":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","resources":["0x1::account::Account"],"resource_count":1},"meta":{"timestamp":"2026-06-09T20:24:52.422Z","request_id":"5c2778d4-9dc5-476e-a9f6-4015586addec"},"status":"ok","message":"Resources 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/transactions":{"get":{"operationId":"get_v1_transactions","tags":["Aptos"],"summary":"Recent transactions","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Aptos address (0x...)","schema":{"type":"string"},"example":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d"},{"name":"limit","in":"query","required":false,"description":"Max transactions (1-100, default 20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"Aptos","address":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","transactions":[{"hash":"0xd17c9e4ecaa7d6095eb288661e30398bb11df6a30f2c5b799426a2c68949d764","time":"2026-05-11T11:19:27.127Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5222674214","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount","gas_used":229,"vm_status":"Executed successfully"},{"hash":"0xd4c680d9a55653df00d7a8ebe89278ecad2995b288c6b44ce42b17e897e668a4","time":"2026-05-11T11:19:29.168Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5222674548","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount","gas_used":223,"vm_status":"Executed successfully"},{"hash":"0x920c41810fc3dd7dd2ae1542edf596f4fb22caccbb927a6d8a2b3ab8634a7d7b","time":"2026-05-11T11:19:30.518Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5222674775","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount","gas_used":221,"vm_status":"Executed successfully"},{"hash":"0x350b179516b1ddbc8b0b382320971459f7570e01d68598c9a78c7b603bf17e98","time":"2026-05-11T11:19:32.478Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5222675047","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount","gas_used":237,"vm_status":"Executed successfully"},{"hash":"0x522b7946cd5f0b6071abc34dfc79495c208feb86f0f8d5bd01e7ed78cf9d890d","time":"2026-05-11T11:19:34.956Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5222675401","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount","gas_used":228,"vm_status":"Executed successfully"},{"hash":"0x9d96096d955b32605bbb5bcf23d9f918fc2dce847e6985d8a6067e27d6ef15f8","time":"2026-05-11T11:19:36.640Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5222675660","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount","gas_used":242,"vm_status":"Executed successfully"},{"hash":"0x466bfdb75e27aaa73ca0741e91b46c49a4db343f350e259ac3179f2fe9fd1047","time":"2026-05-13T07:51:33.395Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5249383881","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::place_order_to_subaccount","gas_used":247,"vm_status":"Executed successfully"},{"hash":"0x6f09ba37d8101f9e84acdf4793def69b21a6c73e45ba885167e2c432f0ce08b4","time":"2026-05-13T07:59:23.054Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5249461084","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::place_order_to_subaccount","gas_used":243,"vm_status":"Executed successfully"},{"hash":"0x8c7925024f903271d71f45fcbf43512253acb6a35e1f98f39ba3d450cebdaedf","time":"2026-06-04T12:55:25.528Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5565533165","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::place_order_to_subaccount","gas_used":240,"vm_status":"Executed successfully"},{"hash":"0x8b001d41f37797fcd1c52349456fb94638f3032a496b3e15a33e0c5c4496e129","time":"2026-06-04T12:55:50.782Z","type":"user_transaction","sender":"0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d","success":true,"version":"5565538156","function":"0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::place_order_to_subaccount","gas_used":239,"vm_status":"Executed successfully"}]},"meta":{"timestamp":"2026-06-09T20:24:53.086Z","request_id":"ddfb35b1-ed75-44cd-917e-04c7494e9bb5"},"status":"ok","message":"Transactions 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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Aptos public fullnode REST API (live)","service":"aptos-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/account":"An address's state (address=0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d).","GET /v1/balance":"Balance of APT or any coin/FA (address=, asset=APT).","GET /v1/network":"Live Aptos chain state: chain id, ledger version, block height, epoch.","GET /v1/resources":"The Move resource types an account holds (address=).","GET /v1/transactions":"An address's recent transactions (address=, limit)."},"description":"Live on-chain data from the Aptos blockchain (APT), a high-throughput Move Layer 1, from the official public fullnode REST API: any address's state (sequence number, auth key, APT balance, resource count); the balance of APT or any coin/fungible asset (handling both the coin and fungible-asset standards); the Move resource types an account holds; the account's recent transactions (version, hash, entry function, success, gas, time); and the live chain state (chain id, ledger version, block height, epoch, timestamp). Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, EVM and Solana on-chain APIs and from price feeds — this is Aptos account state, balances, Move resources, transactions and ledger health.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T20:24:53.327Z","request_id":"c60ccccc-1c77-4043-a7ce-cde891f60775"},"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":4500,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1200,"monthly_call_quota":110000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3100,"monthly_call_quota":640000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7600,"monthly_call_quota":3400000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/aptos-api"}