# BNR exchange-rate history for one currency

Daily BNR fixing series (business days only) for one currency against RON. Maximum range: 366 days per request — paginate by year for longer histories. Defaults: to=today, from=to−30 days. Free of charge.

- REST: `GET https://api.datero.ro/v1/fx-rates/history`
- Tool MCP: `get_fx_rate_history` (endpoint: https://api.datero.ro/mcp)
- Cost: gratuit (0 credite)
- Autentificare: opțională — funcționează și fără cheie (doar rate-limited)

## Parametri

| Nume | În | Tip | Obligatoriu | Descriere |
| --- | --- | --- | --- | --- |
| `currency` | query | string | da | ISO 4217 currency code, e.g. "EUR". |
| `from` | query | string | nu | Range start, YYYY-MM-DD. |
| `to` | query | string | nu | Range end, YYYY-MM-DD. |

## Exemplu: Istoricul EUR pe un interval

Doar zile bancare — weekendul lipsește din serie.

```bash
curl "https://api.datero.ro/v1/fx-rates/history?currency=EUR&from=2026-06-01&to=2026-06-05"
```

Răspuns:

```json
{
  "currency": "EUR",
  "target": "RON",
  "source": "BNR",
  "from": "2026-06-01",
  "to": "2026-06-05",
  "items": [
    {
      "date": "2026-06-02",
      "rate": 5.2556
    },
    {
      "date": "2026-06-03",
      "rate": 5.2592
    },
    {
      "date": "2026-06-04",
      "rate": 5.2581
    },
    {
      "date": "2026-06-05",
      "rate": 5.2488
    }
  ]
}
```

Documentație completă: https://datero.ro/docs/api/fx/history · OpenAPI: https://api.datero.ro/openapi.json
