# FX rates (NGN)

> Naira exchange rates against USD, EUR, GBP, CAD, AUD, CNY, JPY, GHS, ZAR and AED.

```http
GET https://koboterminal.com/api/forex/rates
```

**Plan:** Professional and above (from ₦75,000 / $50 a month).

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `symbols` | query | string | no | Comma-separated currency codes (e.g. `USD,GBP,EUR`) |

## Request

```bash
curl "https://koboterminal.com/api/forex/rates?symbols=USD,GBP,EUR" \
  -H "X-API-Key: $KOBO_API_KEY"
```

```python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/forex/rates",
    params={"symbols": "USD,GBP,EUR"},
    headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
data = r.json()
```

```javascript
const res = await fetch("https://koboterminal.com/api/forex/rates?symbols=USD,GBP,EUR", {
  headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
if (!res.ok) throw new Error(`Kobo API ${res.status}`);
const data = await res.json();
```

## Response

Real response from the live API on 18 November 2026, trimmed to the first item of each list:

```json
{
  "success": true,
  "source": "ExchangeRate API",
  "base_code": "NGN",
  "updated_at": "2026-11-18T00:02:31.000Z",
  "next_update_at": "2026-11-19T00:34:21.000Z",
  "fetched_at": "2026-11-18T22:38:16.259Z",
  "stale": false,
  "rates": {
    "USD": {
      "code": "USD",
      "rate": 1352.74
    },
    "GBP": {
      "code": "GBP",
      "rate": 1785.57
    }
  }
}
```

## Use it from an AI assistant

This endpoint is available as the `get_fx_rates` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp).

## Errors

Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).
