{"openapi":"3.1.0","info":{"title":"Stacks API","version":"1.0.0","description":"Live on-chain data from the Stacks network (STX), a Bitcoin layer that settles to Bitcoin and uses Proof of Transfer (PoX) — STX holders stack tokens to secure the chain and earn BTC: an address's available and locked (stacked) STX, totals sent/received and miner rewards; a block's height, hash, transaction count and the Bitcoin burn block it anchors to; the live Proof-of-Transfer stacking state (current reward cycle, STX stacked, share of supply locked, minimum threshold); and the chain tip, anchored Bitcoin block height and total STX supply.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stacks-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Account"},{"name":"Block"},{"name":"Stacking"},{"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 Stacks chain tip, Bitcoin anchor and STX supply","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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 address available, stacked and total STX","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Stacks address (SP... or SM...)","schema":{"type":"string"},"example":"SPE3481ZKSV7AT33BG20J7ZYMKG61V36W7M987KV"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Stacks","address":"SPE3481ZKSV7AT33BG20J7ZYMKG61V36W7M987KV","balance_stx":17.898745,"is_stacking":false,"available_stx":17.898745,"total_sent_stx":34.114,"miner_rewards_stx":0,"locked_stacked_stx":0,"total_received_stx":60.2447,"total_fees_sent_stx":8.231955},"meta":{"timestamp":"2026-06-10T14:01:25.192Z","request_id":"d73dbdd5-d85c-4e39-84d5-3d640ef40b50"},"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/block":{"get":{"operationId":"get_v1_block","tags":["Block"],"summary":"A block details and the Bitcoin block it anchors to","description":"","parameters":[{"name":"height","in":"query","required":false,"description":"Block height, 0x hash or latest","schema":{"type":"string"},"example":"latest"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hash":"0x51c90cfa00462be608b49c639aeea9eeee75778fb13c486fc0bfcbf5d0929b5d","time":"2026-06-10T14:01:00.000Z","height":8244261,"source":"Stacks","tx_count":8,"miner_txid":"0x47760f9b2bf47b4d474253f7ddef8bfe3f7c34a0115c0643399a80b53b17b9b8","parent_hash":"0x5f1407feee967c17bd9106fb9bc48b1e542ecf5ce168f062c118fe7b595b67ae","tenure_height":245689,"bitcoin_burn_block_hash":"0x0000000000000000000169d7903fb22595e7f29e486a97d56844ab7f4f432c44","bitcoin_burn_block_time":"2026-06-10T13:56:22.000Z","bitcoin_burn_block_height":953111},"meta":{"timestamp":"2026-06-10T14:01:25.586Z","request_id":"ee7c9122-527f-4236-aef5-3b9ac6e5a7b5"},"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/stacking":{"get":{"operationId":"get_v1_stacking","tags":["Stacking"],"summary":"Live Proof-of-Transfer stacking state and reward cycle","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Stacks","next_cycle":{"id":137,"stacked_stx":115932029.96357,"min_threshold_stx":120000,"blocks_until_start":639},"stacked_stx":504262340.623865,"is_pox_active":true,"current_cycle_id":136,"min_threshold_stx":130000,"stacked_ratio_pct":27.28,"reward_cycle_length":2100,"total_liquid_supply_stx":1848441120.01581},"meta":{"timestamp":"2026-06-10T14:01:26.087Z","request_id":"64daacb6-3fad-4451-b671-253992e07196"},"status":"ok","message":"Stacking 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/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":"Hiro Stacks API (api.hiro.so, live)","service":"stacks-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/block":"A block's details and the Bitcoin block it anchors to (height=latest|N).","GET /v1/account":"An address's available, stacked and total STX (address=SPE3481ZKSV7AT33BG20J7ZYMKG61V36W7M987KV).","GET /v1/network":"Chain tip, anchored Bitcoin height and total STX supply.","GET /v1/stacking":"Live Proof-of-Transfer stacking state and reward cycle."},"description":"Live on-chain data from the Stacks network (STX), a Bitcoin layer that settles to Bitcoin and uses Proof of Transfer (PoX), where STX holders stack tokens to secure the chain and earn BTC, via the public Hiro Stacks API. The account endpoint returns an address's available and locked (stacked) STX, totals sent/received and miner rewards; the block endpoint returns a Stacks block's height, hash, transaction count and the Bitcoin burn block it anchors to; the stacking endpoint returns the live PoX state (current reward cycle, STX stacked, share of supply locked, minimum threshold); the network endpoint returns the chain tip, anchored Bitcoin block height and total STX supply. Live, no key, nothing stored. Distinct from the Bitcoin, Celestia, Cosmos, Solana and EVM on-chain APIs and from price feeds — this is Stacks' own STX account state, PoX stacking economy and Bitcoin-anchored blocks.","upstream_status":"ok","stacks_tip_height":8244261},"meta":{"timestamp":"2026-06-10T14:01:26.233Z","request_id":"9a9e9c85-0753-48a1-acf3-9e6929914cc7"},"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":900,"monthly_call_quota":137000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":885000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5900,"monthly_call_quota":4650000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stacks-api"}