# 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"
```

### 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"
```

### 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"
```

### Currencies

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

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

### Meta

#### `GET /v1/meta` — Service metadata

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


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