# Venezuela Bolívar API
> Live exchange rates for the Venezuelan bolívar (VES), one of the world's most-watched hyperinflation currencies. Venezuela runs a two-tier system: the BCV (central bank) official rate and the paralelo (parallel/street) rate, and the gap between them — the brecha — is the headline indicator of the bolívar's stress. The dollar endpoint returns the USD official and parallel rate with the brecha; the euro endpoint does the same for EUR; the rates endpoint returns both currencies at once; the convert endpoint converts any amount between USD, EUR and VES at the official or parallel rate. Read live, nothing stored. This is Venezuela's own official-vs-parallel bolívar layer with a built-in converter — distinct from single-rate central-bank feeds and from other countries' parallel-dollar APIs.

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

## Pricing
- **Free** (Free) — 2,500 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 70,000 calls/Mo, 10 req/s
- **Pro** ($19/Mo) — 350,000 calls/Mo, 30 req/s
- **Scale** ($46/Mo) — 2,200,000 calls/Mo, 100 req/s

## Endpoints

### Rates

#### `GET /v1/dollar` — USD official and parallel rate with the brecha

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

**Response:**
```json
{
    "data": {
        "quote": "VES",
        "source": "ve.dolarapi.com",
        "updated": "2026-06-10T00:00:00-04:00",
        "currency": "USD",
        "official": 572.6784,
        "parallel": 802.0745,
        "brecha_pct": 40.0567
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:29.475Z",
        "request_id": "522c6b79-51a8-4a78-a8ea-83a952a0e237"
    },
    "status": "ok",
    "message": "Dollar retrieved successfully",
    "success": true
}
```

#### `GET /v1/euro` — EUR official and parallel rate with the brecha

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

**Response:**
```json
{
    "data": {
        "quote": "VES",
        "source": "ve.dolarapi.com",
        "updated": "2026-06-10T00:00:00-04:00",
        "currency": "EUR",
        "official": 662.2453,
        "parallel": 925.3667,
        "brecha_pct": 39.7317
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:29.606Z",
        "request_id": "bf0ae774-e1a7-4b12-9c90-850fb8261fc3"
    },
    "status": "ok",
    "message": "Euro retrieved successfully",
    "success": true
}
```

#### `GET /v1/rates` — Both currencies (USD, EUR) at once

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

**Response:**
```json
{
    "data": {
        "quote": "VES",
        "rates": [
            {
                "quote": "VES",
                "updated": "2026-06-10T00:00:00-04:00",
                "currency": "USD",
                "official": 572.6784,
                "parallel": 802.0745,
                "brecha_pct": 40.0567
            },
            {
                "quote": "VES",
                "updated": "2026-06-10T00:00:00-04:00",
                "currency": "EUR",
                "official": 662.2453,
                "parallel": 925.3667,
                "brecha_pct": 39.7317
            }
        ],
        "source": "ve.dolarapi.com"
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:29.776Z",
        "request_id": "04b12dfd-04db-4476-954c-fee2e8b41729"
    },
    "status": "ok",
    "message": "Rates retrieved successfully",
    "success": true
}
```

### Convert

#### `GET /v1/convert` — Convert between USD, EUR and VES

**Parameters:**
- `amount` (query, required, string) — Amount to convert Example: `100`
- `from` (query, optional, string) — From currency (usd, eur, ves) Example: `usd`
- `to` (query, optional, string) — To currency (usd, eur, ves) Example: `ves`
- `rate` (query, optional, string) — official or parallel Example: `parallel`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/venezuela-api/v1/convert?amount=100&from=usd&to=ves&rate=parallel"
```

**Response:**
```json
{
    "data": {
        "to": "VES",
        "from": "USD",
        "amount": 100,
        "result": 80207.45,
        "source": "ve.dolarapi.com",
        "rate_type": "parallel",
        "ves_per_to": 1,
        "ves_per_from": 802.0745
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:29.892Z",
        "request_id": "b40e74c2-526e-411c-9a6a-f88866a88ac5"
    },
    "status": "ok",
    "message": "Conversion completed",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Rates are VES per 1 unit of foreign currency. brecha_pct = (parallel - official) / official * 100.",
        "source": "ve.dolarapi.com (Venezuelan FX aggregator, live)",
        "service": "venezuela-api",
        "endpoints": {
            "GET /v1/euro": "EUR official and parallel rate with the brecha.",
            "GET /v1/meta": "This document.",
            "GET /v1/rates": "Both currencies (USD, EUR) at once.",
            "GET /v1/dollar": "USD official and parallel rate with the brecha.",
            "GET /v1/convert": "Convert an amount between USD, EUR and VES (amount=100, from=usd, to=ves, rate=parallel)."
        },
        "description": "Live exchange rates for the Venezuelan bolívar (VES), one of the world's most-watched hyperinflation currencies. Venezuela runs a two-tier system: the BCV (central bank) official rate and the paralelo (parallel/street) rate; the gap between them — the brecha — is the headline indicator of the bolívar's stress. The dollar endpoint returns the USD official and parallel rate with the brecha; the euro endpoint does the same for EUR; the rates endpoint returns both currencies at once; the convert endpoint converts any amount between USD, EUR and VES at the official or parallel rate. Live, no key, nothing stored. Distinct from single-rate central-bank feeds and from other countries' parallel-dollar APIs — this is Venezuela's own official-vs-parallel bolívar layer with a built-in converter.",
…(truncated, see openapi.json for full schema)
```


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