{"openapi":"3.1.0","info":{"title":"Liquid Network On-Chain API","version":"1.0.0","description":"The Liquid Network — Bitcoin's confidential sidechain — live from the public Blockstream esplora API, no key, nothing cached. Liquid is a federated Bitcoin sidechain with one-minute blocks, confidential transactions and issued assets (Tether's USDt and many others live here as Liquid assets), with L-BTC pegged one-to-one to Bitcoin. This is the first Liquid reader in the marketplace. Read the live network status — the chain tip block height and the current mempool, with the count of unconfirmed transactions, their total virtual size and total fees. Read any block by height, or the current tip, with its hash, previous block, timestamp, transaction count, size and weight. And read the live fee estimates in sat/vB keyed by the number of blocks you are willing to wait. The on-chain layer for Liquid wallets, asset issuers, explorers and analytics. Live from blockstream.info.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/liquid-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Fees"},{"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/block":{"get":{"operationId":"get_v1_block","tags":["Network"],"summary":"A block by height: hash, timestamp, tx count, size, weight","description":"","parameters":[{"name":"height","in":"query","required":false,"description":"Block height (omit for the current tip)","schema":{"type":"string"},"example":"3000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"75abdf85fa4e465cb9d9dabed728583f291a8123f50c6d99f71894f22da7e648","note":"A Liquid block by height: its hash, previous block, timestamp, transaction count, size and weight. Omit height for the current tip block.","size":1776,"height":3000000,"source":"Blockstream esplora (Liquid)","weight":6975,"tx_count":1,"timestamp":1724373428,"median_time":1724373127,"previous_block":"14e50221a4a7b796f0d29a8219549d9d6687d51bd2aa9b7abeb8b42443bb6dd1"},"meta":{"timestamp":"2026-06-14T17:04:30.004Z","request_id":"3e3900f0-9294-4991-bc4a-a415ae8dda28"},"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/info":{"get":{"operationId":"get_v1_info","tags":["Network"],"summary":"Live network status: tip height and the current mempool","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live Liquid Network status: the chain tip block height and the current mempool — the number of unconfirmed transactions, their total virtual size and total fees. Liquid produces a block roughly every minute.","source":"Blockstream esplora (Liquid)","tip_height":3929588,"mempool_vsize":18062,"mempool_tx_count":1,"mempool_total_fee":119},"meta":{"timestamp":"2026-06-14T17:04:30.611Z","request_id":"3d023196-7464-43a1-9e66-c8832f37f4d5"},"status":"ok","message":"Info 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/fees":{"get":{"operationId":"get_v1_fees","tags":["Fees"],"summary":"Live fee estimates in sat/vB by confirmation target","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live Liquid fee estimates in sat/vB, keyed by the number of blocks you are willing to wait. fastest_1_block confirms in the next block (~1 minute on Liquid).","unit":"sat/vB","source":"Blockstream esplora (Liquid)","estimates":{"target_1_blocks":0.1,"target_2_blocks":0.1,"target_3_blocks":0.1,"target_6_blocks":0.1,"target_10_blocks":0.1,"target_25_blocks":0.1,"target_144_blocks":0.1,"target_504_blocks":0.1,"target_1008_blocks":0.1},"hour_6_blocks":0.1,"fastest_1_block":0.1,"half_hour_3_blocks":0.1},"meta":{"timestamp":"2026-06-14T17:04:30.955Z","request_id":"92362cf7-fe54-4616-bad9-0e800b407c1b"},"status":"ok","message":"Fees 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":{"mempool_tx":1,"tip_height":3929588},"source":"public Blockstream esplora API (blockstream.info/liquid/api), keyless","service":"liquid-api","endpoints":{"GET /v1/fees":"Live fee estimates in sat/vB by confirmation target.","GET /v1/info":"Live network status: tip height and the current mempool (count, vsize, fees).","GET /v1/meta":"This document.","GET /v1/block":"A block by height: hash, timestamp, tx count, size, weight (height; omit for tip)."},"description":"Read the Liquid Network (Bitcoin's confidential sidechain) live from the public Blockstream esplora API: the live network status (tip height, mempool count/vsize/fees), any block by height (or the tip) with its hash, timestamp, transaction count, size and weight, and the live fee estimates by confirmation target. The on-chain layer for Liquid wallets, asset issuers and explorers. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:04:31.041Z","request_id":"9e31624f-3473-407c-b6d1-106745401068"},"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":7050,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":870,"monthly_call_quota":137500,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3460,"monthly_call_quota":793000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9250,"monthly_call_quota":5080000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/liquid-api"}