# Central Bank of Argentina FX API
> Live official exchange-rate data for the Argentine peso (ARS) from the Central Bank of Argentina (Banco Central de la República Argentina, BCRA) — straight from its public Estadísticas Cambiarias API as clean JSON. Get the BCRA's official quote for every published currency against the peso for the latest business day, with both the peso-per-unit rate and the currency's USD parity; pull a single currency's peso rate, USD parity and the inverse; retrieve a currency's official daily peso rate over any date range from the BCRA's own series; read the BCRA's master list of quoted currencies; or convert an amount between any two quoted currencies (including ARS) cross-computed through the peso. Read live from the BCRA, nothing cached. This is the official Argentine-peso central-bank rate — distinct from the ECB, BCB, SNB, Bank of Canada and other central-bank feeds and from market mid-rates: the BCRA's own published peso quotes.

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

## Pricing
- **Free** (Free) — 750 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 28,000 calls/Mo, 8 req/s
- **Pro** ($25/Mo) — 140,000 calls/Mo, 22 req/s
- **Business** ($59/Mo) — 700,000 calls/Mo, 45 req/s

## Endpoints

### Rates

#### `GET /v1/rates` — Official BCRA quote for every currency vs the peso

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

**Response:**
```json
{
    "data": {
        "base": "ARS",
        "date": "2026-06-09",
        "count": 38,
        "rates": [
            {
                "name": "Dolar Australia",
                "currency": "AUD",
                "usd_parity": 0.703,
                "ars_per_unit": 1013.023,
                "unit_per_ars": 0.0009871444
            },
            {
                "name": "Florin (Antillas Holandesas)",
                "currency": "AWG",
                "usd_parity": 0.558659,
                "ars_per_unit": 805.027933,
                "unit_per_ars": 0.0012421929
            },
            {
                "name": "Bolivianos",
                "currency": "BOB",
                "usd_parity": 0.145497,
                "ars_per_unit": 209.660992,
                "unit_per_ars": 0.0047696044
            },
            {
                "name": "Real",
                "currency": "BRL",
                "usd_parity": 0.193095,
                "ars_per_unit": 278.249788,
                "unit_per_ars": 0.0035938931
            },
            {
                "name": "Dolar Canadien.",
                "currency": "CAD",
                "usd_parity": 0.716743,
                "ars_per_unit": 1032.826835,
                "unit_per_ars": 0.0009682165
            },
            {
                "name": "Franco Suizo",
                "currency": "CHF",
                "usd_parity": 1.253761,
                "ars_per_unit": 1806.67001,
                "unit_per_ars": 0.0005535045

…(truncated, see openapi.json for full schema)
```

### Rate

#### `GET /v1/rate` — One currency's peso rate, USD parity and inverse

**Parameters:**
- `currency` (query, required, string) — ISO 4217 currency code Example: `USD`

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

**Response:**
```json
{
    "data": {
        "base": "ARS",
        "date": "2026-06-09",
        "name": "Dolar E.E.U.U.",
        "source": "Banco Central de la República Argentina",
        "currency": "USD",
        "usd_parity": 0,
        "ars_per_unit": 1441,
        "unit_per_ars": 0.0006939625
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:38.859Z",
        "request_id": "3dc1998d-72c2-4958-9b51-d40e413f3ed9"
    },
    "status": "ok",
    "message": "Rate retrieved successfully",
    "success": true
}
```

### History

#### `GET /v1/history` — A currency's official daily peso rate over a date range

