# Argentina Dólar (Peso) FX API
> Live Argentine peso (ARS) exchange rates across the country's many parallel dollar markets — served as clean JSON, no key, no cache. Argentina runs a famous multi-rate system: alongside the official rate there is the "blue" (informal/parallel) dollar, the MEP/bolsa and CCL (contado con liqui) financial dollars, the wholesale (mayorista) rate, the crypto dollar and the "tarjeta" tourist/card dollar (with taxes). Get the buy and sell rate for every one of these; pull a single dollar type; read the brecha — each rate's premium over the official dollar, the key indicator of Argentina's exchange-rate stress; or get other currencies (EUR, BRL, CLP, UYU) against the peso. Read live, nothing cached. This is Argentina's own multi-rate peso/dollar picture — distinct from the BCRA's official-only feed and from any single-rate central-bank API.

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

## Pricing
- **Free** (Free) — 550 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 23,000 calls/Mo, 8 req/s
- **Pro** ($23/Mo) — 118,000 calls/Mo, 20 req/s
- **Business** ($55/Mo) — 580,000 calls/Mo, 40 req/s

## Endpoints

### Dollars

#### `GET /v1/dollars` — Buy/sell for every dollar type (oficial, blue, mep, ccl, mayorista, cripto, tarjeta)

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

**Response:**
```json
{
    "data": {
        "base": "USD",
        "count": 7,
        "quote": "ARS",
        "source": "dolarapi.com",
        "dollars": [
            {
                "buy": 1405,
                "mid": 1430,
                "name": "Oficial",
                "sell": 1455,
                "type": "oficial",
                "updated": "2026-06-10T17:00:00.000Z"
            },
            {
                "buy": 1430,
                "mid": 1440,
                "name": "Blue",
                "sell": 1450,
                "type": "blue",
                "updated": "2026-06-10T21:00:00.000Z"
            },
            {
                "buy": 1453.1,
                "mid": 1456.2,
                "name": "Bolsa",
                "sell": 1459.3,
                "type": "bolsa",
                "updated": "2026-06-10T21:00:00.000Z"
            },
            {
                "buy": 1508.6,
                "mid": 1509.15,
                "name": "Contado con liquidación",
                "sell": 1509.7,
                "type": "contadoconliqui",
                "updated": "2026-06-10T21:00:00.000Z"
            },
            {
                "buy": 1422,
                "mid": 1426.5,
                "name": "Mayorista",
                "sell": 1431,
                "type": "mayorista",
                "updated": "2026-06-10T14:55:00.000Z"
            },
            {
                "buy": 1500.1,
                "mid": 1500.5,
                "name": "Cripto",
             
…(truncated, see openapi.json for full schema)
```

### Dollar

#### `GET /v1/dollar` — A single dollar type

