> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orqex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exchange rates

> Indicative currency rates for display and estimation.

<Note>
  These rates are indicative, for display and estimation. They are **not** the rates applied
  when a payment is converted. Do not use them to pre-compute what you will be settled.
</Note>

Like every endpoint, both calls require your secret key.

## Latest rates

```
GET /exchange-rates/latest/{baseCurrency}
```

`baseCurrency` is optional and defaults to `USD`.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.orqex.com/v1/exchange-rates/latest/EUR \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```php PHP theme={null}
  $rates = $orqex->exchangeRates()->latest('EUR');

  $rates->base;              // 'EUR'
  $rates->rateFor('USD');    // 1.0542
  ```
</CodeGroup>

```json theme={null}
{
  "data": {
    "base": "EUR",
    "date": "2026-08-02 12:00:00",
    "rates": {
      "USD": 1.0542,
      "GBP": 0.8321
    }
  }
}
```

| Field   | Description                                        |
| ------- | -------------------------------------------------- |
| `base`  | The base currency code.                            |
| `date`  | When the returned set was produced.                |
| `rates` | Map of currency code to rate relative to the base. |

## Quotable currencies

```
GET /exchange-rates/currencies
```

The currencies for which a rate is published.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.orqex.com/v1/exchange-rates/currencies \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```php PHP theme={null}
  $currencies = $orqex->exchangeRates()->supportedCurrencies();
  ```
</CodeGroup>

```json theme={null}
{
  "data": [
    { "name": "Euro", "symbol": "€", "code": "EUR", "icon_url": "https://..." }
  ],
  "meta": {
    "total": 42,
    "last_updated": "2026-08-02 12:00:00"
  }
}
```

| Field               | Description                            |
| ------------------- | -------------------------------------- |
| `name`              | Full currency name.                    |
| `symbol`            | Display symbol.                        |
| `code`              | ISO 4217 code.                         |
| `icon_url`          | Icon for the currency.                 |
| `meta.total`        | Number of currencies returned.         |
| `meta.last_updated` | When the rate data was last refreshed. |

<Note>
  This list is about rate availability, not about what you can charge. Which currencies your
  project can transact in comes from your configuration — see your
  [dashboard](https://app.orqex.com).
</Note>
