# Central Bank of Armenia (CBA) FX API
> Official Armenian dram (AMD) exchange rates from the Central Bank of Armenia, with no key. Get the latest official rate for every quoted currency (ISO, quoted amount, published rate and day-over-day difference), a single-currency rate, a currency converter and the list of quoted currencies. Rates are normalised to a per-unit AMD value (Rate ÷ Amount), so conversions are correct even for currencies the CBA quotes per 10 or 100 units (e.g. JPY). The Armenian-FX layer for treasury, pricing and FX dashboards.

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

## Pricing
- **Free** (Free) — 1,380 calls/Mo, 2 req/s
- **Basic** ($8/Mo) — 41,800 calls/Mo, 5 req/s
- **Pro** ($25/Mo) — 168,000 calls/Mo, 14 req/s
- **Business** ($53/Mo) — 695,000 calls/Mo, 38 req/s

## Endpoints

### FX

#### `GET /v1/convert` — Convert an amount between two currencies via AMD

**Parameters:**
- `from` (query, required, string) — Source ISO code (or AMD) Example: `USD`
- `to` (query, required, string) — Target ISO code (or AMD) Example: `AMD`
- `amount` (query, optional, string) — Amount to convert Example: `100`

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

**Response:**
```json
{
    "data": {
        "to": "AMD",
        "base": "AMD",
        "date": "2026-06-12",
        "from": "USD",
        "rate": 368.18,
        "amount": 100,
        "result": 36818
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:46.096Z",
        "request_id": "759613b8-aa5a-4165-bba7-fc476d8d6a7b"
    },
    "status": "ok",
    "message": "Conversion retrieved successfully",
    "success": true
}
```

#### `GET /v1/currencies` — All currencies quoted by the CBA

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

**Response:**
```json
{
    "data": {
        "base": "AMD",
        "date": "2026-06-12",
        "count": 30,
        "currencies": [
            "AED",
            "AUD",
            "BRL",
            "BYN",
            "CAD",
            "CHF",
            "CNY",
            "CZK",
            "EUR",
            "GBP",
            "GEL",
            "HKD",
            "INR",
            "IRR",
            "JPY",
            "KGS",
            "KZT",
            "NOK",
            "NZD",
            "PLN",
            "RUB",
            "SEK",
            "SGD",
            "TJS",
            "UAH",
            "USD",
            "UZS",
            "XAG",
            "XAU",
            "XDR"
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:46.186Z",
        "request_id": "8ff19a7f-fff8-4ad9-b39d-72935e1a5830"
    },
    "status": "ok",
    "message": "Currencies retrieved successfully",
    "success": true
}
```

#### `GET /v1/latest` — Latest official AMD rates (all or selected)

**Parameters:**
- `symbols` (query, optional, string) — Comma-separated ISO codes Example: `USD,EUR,RUB`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cba-api/v1/latest?symbols=USD%2CEUR%2CRUB"
```

**Response:**
```json
{
    "data": {
        "base": "AMD",
        "date": "2026-06-12",
        "count": 3,
        "rates": [
            {
                "iso": "USD",
                "rate": 368.18,
                "amount": 1,
                "difference": -0.24,
                "per_unit_amd": 368.18
            },
            {
                "iso": "EUR",
                "rate": 426.09,
                "amount": 1,
                "difference": 1.19,
                "per_unit_amd": 426.09
            },
            {
                "iso": "RUB",
                "rate": 5.0686,
                "amount": 1,
                "difference": -0.0278,
                "per_unit_amd": 5.0686
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:46.267Z",
        "request_id": "926ee921-4ddc-4a40-9a59-bf446042d9f8"
    },
    "status": "ok",
    "message": "Latest rates retrieved successfully",
    "success": true
}
```

#### `GET /v1/rate` — Single-currency AMD rate

**Parameters:**
- `symbol` (query, required, string) — 3-letter ISO code Example: `USD`

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

**Response:**
```json
{
    "data": {
        "iso": "USD",
        "base": "AMD",
        "date": "2026-06-12",
        "rate": 368.18,
        "amount": 1,
        "difference": -0.24,
        "per_unit_amd": 368.18
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:46.348Z",
        "request_id": "eb66e575-5614-4f22-acd9-ac92fbc0acce"
    },
    "status": "ok",
    "message": "Rate retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Bank metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "bank": "Central Bank of Armenia (CBA)",
        "note": "per_unit_amd = Rate / Amount, so conversions are correct even when the CBA quotes a currency per 10 or 100 units.",
        "source": "Central Bank of Armenia SOAP service (api.cba.am/exchangerates.asmx), keyless",
        "country": "Armenia",
        "examples": {
            "rate": "/v1/rate?symbol=USD",
            "latest": "/v1/latest?symbols=USD,EUR,RUB",
            "convert": "/v1/convert?from=USD&to=AMD&amount=100",
            "currencies": "/v1/currencies"
        },
        "endpoints": {
            "/v1/rate": "single-currency rate with amount, rate and per-unit AMD value (symbol=USD)",
            "/v1/latest": "latest official AMD rates for all (or selected) currencies (symbols optional)",
            "/v1/convert": "convert an amount between any two quoted currencies via AMD (from, to, amount)",
            "/v1/currencies": "all currencies quoted by the CBA"
        },
        "cache_ttl_ms": 300000,
        "base_currency": "AMD"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:46.446Z",
        "request_id": "2bc48ab5-6439-43c5-8a00-29bba4b53405"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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