**Parameters:**
- `type` (query, required, string) — oficial, blue, mep, ccl, mayorista, cripto or tarjeta Example: `blue`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dolar-api/v1/dollar?type=blue"
```

**Response:**
```json
{
    "data": {
        "buy": 1430,
        "mid": 1440,
        "base": "USD",
        "name": "Blue",
        "sell": 1450,
        "type": "blue",
        "quote": "ARS",
        "source": "dolarapi.com",
        "updated": "2026-06-10T21:00:00.000Z"
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:56.060Z",
        "request_id": "5d44cb45-b234-45d3-bead-92016fdf780c"
    },
    "status": "ok",
    "message": "Dollar retrieved successfully",
    "success": true
}
```

### Brecha

#### `GET /v1/brecha` — Each rate's premium over the official dollar (the parallel gap)

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

**Response:**
```json
{
    "data": {
        "base": "USD",
        "quote": "ARS",
        "brecha": [
            {
                "name": "Tarjeta",
                "sell": 1891.5,
                "type": "tarjeta",
                "premium_over_official_pct": 30
            },
            {
                "name": "Contado con liquidación",
                "sell": 1509.7,
                "type": "contadoconliqui",
                "premium_over_official_pct": 3.7595
            },
            {
                "name": "Cripto",
                "sell": 1500.9,
                "type": "cripto",
                "premium_over_official_pct": 3.1546
            },
            {
                "name": "Bolsa",
                "sell": 1459.3,
                "type": "bolsa",
                "premium_over_official_pct": 0.2955
            },
            {
                "name": "Blue",
                "sell": 1450,
                "type": "blue",
                "premium_over_official_pct": -0.3436
            },
            {
                "name": "Mayorista",
                "sell": 1431,
                "type": "mayorista",
                "premium_over_official_pct": -1.6495
            }
        ],
        "source": "dolarapi.com",
        "official_sell": 1455
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:56.174Z",
        "request_id": "6af34dc4-b0c2-4430-a1c9-cdb60581bfcc"
    },
    "status": "ok",
    "message": "Brecha retrieved successfully",
    "success": true
}
```

### Currencies

#### `GET /v1/currencies` — Other currencies vs the peso (EUR, BRL, CLP, UYU)

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

**Response:**
```json
{
    "data": {
        "base": "ARS",
        "count": 5,
        "source": "dolarapi.com",
        "currencies": [
            {
                "buy": 1405,
                "name": "Dólar",
                "sell": 1455,
                "updated": "2026-06-10T16:59:00.000Z",
                "currency": "USD",
                "ars_per_unit": 1455
            },
            {
                "buy": 1642.8614,
                "name": "Euro",
                "sell": 1656.8295,
                "updated": "2026-06-10T16:59:00.000Z",
                "currency": "EUR",
                "ars_per_unit": 1656.8295
            },
            {
                "buy": 276.4546,
                "name": "Real Brasileño",
                "sell": 276.6128,
                "updated": "2026-06-10T16:59:00.000Z",
                "currency": "BRL",
                "ars_per_unit": 276.6128
            },
            {
                "buy": 1.5691,
                "name": "Peso Chileno",
                "sell": 1.5691,
                "updated": "2026-06-10T16:59:00.000Z",
                "currency": "CLP",
                "ars_per_unit": 1.5691
            },
            {
                "buy": 35.3646,
                "name": "Peso Uruguayo",
                "sell": 35.3648,
                "updated": "2026-06-10T16:59:00.000Z",
                "currency": "UYU",
                "ars_per_unit": 35.3648
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:56.318Z
…(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/dolar-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "dolarapi.com (Argentine FX aggregator, live)",
        "service": "dolar-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/brecha": "Each rate's premium over the official dollar (the parallel gap).",
            "GET /v1/dollar": "A single dollar type (type=blue).",
            "GET /v1/dollars": "Buy/sell for every dollar type (oficial, blue, mep, ccl, mayorista, cripto, tarjeta).",
            "GET /v1/currencies": "Other currencies vs the peso (EUR, BRL, CLP, UYU)."
        },
        "description": "Live Argentine peso (ARS) exchange rates across the country's many parallel dollar markets. Argentina runs a famous multi-rate system: alongside the official rate there is the blue (informal/parallel) dollar, the MEP/bolsa and CCL financial dollars, the wholesale (mayorista) rate, the crypto dollar and the tarjeta tourist/card dollar (with taxes). The dollars endpoint returns the buy/sell rate for every type; the dollar endpoint returns a single type; the brecha endpoint returns each rate's premium over the official dollar (the key stress indicator); the currencies endpoint returns other currencies (EUR, BRL, CLP, UYU) against the peso. Live, no key, nothing stored. Distinct from the BCRA's official-only feed and from any single-rate central-bank API — this is Argentina's full multi-rate peso/dollar picture.",
        "blue_sell_ars": 1450,
        "upstream_status": "ok",
        "oficial_sell_
…(truncated, see openapi.json for full schema)
```


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