# Currency Converter API
> Live foreign-exchange conversion across 160+ world currencies — the plain, developer-friendly converter. Get the latest rates for any base currency, convert an amount between any two currencies, read the rate (and inverse) for a single pair, or list every supported currency. Rates are read live from an open exchange-rate source that aggregates a broad set of feeds and covers far more currencies than ECB-only data — including emerging-market and exotic currencies such as the Nigerian naira, Indian rupee or Vietnamese dong. This is the everyday convert / latest-rates utility a checkout, invoice, pricing page or travel app needs — distinct from the FX analytics APIs in the catalogue (historical date ranges, pip and position-size calculators, triangular-arbitrage path maths, currency indices), which compute on rates rather than simply converting them.

## 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/currencyconverter-api/..."
```

## Pricing
- **Free** (Free) — 30,000 calls/Mo, 3 req/s
- **Starter** ($7/Mo) — 420,000 calls/Mo, 10 req/s
- **Growth** ($21/Mo) — 1,900,000 calls/Mo, 25 req/s
- **Scale** ($50/Mo) — 6,200,000 calls/Mo, 50 req/s

## Endpoints

### Convert

#### `GET /v1/convert` — Convert an amount between two currencies

**Parameters:**
- `from` (query, required, string) — Source ISO 4217 code Example: `USD`
- `to` (query, required, string) — Target ISO 4217 code Example: `EUR`
- `amount` (query, optional, string) — Amount to convert Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/currencyconverter-api/v1/convert?from=USD&to=EUR&amount=100"
```

**Response:**
```json
{
    "data": {
        "to": "EUR",
        "from": "USD",
        "rate": 0.866606,
        "amount": 100,
        "result": 86.6606,
        "source": "open.er-api.com",
        "last_update": "Thu, 11 Jun 2026 00:02:31 +0000",
        "next_update": "Fri, 12 Jun 2026 00:14:21 +0000"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:43.214Z",
        "request_id": "e37c6431-e5e7-4ea5-ba4c-30ae419bf44b"
    },
    "status": "ok",
    "message": "Conversion computed successfully",
    "success": true
}
```

### Rate

#### `GET /v1/rate` — Rate for one pair (with inverse)

**Parameters:**
- `from` (query, required, string) — Base ISO 4217 code Example: `GBP`
- `to` (query, required, string) — Quote ISO 4217 code Example: `JPY`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/currencyconverter-api/v1/rate?from=GBP&to=JPY"
```

**Response:**
```json
{
    "data": {
        "to": "JPY",
        "from": "GBP",
        "rate": 214.659824,
        "source": "open.er-api.com",
        "inverse": 0.00465853,
        "last_update": "Thu, 11 Jun 2026 00:02:31 +0000",
        "next_update": "Fri, 12 Jun 2026 00:15:41 +0000"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:43.321Z",
        "request_id": "f46637b0-de61-49a3-9a4c-8d93eb4e3fb8"
    },
    "status": "ok",
    "message": "Rate retrieved successfully",
    "success": true
}
```

### Latest

#### `GET /v1/latest` — All latest rates for a base currency

**Parameters:**
- `base` (query, optional, string) — Base ISO 4217 code Example: `USD`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/currencyconverter-api/v1/latest?base=USD"
```

