{"openapi":"3.1.0","info":{"title":"Merlin Chain API","version":"1.0.0","description":"Real-time on-chain data for Merlin Chain (chain-id 4200) — the Bitcoin Layer-2 ZK-rollup built on the Polygon CDK stack, EVM-compatible and using BTC as its native gas token. Query live network status (latest block height, network id, client version), fetch any block by height or the latest one (timestamp, transaction count, gas used / limit, base fee, miner), read the current gas price in wei and gwei, and look up the native BTC balance and transaction count of any address. A keyless, no-account JSON wrapper over the canonical Merlin Chain JSON-RPC node — decoded from hex into plain decimals and human-readable BTC so you do not have to. Ideal for explorers, wallets, dashboards, gas estimators and analytics on the Merlin Chain Bitcoin L2.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/merlin-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Blocks"},{"name":"Gas"},{"name":"Accounts"},{"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/status":{"get":{"operationId":"get_v1_status","tags":["Network"],"summary":"Network status (latest block, chain id, client version)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Merlin Chain","chain_id":4200,"network_id":4200,"rpc_healthy":true,"latest_block":29810162,"native_symbol":"BTC","client_version":"cdk-erigon/v2.0.3/linux-amd64/go1.21.5"},"meta":{"timestamp":"2026-06-15T11:14:36.225Z","request_id":"385453e2-8ef6-461f-877f-468c2cd6bc10"},"status":"ok","message":"Chain status 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":["Blocks"],"summary":"Block by height (or latest)","description":"","parameters":[{"name":"number","in":"query","required":false,"description":"Block height (decimal or 0x-hex), or \"latest\"","schema":{"type":"string"},"example":"10000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hash":"0x420030e89f1ee17d09dba67ba899a79aed07f16b1529d0b5e3b8f09b10f1872e","miner":"0xf73d921aa8f2dbe77adca8466127b392ede89dc9","number":10000000,"gas_used":37977,"gas_limit":30000000,"timestamp":1713713703,"size_bytes":820,"parent_hash":"0x10d92b137905add2af67acd118dbe2b4bee9187347a4dc4ba4ede3ee42579802","timestamp_iso":"2024-04-21T15:35:03.000Z","transaction_count":1},"meta":{"timestamp":"2026-06-15T11:14:36.360Z","request_id":"47c5e60a-966b-4bb0-a873-637e4969ef82"},"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/gas":{"get":{"operationId":"get_v1_gas","tags":["Gas"],"summary":"Current gas price (wei + gwei)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"at_block":29810162,"gas_price_wei":"6000000","native_symbol":"BTC","gas_price_gwei":0.006},"meta":{"timestamp":"2026-06-15T11:14:36.641Z","request_id":"423d7418-5cb0-4dbf-9e01-f4c98993a1df"},"status":"ok","message":"Gas price 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":["Accounts"],"summary":"Native BTC balance and transaction count of an address","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"0x-prefixed 40-hex EVM address","schema":{"type":"string"},"example":"0x000000000000000000000000000000000000dEaD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"address":"0x000000000000000000000000000000000000dEaD","balance":"0.006268881616871056","balance_wei":"6268881616871056","native_symbol":"BTC","transaction_count":0},"meta":{"timestamp":"2026-06-15T11:14:36.965Z","request_id":"2b5e5ca3-b24c-46bc-8586-e82688e2027b"},"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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"Bitcoin Layer-2 (Polygon CDK ZK-rollup)","chain":"Merlin Chain","network":"mainnet","chain_id":4200,"decimals":18,"ecosystem":"Merlin Chain — Bitcoin-native ZK rollup, native gas token BTC","endpoints":["/v1/status","/v1/block","/v1/gas","/v1/balance","/v1/meta"],"description":"Merlin Chain is a Bitcoin Layer-2 ZK-rollup built on the Polygon CDK stack, EVM-compatible and using BTC as its native gas token.","documentation":"https://merlin-api.oanor.dev","native_symbol":"BTC"},"meta":{"timestamp":"2026-06-15T11:14:37.028Z","request_id":"599ff489-e1b0-4c23-be40-011051f55205"},"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":4900,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1440,"monthly_call_quota":66000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3740,"monthly_call_quota":215000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7960,"monthly_call_quota":925000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/merlin-api"}