{"openapi":"3.1.0","info":{"title":"Bitcoin Reference Rates API","version":"1.0.0","description":"The value of one bitcoin expressed across every unit CoinGecko tracks — world fiat currencies, precious metals (gold and silver, troy ounce) and other cryptocurrencies, powered by the public CoinGecko exchange-rates feed, no key, nothing stored. This is the \"Bitcoin standard\" / unit-of-account view: not a coin's dollar price, but how much of each asset one BTC buys right now — 1 BTC in US dollars, euros and yen, in ounces of gold and silver, and in ether, satoshi and dozens more. The rates endpoint returns every unit with its value and asset type; the rate endpoint returns one specific unit (gold, the euro, ether); the groups endpoint splits the units into fiat, commodity and crypto so you can see what a bitcoin is worth across asset classes at a glance. This is the Bitcoin-denominated reference-index cut — distinct from the coin-price converters, the market-overview and the per-exchange ticker APIs in the catalogue.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/btcrates-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Rate"},{"name":"Groups"},{"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/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"One BTC valued in every unit","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BTC","note":"Value is the amount of `unit` that one BTC is worth.","count":76,"rates":[{"name":"United Arab Emirates Dirham","type":"fiat","unit":"AED","value":229952.336},{"name":"Armenian Dram","type":"fiat","unit":"AMD","value":23064410.575},{"name":"Argentine Peso","type":"fiat","unit":"ARS","value":89442885.421},{"name":"Australian Dollar","type":"fiat","unit":"AUD","value":89521.803},{"name":"Bosnia and Herzegovina Convertible Mark","type":"fiat","unit":"BAM","value":106126.777},{"name":"Bitcoin Cash","type":"crypto","unit":"BCH","value":313.503},{"name":"Bangladeshi Taka","type":"fiat","unit":"BDT","value":7696509.624},{"name":"Bahraini Dinar","type":"fiat","unit":"BHD","value":23615.071},{"name":"Bits","type":"crypto","unit":"BITS","value":1000000},{"name":"Bermudian Dollar","type":"fiat","unit":"BMD","value":62603.579},{"name":"Binance Coin","type":"crypto","unit":"BNB","value":104.571},{"name":"Brazil Real","type":"fiat","unit":"BRL","value":323334.965},{"name":"Bitcoin","type":"crypto","unit":"BTC","value":1},{"name":"Canadian Dollar","type":"fiat","unit":"CAD","value":87677.564},{"name":"Swiss Franc","type":"fiat","unit":"CHF","value":50124.87},{"name":"Chilean Peso","type":"fiat","unit":"CLP","value":57026226.273},{"name":"Chinese Yuan","type":"fiat","unit":"CNY","value":424158.029},{"name":"Colombian Peso","type":"fiat","unit":"COP","value":220183673.737},{"name":"Costa Rican Colón","type":"fiat","unit":"CRC","value":28722427.389},{"name":"Czech Koruna","type":"fiat","unit":"CZK","value":1316423.742},{"name":"Danish Krone","type":"fiat","unit":"DKK","value":406539.066},{"name":"Dominican Peso","type":"fiat","unit":"DOP","value":3666524.22},{"name":"Polkadot","type":"crypto","unit":"DOT","value":66178.926},{"name":"EOS","type":"crypto","unit":"EOS","value":880073.187},{"name":"Ether","type":"crypto","unit":"ETH","value":38.129},{"name":"Euro","type":"fiat","unit":"EUR","value":54391.053},{"name":"British Pound Sterling","type":"fiat","unit":"GBP","value":46954.938},{"name":"Georgian Lari","type":"fiat","unit":"GEL","value":165899.484},{"name":"Guatemalan Quetzal","type":"fiat","unit":"GTQ","value":476966.214},{"name":"Hong Kong Dollar","type":"fiat","unit":"HKD","value":490625.814},{"name":"Honduran Lempira","type":"fiat","unit":"HNL","value":1672800.31},{"name":"Hungarian Forint","type":"fiat","unit":"HUF","value":19317930.734},{"name":"Indonesian Rupiah","type":"fiat","unit":"IDR","value":1126139764.401},{"name":"Israeli New Shekel","type":"fiat","unit":"ILS","value":185526.332},{"name":"Indian Rupee","type":"fiat","unit":"INR","value":5996856.193},{"name":"Japanese Yen","type":"fiat","unit":"JPY","value":10049376.937},{"name":"Kenyan Shilling","type":"fiat","unit":"KES","value":8116554.017},{"name":"South Korean Won","type":"fiat","unit":"KRW","value":95874611.179},{"name":"Kuwaiti Dinar","type":"fiat","unit":"KWD","value":19325.599},{"name":"Lebanese Pound","type":"fiat","unit":"LBP","value":5602728698.255},{"name":"Chainlink","type":"crypto","unit":"LINK","value":8090.131},{"name":"Sri Lankan Rupee","type":"fiat","unit":"LKR","value":20851861.91},{"name":"Litecoin","type":"crypto","unit":"LTC","value":1483.155},{"name":"Burmese Kyat","type":"fiat","unit":"MMK","value":131455621.511},{"name":"Mexican Peso","type":"fiat","unit":"MXN","value":1088179.857},{"name":"Malaysian Ringgit","type":"fiat","unit":"MYR","value":254627.537},{"name":"Nigerian Naira","type":"fiat","unit":"NGN","value":85200967.064},{"name":"Norwegian Krone","type":"fiat","unit":"NOK","value":596182.711},{"name":"New Zealand Dollar","type":"fiat","unit":"NZD","value":108364.416},{"name":"Peruvian Sol","type":"fiat","unit":"PEN","value":212869.447},{"name":"Philippine Peso","type":"fiat","unit":"PHP","value":3844579.7},{"name":"Pakistani Rupee","type":"fiat","unit":"PKR","value":17412133.484},{"name":"Polish Zloty","type":"fiat","unit":"PLN","value":231812.038},{"name":"Romanian Leu","type":"fiat","unit":"RON","value":284940.19},{"name":"Russian Ruble","type":"fiat","unit":"RUB","value":4510469.243},{"name":"Saudi Riyal","type":"fiat","unit":"SAR","value":235056.594},{"name":"Satoshi","type":"crypto","unit":"SATS","value":100000000},{"name":"Swedish Krona","type":"fiat","unit":"SEK","value":598285.377},{"name":"Singapore Dollar","type":"fiat","unit":"SGD","value":80702.273},{"name":"Solana","type":"crypto","unit":"SOL","value":955.433},{"name":"Salvadoran Colón","type":"fiat","unit":"SVC","value":547502.543},{"name":"Thai Baht","type":"fiat","unit":"THB","value":2065792.904},{"name":"Turkish Lira","type":"fiat","unit":"TRY","value":2889437.018},{"name":"New Taiwan Dollar","type":"fiat","unit":"TWD","value":1981528.549},{"name":"Ukrainian hryvnia","type":"fiat","unit":"UAH","value":2811721.185},{"name":"US Dollar","type":"fiat","unit":"USD","value":62603.579},{"name":"Venezuelan bolívar fuerte","type":"fiat","unit":"VEF","value":6268.496},{"name":"Vietnamese đồng","type":"fiat","unit":"VND","value":1648113208.487},{"name":"Silver - Troy Ounce","type":"commodity","unit":"XAG","value":980.465},{"name":"Gold - Troy Ounce","type":"commodity","unit":"XAU","value":15.337},{"name":"IMF Special Drawing Rights","type":"fiat","unit":"XDR","value":44249.774},{"name":"Lumens","type":"crypto","unit":"XLM","value":335224.999},{"name":"XRP","type":"crypto","unit":"XRP","value":56458.296},{"name":"Yearn.finance","type":"crypto","unit":"YFI","value":33.331},{"name":"South African Rand","type":"fiat","unit":"ZAR","value":1034460.54},{"name":"Zambian Kwacha","type":"fiat","unit":"ZMW","value":1080911.016}],"source":"CoinGecko"},"meta":{"timestamp":"2026-06-11T16:46:45.591Z","request_id":"faf6e6de-8ce6-447d-8f9a-09e4e770f78c"},"status":"ok","message":"Rates 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/rate":{"get":{"operationId":"get_v1_rate","tags":["Rate"],"summary":"One BTC valued in a single unit","description":"","parameters":[{"name":"unit","in":"query","required":true,"description":"CoinGecko unit code","schema":{"type":"string"},"example":"xau"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BTC","name":"Gold - Troy Ounce","type":"commodity","unit":"XAU","value":15.337,"source":"CoinGecko"},"meta":{"timestamp":"2026-06-11T16:46:45.704Z","request_id":"451dce90-1a8d-4c8a-82a7-ec7c608851bf"},"status":"ok","message":"Rate 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/groups":{"get":{"operationId":"get_v1_groups","tags":["Groups"],"summary":"Units split into fiat, commodity, crypto","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BTC","fiat":[{"name":"United Arab Emirates Dirham","type":"fiat","unit":"AED","value":229952.336},{"name":"Armenian Dram","type":"fiat","unit":"AMD","value":23064410.575},{"name":"Argentine Peso","type":"fiat","unit":"ARS","value":89442885.421},{"name":"Australian Dollar","type":"fiat","unit":"AUD","value":89521.803},{"name":"Bosnia and Herzegovina Convertible Mark","type":"fiat","unit":"BAM","value":106126.777},{"name":"Bangladeshi Taka","type":"fiat","unit":"BDT","value":7696509.624},{"name":"Bahraini Dinar","type":"fiat","unit":"BHD","value":23615.071},{"name":"Bermudian Dollar","type":"fiat","unit":"BMD","value":62603.579},{"name":"Brazil Real","type":"fiat","unit":"BRL","value":323334.965},{"name":"Canadian Dollar","type":"fiat","unit":"CAD","value":87677.564},{"name":"Swiss Franc","type":"fiat","unit":"CHF","value":50124.87},{"name":"Chilean Peso","type":"fiat","unit":"CLP","value":57026226.273},{"name":"Chinese Yuan","type":"fiat","unit":"CNY","value":424158.029},{"name":"Colombian Peso","type":"fiat","unit":"COP","value":220183673.737},{"name":"Costa Rican Colón","type":"fiat","unit":"CRC","value":28722427.389},{"name":"Czech Koruna","type":"fiat","unit":"CZK","value":1316423.742},{"name":"Danish Krone","type":"fiat","unit":"DKK","value":406539.066},{"name":"Dominican Peso","type":"fiat","unit":"DOP","value":3666524.22},{"name":"Euro","type":"fiat","unit":"EUR","value":54391.053},{"name":"British Pound Sterling","type":"fiat","unit":"GBP","value":46954.938},{"name":"Georgian Lari","type":"fiat","unit":"GEL","value":165899.484},{"name":"Guatemalan Quetzal","type":"fiat","unit":"GTQ","value":476966.214},{"name":"Hong Kong Dollar","type":"fiat","unit":"HKD","value":490625.814},{"name":"Honduran Lempira","type":"fiat","unit":"HNL","value":1672800.31},{"name":"Hungarian Forint","type":"fiat","unit":"HUF","value":19317930.734},{"name":"Indonesian Rupiah","type":"fiat","unit":"IDR","value":1126139764.401},{"name":"Israeli New Shekel","type":"fiat","unit":"ILS","value":185526.332},{"name":"Indian Rupee","type":"fiat","unit":"INR","value":5996856.193},{"name":"Japanese Yen","type":"fiat","unit":"JPY","value":10049376.937},{"name":"Kenyan Shilling","type":"fiat","unit":"KES","value":8116554.017},{"name":"South Korean Won","type":"fiat","unit":"KRW","value":95874611.179},{"name":"Kuwaiti Dinar","type":"fiat","unit":"KWD","value":19325.599},{"name":"Lebanese Pound","type":"fiat","unit":"LBP","value":5602728698.255},{"name":"Sri Lankan Rupee","type":"fiat","unit":"LKR","value":20851861.91},{"name":"Burmese Kyat","type":"fiat","unit":"MMK","value":131455621.511},{"name":"Mexican Peso","type":"fiat","unit":"MXN","value":1088179.857},{"name":"Malaysian Ringgit","type":"fiat","unit":"MYR","value":254627.537},{"name":"Nigerian Naira","type":"fiat","unit":"NGN","value":85200967.064},{"name":"Norwegian Krone","type":"fiat","unit":"NOK","value":596182.711},{"name":"New Zealand Dollar","type":"fiat","unit":"NZD","value":108364.416},{"name":"Peruvian Sol","type":"fiat","unit":"PEN","value":212869.447},{"name":"Philippine Peso","type":"fiat","unit":"PHP","value":3844579.7},{"name":"Pakistani Rupee","type":"fiat","unit":"PKR","value":17412133.484},{"name":"Polish Zloty","type":"fiat","unit":"PLN","value":231812.038},{"name":"Romanian Leu","type":"fiat","unit":"RON","value":284940.19},{"name":"Russian Ruble","type":"fiat","unit":"RUB","value":4510469.243},{"name":"Saudi Riyal","type":"fiat","unit":"SAR","value":235056.594},{"name":"Swedish Krona","type":"fiat","unit":"SEK","value":598285.377},{"name":"Singapore Dollar","type":"fiat","unit":"SGD","value":80702.273},{"name":"Salvadoran Colón","type":"fiat","unit":"SVC","value":547502.543},{"name":"Thai Baht","type":"fiat","unit":"THB","value":2065792.904},{"name":"Turkish Lira","type":"fiat","unit":"TRY","value":2889437.018},{"name":"New Taiwan Dollar","type":"fiat","unit":"TWD","value":1981528.549},{"name":"Ukrainian hryvnia","type":"fiat","unit":"UAH","value":2811721.185},{"name":"US Dollar","type":"fiat","unit":"USD","value":62603.579},{"name":"Venezuelan bolívar fuerte","type":"fiat","unit":"VEF","value":6268.496},{"name":"Vietnamese đồng","type":"fiat","unit":"VND","value":1648113208.487},{"name":"IMF Special Drawing Rights","type":"fiat","unit":"XDR","value":44249.774},{"name":"South African Rand","type":"fiat","unit":"ZAR","value":1034460.54},{"name":"Zambian Kwacha","type":"fiat","unit":"ZMW","value":1080911.016}],"note":"One BTC valued across asset classes: fiat currencies, precious metals (gold/silver), and other cryptocurrencies.","counts":{"fiat":60,"crypto":14,"commodity":2},"crypto":[{"name":"Bitcoin Cash","type":"crypto","unit":"BCH","value":313.503},{"name":"Bits","type":"crypto","unit":"BITS","value":1000000},{"name":"Binance Coin","type":"crypto","unit":"BNB","value":104.571},{"name":"Bitcoin","type":"crypto","unit":"BTC","value":1},{"name":"Polkadot","type":"crypto","unit":"DOT","value":66178.926},{"name":"EOS","type":"crypto","unit":"EOS","value":880073.187},{"name":"Ether","type":"crypto","unit":"ETH","value":38.129},{"name":"Chainlink","type":"crypto","unit":"LINK","value":8090.131},{"name":"Litecoin","type":"crypto","unit":"LTC","value":1483.155},{"name":"Satoshi","type":"crypto","unit":"SATS","value":100000000},{"name":"Solana","type":"crypto","unit":"SOL","value":955.433},{"name":"Lumens","type":"crypto","unit":"XLM","value":335224.999},{"name":"XRP","type":"crypto","unit":"XRP","value":56458.296},{"name":"Yearn.finance","type":"crypto","unit":"YFI","value":33.331}],"source":"CoinGecko","commodity":[{"name":"Silver - Troy Ounce","type":"commodity","unit":"XAG","value":980.465},{"name":"Gold - Troy Ounce","type":"commodity","unit":"XAU","value":15.337}]},"meta":{"timestamp":"2026-06-11T16:46:45.807Z","request_id":"1862ad1b-897b-4b9d-8d1a-93f581d4d34c"},"status":"ok","message":"Groups 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":"BTC is the base (value 1). unit is a CoinGecko code (usd, eur, xau=gold, xag=silver, eth, sats=satoshi). Results are cached briefly to protect the keyless rate-limited upstream.","source":"CoinGecko exchange rates (api.coingecko.com/api/v3/exchange_rates, live)","btc_usd":62603.579,"service":"btcrates-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One BTC valued in a single unit (unit=xau, unit=usd, unit=eth).","GET /v1/rates":"One BTC valued in every unit (fiat, commodity, crypto), sorted by code.","GET /v1/groups":"Units split into fiat, commodity and crypto — what one BTC buys across asset classes."},"description":"The value of one bitcoin expressed across every unit CoinGecko tracks — world fiat currencies, precious metals (gold/silver, troy ounce) and other cryptocurrencies. The 'Bitcoin standard' / unit-of-account view: how much of each asset one BTC buys right now (1 BTC in dollars, euros, ounces of gold, ether, satoshi…). The rates endpoint returns every unit; the rate endpoint returns one unit; the groups endpoint splits units into fiat, commodity and crypto. Live, no key, nothing stored. The Bitcoin-denominated reference-index cut — distinct from the coin-price converters, market-overview and per-exchange APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T16:46:45.892Z","request_id":"c2861395-cd7f-4cd0-b6f9-f15a8da286bf"},"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":30000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":605,"monthly_call_quota":330000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1845,"monthly_call_quota":1300000,"rps_limit":30,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4390,"monthly_call_quota":4200000,"rps_limit":65,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/btcrates-api"}