**Response:**
```json
{
    "data": {
        "base": "USD",
        "count": 166,
        "rates": {
            "AED": 3.6725,
            "AFN": 63.65262,
            "ALL": 82.389172,
            "AMD": 368.343288,
            "ANG": 1.79,
            "AOA": 924.18781,
            "ARS": 1436.585,
            "AUD": 1.427646,
            "AWG": 1.79,
            "AZN": 1.70039,
            "BAM": 1.694932,
            "BBD": 2,
            "BDT": 122.796094,
            "BGN": 1.694932,
            "BHD": 0.376,
            "BIF": 2986.749226,
            "BMD": 1,
            "BND": 1.287529,
            "BOB": 6.927598,
            "BRL": 5.177643,
            "BSD": 1,
            "BTN": 95.368757,
            "BWP": 13.75985,
            "BYN": 2.761446,
            "BZD": 2,
            "CAD": 1.393628,
            "CDF": 2290.268959,
            "CHF": 0.79938,
            "CLF": 0.023219,
            "CLP": 917.768614,
            "CNH": 6.778247,
            "CNY": 6.789317,
            "COP": 3574.183634,
            "CRC": 459.864392,
            "CUP": 24,
            "CVE": 95.556207,
            "CZK": 20.953331,
            "DJF": 177.721,
            "DKK": 6.467987,
            "DOP": 58.376638,
            "DZD": 133.756244,
            "EGP": 51.806516,
            "ERN": 15,
            "ETB": 157.940622,
            "EUR": 0.866606,
            "FJD": 2.221373,
            "FKP": 0.747629,
            "FOK": 6.468297,
            "GBP": 0.74763,
            "GEL": 2.654322,
…(truncated, see openapi.json for full schema)
```

### Currencies

#### `GET /v1/currencies` — List of supported currencies

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/currencyconverter-api/v1/currencies"
```

**Response:**
```json
{
    "data": {
        "count": 166,
        "source": "open.er-api.com",
        "currencies": [
            "AED",
            "AFN",
            "ALL",
            "AMD",
            "ANG",
            "AOA",
            "ARS",
            "AUD",
            "AWG",
            "AZN",
            "BAM",
            "BBD",
            "BDT",
            "BGN",
            "BHD",
            "BIF",
            "BMD",
            "BND",
            "BOB",
            "BRL",
            "BSD",
            "BTN",
            "BWP",
            "BYN",
            "BZD",
            "CAD",
            "CDF",
            "CHF",
            "CLF",
            "CLP",
            "CNH",
            "CNY",
            "COP",
            "CRC",
            "CUP",
            "CVE",
            "CZK",
            "DJF",
            "DKK",
            "DOP",
            "DZD",
            "EGP",
            "ERN",
            "ETB",
            "EUR",
            "FJD",
            "FKP",
            "FOK",
            "GBP",
            "GEL",
            "GGP",
            "GHS",
            "GIP",
            "GMD",
            "GNF",
            "GTQ",
            "GYD",
            "HKD",
            "HNL",
            "HRK",
            "HTG",
            "HUF",
            "IDR",
            "ILS",
            "IMP",
            "INR",
            "IQD",
            "IRR",
            "ISK",
            "JEP",
            "JMD",
            "JOD",
            "JPY",
            "K
…(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/currencyconverter-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Currency codes are ISO 4217 (USD, EUR, NGN…). Rates are quoted per one unit of the base currency. Data refreshes once a day; values are cached briefly to protect the keyless upstream.",
        "source": "open.er-api.com (live, updated daily)",
        "service": "currencyconverter-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "Rate for one pair, with the inverse (from=USD&to=EUR).",
            "GET /v1/latest": "All rates for a base currency (base=USD).",
            "GET /v1/convert": "Convert an amount between two currencies (from=USD&to=EUR&amount=100).",
            "GET /v1/currencies": "List of supported currency codes."
        },
        "description": "Live foreign-exchange conversion across 160+ world currencies — latest rates for any base, convert an amount between any two currencies, the rate for a single pair, and the supported-currency list. Rates are read live from the open Exchange Rate API, covering far more currencies than ECB-only feeds (including emerging-market and exotic currencies). The everyday convert/latest utility, distinct from the FX analytics APIs (historical ranges, pip/position calculators, triangular-arbitrage maths, indices).",
        "currency_count": 166,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:43.548Z",
        "request_id": "ebc83c7e-6588-45b1-b9c8-7d32f2822a54"
    },
    "status": "ok",
   
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/currencyconverter-api
OpenAPI spec: https://www.oanor.com/api/currencyconverter-api/openapi.json