{"openapi":"3.1.0","info":{"title":"Wrapped Bitcoin Tracker API","version":"1.0.0","description":"How much Bitcoin lives on Ethereum, and through whose vault, read live and keyless straight from the Ethereum blockchain. Bitcoin itself can't run in DeFi, so it gets \"wrapped\": a custodian (or a decentralised bridge) locks real BTC and mints a 1:1 ERC-20 that trades on Ethereum. WBTC (BitGo) was the original and long the only one that mattered, but after the 2024 custody controversy a competitive market opened up — Coinbase's cbBTC, the decentralised tBTC (Threshold), Lombard's LBTC, Kraken's kBTC and others now split the pie. The wrappers endpoint lists every tracked wrapped-Bitcoin token ranked by the BTC it holds, each with its issuer/custodian, the BTC backing it, its US-dollar value and its share of all wrapped BTC, plus the totals. The token endpoint returns one wrapper's detail by symbol. The dominance endpoint is the concentration view — WBTC's share, the split between custodial wrappers (a company holds the BTC) and the decentralised one, and how concentrated the market is — the counterparty-risk picture for Bitcoin in DeFi. Each token's BTC backing is read as its on-chain total supply divided by its own decimals (read live from the contract — they are not all 18: WBTC and cbBTC use 8, tBTC uses 18), which equals the BTC held because every wrapper is minted 1:1 against locked Bitcoin. This is the wrapped-BTC / BTC-on-Ethereum cut — distinct from the coin price feeds, the generic ERC-20 token-info feed and the stablecoin feeds. Supplies are in BTC; values in USD (BTC priced from Yahoo Finance). No key, nothing stored beyond a short cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wrappedbitcoin-api","description":"oanor gateway"}],"tags":[{"name":"Wrappers"},{"name":"Token"},{"name":"Dominance"},{"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/wrappers":{"get":{"operationId":"get_v1_wrappers","tags":["Wrappers"],"summary":"All wrapped-BTC tokens ranked by BTC held + totals","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Every tracked wrapped-Bitcoin token on Ethereum, ranked by the BTC it holds — each with its issuer/custodian, the BTC backing it (read on-chain as total supply ÷ the token's own decimals), its USD value and its share of all wrapped BTC. WBTC (BitGo) has historically led; cbBTC (Coinbase) and the decentralised tBTC have taken share since 2024. Every wrapper is 1:1 BTC-backed by design. Live from the Ethereum blockchain, cached ~5m.","count":8,"leader":"WBTC","source":"Ethereum public JSON-RPC (token contracts) + Yahoo Finance (BTC-USD), keyless","wrappers":[{"btc":116132.1827,"issuer":"BitGo","symbol":"WBTC","custody":"custodial","contract":"0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599","decimals":8,"share_pct":65.04,"value_usd":7386750066},{"btc":42268.0816,"issuer":"Coinbase","symbol":"cbBTC","custody":"custodial","contract":"0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf","decimals":8,"share_pct":23.67,"value_usd":2688520505},{"btc":8338.2013,"issuer":"Lombard","symbol":"LBTC","custody":"custodial","contract":"0x8236a87084f8B84306f72007F36F2618A5634494","decimals":8,"share_pct":4.67,"value_usd":530362967},{"btc":5002.2284,"issuer":"Threshold Network","symbol":"tBTC","custody":"decentralised","contract":"0x18084fbA666a33d37592fA2633fD49a74DD93a88","decimals":18,"share_pct":2.8,"value_usd":318173741},{"btc":3308.9708,"issuer":"Kraken","symbol":"kBTC","custody":"custodial","contract":"0x73E0C0d45E048D25Fc26Fa3159b0aA04BfA4Db98","decimals":8,"share_pct":1.85,"value_usd":210471720},{"btc":2350.2165,"issuer":"Solv Protocol","symbol":"solvBTC","custody":"custodial","contract":"0x7A56E1C57C7475CCf742a1832B028F0456652F97","decimals":18,"share_pct":1.32,"value_usd":149488811},{"btc":595.7581,"issuer":"pumpBTC","symbol":"pumpBTC","custody":"custodial","contract":"0xF469fBD2abcd6B9de8E169d128226C0Fc90a012e","decimals":8,"share_pct":0.33,"value_usd":37894028},{"btc":569.7664,"issuer":"ether.fi / Threshold","symbol":"eBTC","custody":"custodial","contract":"0x657e8C867D8B37dCC18fA4Caead9C45EB088C642","decimals":8,"share_pct":0.32,"value_usd":36240790}],"btc_price_usd":63606.4,"total_value_usd":11357902627,"total_wrapped_btc":178565.4058},"meta":{"timestamp":"2026-06-12T19:35:40.782Z","request_id":"25722dc6-add7-4bd8-bc2b-edb01257cbba"},"status":"ok","message":"Wrappers 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/token":{"get":{"operationId":"get_v1_token","tags":["Token"],"summary":"One wrapper's detail by symbol","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"A tracked wrapped-BTC token","schema":{"type":"string"},"example":"cbBTC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"btc":42268.0816,"note":"One wrapped-Bitcoin token's on-chain detail: the BTC it holds (total supply ÷ decimals, 1:1 backed), its USD value, its issuer/custodian and whether the BTC is held custodially or by a decentralised bridge. Live, cached ~5m.","issuer":"Coinbase","source":"Ethereum public JSON-RPC (cbBTC contract) + Yahoo Finance, keyless","symbol":"cbBTC","custody":"custodial","contract":"0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf","decimals":8,"value_usd":2688520505,"btc_price_usd":63606.4},"meta":{"timestamp":"2026-06-12T19:35:40.847Z","request_id":"ea5868c6-21e1-49f1-927e-20119f2a81b2"},"status":"ok","message":"Token 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/dominance":{"get":{"operationId":"get_v1_dominance","tags":["Dominance"],"summary":"WBTC share + custodial-vs-decentralised concentration","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The concentration of wrapped Bitcoin on Ethereum — the counterparty-risk view. wbtc_dominance_pct is BitGo's WBTC share; custodial_pct vs decentralised_pct splits the BTC held by a company (BitGo, Coinbase, Lombard…) from the BTC held by a decentralised bridge (tBTC); top2_concentration_pct shows how much sits with the two biggest. A high custodial and WBTC share concentrates trust in a few custodians. Live, cached ~5m.","source":"Ethereum public JSON-RPC (token contracts) + Yahoo Finance, keyless","issuer_count":8,"custodial_pct":97.2,"total_value_usd":11357902627,"decentralised_pct":2.8,"total_wrapped_btc":178565.4058,"wbtc_dominance_pct":65.04,"top2_concentration_pct":88.71},"meta":{"timestamp":"2026-06-12T19:35:40.938Z","request_id":"69ce468c-c59a-4f61-9f0e-afc9d8014d2e"},"status":"ok","message":"Dominance 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":{"note":"wrappers, dominance and meta take no parameters. token takes symbol (a tracked wrapped-BTC token, required). BTC amounts are real on-chain backing; USD values use the live BTC price; decimals are read per-contract so units are exact. A ~5-minute cache fronts the upstreams.","source":"Ethereum public JSON-RPC + Yahoo Finance (BTC-USD), keyless, live","service":"wrappedbitcoin-api","tracked":["WBTC","cbBTC","tBTC","LBTC","solvBTC","eBTC","kBTC","pumpBTC"],"endpoints":{"GET /v1/meta":"This document.","GET /v1/token":"One wrapper's detail by symbol (symbol=cbBTC).","GET /v1/wrappers":"All wrapped-BTC tokens ranked by BTC held + totals.","GET /v1/dominance":"WBTC share + custodial-vs-decentralised concentration."},"description":"How much Bitcoin lives on Ethereum and through whose vault, read live and keyless from the Ethereum blockchain. Bitcoin gets 'wrapped' — a custodian or a decentralised bridge locks BTC and mints a 1:1 ERC-20. The wrappers endpoint lists every tracked wrapped-BTC token ranked by BTC held (issuer, BTC backing, USD value, share); token returns one by symbol; dominance is the concentration/counterparty-risk view — WBTC's share and the custodial-versus-decentralised split. BTC backing is read as on-chain total supply ÷ the token's own decimals (8 for WBTC/cbBTC, 18 for tBTC), which equals the BTC held since every wrapper is 1:1 backed. The wrapped-BTC / BTC-on-Ethereum cut — distinct from the coin price feeds, the generic ERC-20 token-info feed and the stablecoin feeds.","sample_wrapper":{"btc":116132.1827,"symbol":"WBTC"},"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T19:35:41.040Z","request_id":"b35d6dca-fa68-4353-bd24-558b94850d96"},"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":1000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1800,"monthly_call_quota":22000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":7100,"monthly_call_quota":142000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":19300,"monthly_call_quota":540000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wrappedbitcoin-api"}