{"openapi":"3.1.0","info":{"title":"Yadio Real FX API","version":"1.0.0","description":"Live \"real\" market exchange rates derived from local cryptocurrency (BTC/USDT) trading. Because they are implied by where people actually buy and sell crypto, these rates track the true street/parallel value of a currency — for stressed currencies (Argentine peso, Nigerian naira, Venezuelan bolívar, Lebanese pound …) this is far from the official rate. The rates endpoint returns one base currency against ~130 currencies plus the BTC price; the convert endpoint converts any amount between two currencies; the btc endpoint returns the BTC price in a chosen currency (the crypto bridge that powers every rate); the currencies endpoint lists every supported currency. Read live, nothing stored. This is a global crypto-implied real-rate layer — distinct from official ECB/central-bank rate feeds and from single-country parallel-dollar APIs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/yadio-api","description":"oanor gateway"}],"tags":[{"name":"Convert"},{"name":"Rates"},{"name":"BTC"},{"name":"Currencies"},{"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/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert an amount between two currencies","description":"","parameters":[{"name":"amount","in":"query","required":true,"description":"Amount to convert","schema":{"type":"string"},"example":"100"},{"name":"from","in":"query","required":false,"description":"From currency code","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":false,"description":"To currency code","schema":{"type":"string"},"example":"ARS"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"ARS","from":"USD","rate":1497.4205,"amount":100,"result":149742.05,"source":"api.yadio.io","timestamp":1781132108131},"meta":{"timestamp":"2026-06-10T22:57:26.200Z","request_id":"5a8d7274-758b-4e0e-987f-c12cf9bca36a"},"status":"ok","message":"Conversion completed","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/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"One base currency against ~130 currencies","description":"","parameters":[{"name":"base","in":"query","required":false,"description":"Base currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"USD","note":"Crypto-implied real market rates; for stressed currencies this tracks the street/parallel rate, not the official one.","count":144,"rates":{"AED":3.6725,"AFN":66.4025,"ALL":75.44125,"AMD":366.6895,"ANG":1.79,"AOA":939.2025,"ARS":1497.4205,"AUD":1.429473,"AWG":1.79,"AZN":1.7,"BAM":1.69518631505,"BBD":2,"BDT":126.83,"BHD":0.376,"BIF":5776.125,"BMD":1,"BND":1.28,"BOB":9.92325,"BRL":5.1909,"BSD":1,"BTC":1.6285064e-5,"BTN":100.358741,"BWP":14.15,"BYN":2.904,"BZD":1,"CAD":1.393617,"CDF":2462.99,"CHF":0.800017,"CLP":917.9194,"CNY":6.7925,"COP":3559.646346,"CRC":465.75375,"CUP":640,"CVE":95.570534775,"CZK":20.977225,"DJF":177.721,"DKK":6.481227,"DOP":59.4925,"DZD":247.0575,"EGP":53.08,"ERN":15,"ETB":180.0195,"EUR":0.866678,"FKP":0.751044,"GBP":0.751357,"GEL":2.656908,"GGP":0.751044,"GHS":12.23875,"GIP":0.751044,"GMD":74.815,"GNF":9491.9725,"GTQ":7.86825,"HKD":7.837162,"HNL":27.46375,"HTG":135.56,"HUF":309.15035,"IDR":18044.38972,"ILS":3.011104,"IMP":0.751044,"INR":100.598046,"IQD":1539.0375,"IRR":1797990,"IRT":179799,"ISK":124.212706,"JEP":0.751044,"JMD":162.9825,"JOD":0.709,"JPY":160.578177,"KES":128.79875,"KGS":88.24375,"KMF":426.40566779625004,"KRW":1507.269444,"KWD":0.31075,"KYD":0.83333,"KZT":491.9168,"LAK":22109.3775,"LBP":89237.49875,"LKR":332.01125,"LRD":183.51625,"LSL":16.6822,"LYD":7.44875,"MAD":9.65375,"MDL":17.44,"MGA":4137.945,"MLC":1.406593,"MNT":3618.2025,"MOP":8.07096567,"MRU":42.2725,"MWK":2189.34,"MXN":17.4324,"MYR":4.081931,"MZN":73.76,"NAD":16.6822,"NGN":1388.425,"NIO":35.515,"NOK":9.47877,"NPR":160.57398560000001,"NZD":1.722287,"OMR":0.38449,"PAB":1,"PEN":3.4153,"PHP":61.4273,"PKR":286.47125,"PLN":3.680775,"PYG":6087.07875,"QAR":3.64,"RON":4.288,"RSD":103.1825,"RUB":75.657591,"RWF":1461.77875,"SAR":3.75,"SDG":4095.9625,"SEK":9.513878,"SGD":1.286878,"SHP":0.751044,"SLE":23.75875,"SYP":124.31,"SZL":16.6822,"THB":32.941472,"TJS":9.39375,"TMT":3.5,"TND":3.1825,"TRY":46.1386,"TTD":8.18,"TWD":31.7138,"TZS":2622.1275,"UAH":44.8993,"UGX":3711.09125,"USD":1,"UYU":42.03375,"UZS":12389.05,"VES":805.2,"VND":26358.25,"XAF":568.54089,"XAG":0.01578532,"XAU":0.000245,"XCD":2.7,"XCG":1.79,"XOF":568.54089,"XPF":103.4289609995,"XPT":0.00060111,"YER":539.895,"ZAR":16.6809,"ZMW":18.32625},"source":"api.yadio.io","btc_price":61405.96,"timestamp":1781132108131},"meta":{"timestamp":"2026-06-10T22:57:26.406Z","request_id":"04a8c004-4062-4e25-826f-66fb8abbebec"},"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/btc":{"get":{"operationId":"get_v1_btc","tags":["BTC"],"summary":"BTC price in a chosen currency","description":"","parameters":[{"name":"currency","in":"query","required":false,"description":"Currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"BTC price in this currency — the crypto bridge Yadio uses to imply the real fiat rate.","source":"api.yadio.io","currency":"USD","btc_price":61405.96,"timestamp":1781132108131},"meta":{"timestamp":"2026-06-10T22:57:26.606Z","request_id":"a2190635-be1b-4575-9aea-ca6908311f7d"},"status":"ok","message":"BTC 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/currencies":{"get":{"operationId":"get_v1_currencies","tags":["Currencies"],"summary":"Every supported currency","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":144,"source":"api.yadio.io","currencies":[{"code":"AED","name":"UAE Dirham"},{"code":"AFN","name":"Afghan Afghani"},{"code":"ALL","name":"Albanian Lek"},{"code":"AMD","name":"Armenian Dram"},{"code":"ANG","name":"Netherlands Antillean Guilder"},{"code":"AOA","name":"Angolan Kwanza"},{"code":"ARS","name":"Argentine Peso"},{"code":"AUD","name":"Australian Dollar"},{"code":"AWG","name":"Aruban Florin"},{"code":"AZN","name":"Azerbaijani Manat"},{"code":"BAM","name":"Bosnia-Herzegovina Convertible Mark"},{"code":"BBD","name":"Barbadian Dollar"},{"code":"BDT","name":"Bangladeshi Taka"},{"code":"BHD","name":"Bahraini Dinar"},{"code":"BIF","name":"Burundian Franc"},{"code":"BMD","name":"Bermudan Dollar"},{"code":"BND","name":"Brunei Dollar"},{"code":"BOB","name":"Bolivian Boliviano"},{"code":"BRL","name":"Brazilian Real"},{"code":"BSD","name":"Bahamian Dollar"},{"code":"BTC","name":"Bitcoin"},{"code":"BTN","name":"Bhutanese Ngultrum"},{"code":"BWP","name":"Botswanan Pula"},{"code":"BYN","name":"Belarusian Ruble"},{"code":"BZD","name":"Belize Dollar"},{"code":"CAD","name":"Canadian Dollar"},{"code":"CDF","name":"Congolese Franc"},{"code":"CHF","name":"Swiss Franc"},{"code":"CLP","name":"Chilean Peso"},{"code":"CNY","name":"Chinese Yuan"},{"code":"COP","name":"Colombian Peso"},{"code":"CRC","name":"Costa Rican Colón"},{"code":"CUP","name":"Cuban Peso"},{"code":"CVE","name":"Cape Verdean Escudo"},{"code":"CZK","name":"Czech Koruna"},{"code":"DJF","name":"Djiboutian Franc"},{"code":"DKK","name":"Danish Krone"},{"code":"DOP","name":"Dominican Peso"},{"code":"DZD","name":"Algerian Dinar"},{"code":"EGP","name":"Egyptian Pound"},{"code":"ERN","name":"Eritrean Nakfa"},{"code":"ETB","name":"Ethiopian Birr"},{"code":"EUR","name":"Euro"},{"code":"FKP","name":"Falkland Islands Pound"},{"code":"GBP","name":"British Pound Sterling"},{"code":"GEL","name":"Georgian Lari"},{"code":"GGP","name":"Guernsey Pound"},{"code":"GHS","name":"Ghanaian Cedi"},{"code":"GIP","name":"Gibraltar Pound"},{"code":"GMD","name":"Gambian Dalasi"},{"code":"GNF","name":"Guinean Franc"},{"code":"GTQ","name":"Guatemalan Quetzal"},{"code":"HKD","name":"Hong Kong Dollar"},{"code":"HNL","name":"Honduran Lempira"},{"code":"HTG","name":"Haitian Gourde"},{"code":"HUF","name":"Hungarian Forint"},{"code":"IDR","name":"Indonesian Rupiah"},{"code":"ILS","name":"Israeli New Sheqel"},{"code":"IMP","name":"Manx pound"},{"code":"INR","name":"Indian Rupee"},{"code":"IQD","name":"Iraqi Dinar"},{"code":"IRR","name":"Iranian Rial"},{"code":"IRT","name":"Iranian Toman"},{"code":"ISK","name":"Icelandic Króna"},{"code":"JEP","name":"Jersey Pound"},{"code":"JMD","name":"Jamaican Dollar"},{"code":"JOD","name":"Jordanian Dinar"},{"code":"JPY","name":"Japanese Yen"},{"code":"KES","name":"Kenyan Shilling"},{"code":"KGS","name":"Kyrgystani Som"},{"code":"KMF","name":"Comorian Franc"},{"code":"KRW","name":"South Korean Won"},{"code":"KWD","name":"Kuwaiti Dinar"},{"code":"KYD","name":"Cayman Islands Dollar"},{"code":"KZT","name":"Kazakhstani Tenge"},{"code":"LAK","name":"Laotian Kip"},{"code":"LBP","name":"Lebanese Pound"},{"code":"LKR","name":"Sri Lankan Rupee"},{"code":"LRD","name":"Liberian Dollar"},{"code":"LSL","name":"Lesotho Loti"},{"code":"LYD","name":"Libyan Dinar"},{"code":"MAD","name":"Moroccan Dirham"},{"code":"MDL","name":"Moldovan Leu"},{"code":"MGA","name":"Malagasy Ariary"},{"code":"MLC","name":"Cuban MLC"},{"code":"MNT","name":"Mongolian Tugrik"},{"code":"MOP","name":"Macanese Pataca"},{"code":"MRU","name":"Mauritanian Ouguiya"},{"code":"MWK","name":"Malawian Kwacha"},{"code":"MXN","name":"Mexican Peso"},{"code":"MYR","name":"Malaysian Ringgit"},{"code":"MZN","name":"Mozambican Metical"},{"code":"NAD","name":"Namibian Dollar"},{"code":"NGN","name":"Nigerian Naira"},{"code":"NIO","name":"Nicaraguan Córdoba"},{"code":"NOK","name":"Norwegian Krone"},{"code":"NPR","name":"Nepalese Rupee"},{"code":"NZD","name":"New Zealand Dollar"},{"code":"OMR","name":"Omani Rial"},{"code":"PAB","name":"Panamanian Balboa"},{"code":"PEN","name":"Peruvian Nuevo Sol"},{"code":"PHP","name":"Philippine Peso"},{"code":"PKR","name":"Pakistani Rupee"},{"code":"PLN","name":"Polish Zloty"},{"code":"PYG","name":"Paraguayan Guarani"},{"code":"QAR","name":"Qatari Rial"},{"code":"RON","name":"Romanian Leu"},{"code":"RSD","name":"Serbian Dinar"},{"code":"RUB","name":"Russian Ruble"},{"code":"RWF","name":"Rwandan Franc"},{"code":"SAR","name":"Saudi Riyal"},{"code":"SDG","name":"Sudanese Pound"},{"code":"SEK","name":"Swedish Krona"},{"code":"SGD","name":"Singapore Dollar"},{"code":"SHP","name":"Saint Helena Pound"},{"code":"SLE","name":"Sierra Leonean Leone"},{"code":"SYP","name":"Syrian Pound"},{"code":"SZL","name":"Swazi Lilangeni"},{"code":"THB","name":"Thai Baht"},{"code":"TJS","name":"Tajikistani Somoni"},{"code":"TMT","name":"Turkmenistani Manat"},{"code":"TND","name":"Tunisian Dinar"},{"code":"TRY","name":"Turkish Lira"},{"code":"TTD","name":"Trinidad and Tobago Dollar"},{"code":"TWD","name":"New Taiwan Dollar"},{"code":"TZS","name":"Tanzanian Shilling"},{"code":"UAH","name":"Ukrainian Hryvnia"},{"code":"UGX","name":"Ugandan Shilling"},{"code":"USD","name":"United States Dollar"},{"code":"UYU","name":"Uruguayan Peso"},{"code":"UZS","name":"Uzbekistan Som"},{"code":"VES","name":"Venezuelan Bolívar Soberano"},{"code":"VND","name":"Vietnamese Dong"},{"code":"XAF","name":"CFA Franc BEAC"},{"code":"XAG","name":"Silver Ounce"},{"code":"XAU","name":"Gold Ounce"},{"code":"XCD","name":"East Caribbean Dollar"},{"code":"XCG","name":"Caribbean Guilder"},{"code":"XOF","name":"CFA Franc BCEAO"},{"code":"XPF","name":"CFP Franc"},{"code":"XPT","name":"Platinum Ounce"},{"code":"YER","name":"Yemeni Rial"},{"code":"ZAR","name":"South African Rand"},{"code":"ZMW","name":"Zambian Kwacha"}]},"meta":{"timestamp":"2026-06-10T22:57:26.811Z","request_id":"13f87e8a-7c3b-4dfb-9a96-4fa5c0bf2af7"},"status":"ok","message":"Currencies 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":{"source":"api.yadio.io (crypto-implied FX, live)","btc_usd":61405.96,"service":"yadio-api","endpoints":{"GET /v1/btc":"BTC price in a chosen currency — the crypto bridge (currency=USD).","GET /v1/meta":"This document.","GET /v1/rates":"One base currency against ~130 currencies plus BTC price (base=USD).","GET /v1/convert":"Convert an amount between two currencies (amount=100, from=USD, to=ARS).","GET /v1/currencies":"Every supported currency (code and name)."},"description":"Live real market exchange rates derived from local cryptocurrency (BTC/USDT) trading. Because they are implied by where people actually buy and sell crypto, Yadio's rates track the true street/parallel value of a currency — for stressed currencies (Argentine peso, Nigerian naira, Venezuelan bolívar …) this is far from the official rate. The rates endpoint returns one base currency against ~130 currencies plus the BTC price; the convert endpoint converts any amount between two currencies; the btc endpoint returns the BTC price in a chosen currency (the crypto bridge that powers every rate); the currencies endpoint lists every supported currency. Live, no key, nothing stored. Distinct from official ECB/central-bank rate feeds and from single-country parallel-dollar APIs — this is a global crypto-implied real-rate layer.","usd_ars_real":1497.4205,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:57:27.017Z","request_id":"53b1be02-322a-4714-813a-4c97a5ccff21"},"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":3500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":90000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2050,"monthly_call_quota":450000,"rps_limit":35,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4800,"monthly_call_quota":2800000,"rps_limit":110,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/yadio-api"}