# Bank Indonesia Exchange Rates

The official transaction rate board: twenty-six currencies against the rupiah, with buy, sell, and a per-unit mid rate.

- Method: `GET`
- Path: `/v1/fx/rates`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/fx/rates \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "date": "2026-08-18",
    "rates": [
      { "code": "USD", "unit": 1, "sell": 17925.18, "buy": 17746.82, "mid_per_unit": 17836 },
      { "code": "JPY", "unit": 100, "sell": 11260.95, "buy": 11145.4, "mid_per_unit": 112.031775 },
      { "code": "SGD", "unit": 1, "sell": 14013.9, "buy": 13873.37, "mid_per_unit": 13943.635 }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-18T00:00:00.000Z",
    "age_seconds": 42,
    "next_update_at": "2026-08-18T17:35:15.000Z"
  }
}
```