# Yadio Real FX API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/yadio-api/..." ``` ## Pricing - **Free** (Free) — 3,500 calls/Mo, 3 req/s - **Starter** ($7/Mo) — 90,000 calls/Mo, 12 req/s - **Pro** ($21/Mo) — 450,000 calls/Mo, 35 req/s - **Scale** ($48/Mo) — 2,800,000 calls/Mo, 110 req/s ## Endpoints ### Convert #### `GET /v1/convert` — Convert an amount between two currencies **Parameters:** - `amount` (query, required, string) — Amount to convert Example: `100` - `from` (query, optional, string) — From currency code Example: `USD` - `to` (query, optional, string) — To currency code Example: `ARS` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/yadio-api/v1/convert?amount=100&from=USD&to=ARS" ``` **Response:** ```json { "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 } ``` ### Rates #### `GET /v1/rates` — One base currency against ~130 currencies **Parameters:** - `base` (query, optional, string) — Base currency code Example: `USD` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/yadio-api/v1/rates?base=USD" ``` **Response:** ```json { "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, …(truncated, see openapi.json for full schema) ``` ### BTC #### `GET /v1/btc` — BTC price in a chosen currency **Parameters:** - `currency` (query, optional, string) — Currency code Example: `USD` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/yadio-api/v1/btc?currency=USD" ``` **Response:** ```json { "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 } ``` ### Currencies #### `GET /v1/currencies` — Every supported currency **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/yadio-api/v1/currencies" ``` **Response:** ```json { "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", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/yadio-api/v1/meta" ``` **Response:** ```json { "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, …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/yadio-api OpenAPI spec: https://www.oanor.com/api/yadio-api/openapi.json