**Parameters:**
- `currency` (query, required, string) — ISO 4217 currency code Example: `USD`
- `from` (query, optional, string) — Start date YYYY-MM-DD Example: `2026-06-01`
- `to` (query, optional, string) — End date YYYY-MM-DD Example: `2026-06-09`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bcra-api/v1/history?currency=USD&from=2026-06-01&to=2026-06-09"
```

**Response:**
```json
{
    "data": {
        "to": "2026-06-09",
        "base": "ARS",
        "from": "2026-06-01",
        "count": 7,
        "source": "Banco Central de la República Argentina",
        "history": [
            {
                "date": "2026-06-01",
                "usd_parity": 0,
                "ars_per_unit": 1426
            },
            {
                "date": "2026-06-02",
                "usd_parity": 0,
                "ars_per_unit": 1427
            },
            {
                "date": "2026-06-03",
                "usd_parity": 0,
                "ars_per_unit": 1438.5
            },
            {
                "date": "2026-06-04",
                "usd_parity": 0,
                "ars_per_unit": 1436.5
            },
            {
                "date": "2026-06-05",
                "usd_parity": 0,
                "ars_per_unit": 1440.5
            },
            {
                "date": "2026-06-08",
                "usd_parity": 0,
                "ars_per_unit": 1446.5
            },
            {
                "date": "2026-06-09",
                "usd_parity": 0,
                "ars_per_unit": 1441
            }
        ],
        "currency": "USD"
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:39.323Z",
        "request_id": "d1a5d843-2500-41a1-9e8b-81fce524831f"
    },
    "status": "ok",
    "message": "History retrieved successfully",
    "success": true
}
```

### Currencies

#### `GET /v1/currencies` — BCRA master list of quoted currencies

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

**Response:**
```json
{
    "data": {
        "count": 44,
        "source": "Banco Central de la República Argentina",
        "currencies": [
            {
                "name": "Peso",
                "currency": "ARS"
            },
            {
                "name": "Chelines Austriacos",
                "currency": "ATS"
            },
            {
                "name": "Dolar Australia",
                "currency": "AUD"
            },
            {
                "name": "Florin (Antillas Holandesas)",
                "currency": "AWG"
            },
            {
                "name": "Bolivianos",
                "currency": "BOB"
            },
            {
                "name": "Real",
                "currency": "BRL"
            },
            {
                "name": "Dolar Canadien.",
                "currency": "CAD"
            },
            {
                "name": "Franco Suizo",
                "currency": "CHF"
            },
            {
                "name": "Peso Chileno",
                "currency": "CLP"
            },
            {
                "name": "Yuan Cnh Renminbi Off Shore",
                "currency": "CNH"
            },
            {
                "name": "Yuan Cny Renminbi",
                "currency": "CNY"
            },
            {
                "name": "Colombianos",
                "currency": "COP"
            },
            {
                "name": "Coronas Checas",
                "currency": "CZK"
            },
      
…(truncated, see openapi.json for full schema)
```

### Convert

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

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

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

**Response:**
```json
{
    "data": {
        "to": "EUR",
        "date": "2026-06-09",
        "from": "USD",
        "rate": 0.86595081,
        "amount": 100,
        "result": 86.595081,
        "source": "Banco Central de la República Argentina",
        "ars_per_to": 1664.0668,
        "ars_per_from": 1441
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:40.639Z",
        "request_id": "2853043f-25eb-41df-b62c-cff327fe138b"
    },
    "status": "ok",
    "message": "Conversion completed successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "date": "2026-06-09",
        "source": "BCRA Estadísticas Cambiarias API (api.bcra.gob.ar, live)",
        "service": "bcra-api",
        "usd_ars": 1441,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's peso rate, USD parity and inverse (currency=USD).",
            "GET /v1/rates": "BCRA official quote for every currency vs the peso (latest business day).",
            "GET /v1/convert": "Convert an amount between two currencies at BCRA rates (from=USD, to=EUR, amount=100).",
            "GET /v1/history": "A currency's official daily peso rate over a date range (currency=USD, from=2026-06-01, to=2026-06-09).",
            "GET /v1/currencies": "BCRA master list of quoted currencies."
        },
        "description": "Live official exchange-rate data for the Argentine peso (ARS) from the Central Bank of Argentina (Banco Central de la República Argentina, BCRA), via its public Estadísticas Cambiarias API. The rates endpoint returns the BCRA's official quote for every published currency against the peso for the latest business day, with the peso-per-unit rate and the currency's USD parity; the rate endpoint returns a single currency's peso rate, USD parity and the inverse; the history endpoint returns a currency's official daily peso rate over a date range; the currencies endpoint returns the BCRA's master list of quoted currencies; the convert endpoint converts an amount between any 
…(truncated, see openapi.json for full schema)
```


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