# Central Bank of Myanmar FX API
> Official daily foreign-exchange reference rates published by the Central Bank of Myanmar (CBM), quoted against the Myanmar Kyat (MMK). Read every CBM reference rate in one call, look up a single currency, or convert any amount between two quoted currencies (or MMK) using the central-bank cross rate. CBM follows a per-100 quoting convention for its low-value currencies — Indonesian Rupiah, Japanese Yen, Cambodian Riel, South Korean Won, Lao Kip and Vietnamese Dong are published per 100 units while every other currency is per 1 — so each rate carries both the raw quoted_rate and quoted_per plus a normalized mmk_per_unit, making conversions unambiguous. Rates always resolve to the latest published business-day fixing. Distinct from our other central-bank feeds (Bosnia, North Macedonia, Romania, Moldova, Nepal): this surfaces the Myanmar Kyat reference table specifically.

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

## Pricing
- **Free** (Free) — 1,450 calls/Mo, 2 req/s
- **Basic** ($9/Mo) — 38,700 calls/Mo, 6 req/s
- **Pro** ($27/Mo) — 154,000 calls/Mo, 16 req/s
- **Scale** ($59/Mo) — 623,000 calls/Mo, 40 req/s

## Endpoints

### Rates

#### `GET /v1/latest` — All CBM reference rates

**Parameters:**
- `symbols` (query, optional, string) — Comma-separated currency codes to filter (omit for all) Example: `USD,EUR,THB`

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

**Response:**
```json
{
    "data": {
        "base": "MMK",
        "date": "2026-06-12",
        "count": 3,
        "rates": [
            {
                "base": "MMK",
                "currency": "EUR",
                "quoted_per": 1,
                "quoted_rate": 2429.49,
                "mmk_per_unit": 2429.49
            },
            {
                "base": "MMK",
                "currency": "THB",
                "quoted_per": 1,
                "quoted_rate": 64.08,
                "mmk_per_unit": 64.08
            },
            {
                "base": "MMK",
                "currency": "USD",
                "quoted_per": 1,
                "quoted_rate": 2100,
                "mmk_per_unit": 2100
            }
        ],
        "timestamp": 1781251200
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:28.547Z",
        "request_id": "c6912385-0438-481c-8968-09dd3639adae"
    },
    "status": "ok",
    "message": "Rates retrieved successfully",
    "success": true
}
```

#### `GET /v1/rate` — Reference rate for one currency

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

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

**Response:**
```json
{
    "data": {
        "base": "MMK",
        "date": "2026-06-12",
        "currency": "USD",
        "timestamp": 1781251200,
        "quoted_per": 1,
        "quoted_rate": 2100,
        "mmk_per_unit": 2100
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:28.648Z",
        "request_id": "80b58992-1913-4c79-8573-9b11a3e852d4"
    },
    "status": "ok",
    "message": "Rate retrieved successfully",
    "success": true
}
```

### Convert

#### `GET /v1/convert` — Convert between currencies via the CBM cross rate

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

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

**Response:**
```json
{
    "data": {
        "to": "MMK",
        "base": "MMK",
        "date": "2026-06-12",
        "from": "USD",
        "rate": 2100,
        "amount": 100,
        "result": 210000
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:28.741Z",
        "request_id": "77349792-478f-4c31-9c75-679cf91a32c2"
    },
    "status": "ok",
    "message": "Conversion computed successfully",
    "success": true
}
```

### Reference

#### `GET /v1/currencies` — List quoted currency codes

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

**Response:**
```json
{
    "data": {
        "base": "MMK",
        "date": "2026-06-12",
        "count": 38,
        "currencies": [
            {
                "currency": "AUD",
                "quoted_per": 1
            },
            {
                "currency": "BDT",
                "quoted_per": 1
            },
            {
                "currency": "BND",
                "quoted_per": 1
            },
            {
                "currency": "BRL",
                "quoted_per": 1
            },
            {
                "currency": "CAD",
                "quoted_per": 1
            },
            {
                "currency": "CHF",
                "quoted_per": 1
            },
            {
                "currency": "CNY",
                "quoted_per": 1
            },
            {
                "currency": "CZK",
                "quoted_per": 1
            },
            {
                "currency": "DKK",
                "quoted_per": 1
            },
            {
                "currency": "EGP",
                "quoted_per": 1
            },
            {
                "currency": "EUR",
                "quoted_per": 1
            },
            {
                "currency": "GBP",
                "quoted_per": 1
            },
            {
                "currency": "HKD",
                "quoted_per": 1
            },
            {
                "currency": "IDR",
                "quoted_per": 100
            },
            {
                "currency"
…(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/myanmar-fx-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "name": "Central Bank of Myanmar FX API",
        "source": "Central Bank of Myanmar (forex.cbm.gov.mm)",
        "endpoints": [
            {
                "path": "/v1/latest",
                "description": "All CBM reference rates (optional ?symbols=USD,EUR filter)"
            },
            {
                "path": "/v1/rate",
                "description": "Reference rate for one currency (?code=USD)"
            },
            {
                "path": "/v1/convert",
                "description": "Convert an amount between two quoted currencies or MMK (?from=USD&to=MMK&amount=100)"
            },
            {
                "path": "/v1/currencies",
                "description": "List of quoted currency codes and their quoted_per"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public CBM reference-rate feed. Not affiliated with the Central Bank of Myanmar. Reference rates only; not tradable quotes.",
        "description": "Official daily foreign-exchange reference rates published by the Central Bank of Myanmar (CBM), quoted against the Myanmar Kyat (MMK).",
        "base_currency": "MMK",
        "quantity_note": "CBM quotes IDR, JPY, KHR, KRW, LAK and VND per 100 units; all other currencies per 1 unit. Each rate carries quoted_per plus a normalized mmk_per_unit so conversions are unambiguous.
…(truncated, see openapi.json for full schema)
```


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