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

# POST /v1/exchange-rate/list

Возвращает текущие обменные курсы к **USDT**.

<Note>
  **Публичный метод.** Подпись и ключ не нужны — это витринные котировки, а не финансовая операция.
  Отличие от Heleket: здесь это `POST /v1/exchange-rate/list` (не
  `GET /v1/exchange-rate/{currency}/list`), и котировка даётся **к USDT**, а не к USD.
</Note>

**URL:** `https://api.oblodai.com/v1/exchange-rate/list`

***

## Параметры запроса

Тело опционально.

<ParamField body="currency_from" type="string">
  Код валюты. Если задан — вернётся курс только по нему. Если пусто или тело `{}` — по всем валютам.
</ParamField>

***

## Пример запроса

По всем валютам — тело `{}`. По одной валюте:

<CodeGroup>
  ```bash cURL theme={null}
  curl -s https://api.oblodai.com/v1/exchange-rate/list \
    -X POST \
    -H 'Content-Type: application/json' \
    -d '{"currency_from":"ETH"}'
  ```

  ```python Python theme={null}
  import requests

  r = requests.post("https://api.oblodai.com/v1/exchange-rate/list",
                    json={"currency_from": "ETH"})
  print(r.json())
  ```

  ```js Node.js theme={null}
  const res = await fetch("https://api.oblodai.com/v1/exchange-rate/list", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ currency_from: "ETH" }),
  });
  console.log(await res.json());
  ```
</CodeGroup>

***

## Пример ответа

```json theme={null}
{
  "state": 0,
  "result": [
    { "from": "ETH", "to": "USDT", "course": "3450.12000000" }
  ]
}
```

<ResponseField name="from" type="string">
  Валюта, для которой дана котировка.
</ResponseField>

<ResponseField name="to" type="string">
  Всегда `USDT`.
</ResponseField>

<ResponseField name="course" type="string">
  Курс строкой с фиксированной точностью.
</ResponseField>

***

## Нюансы

* **Неизвестная `currency_from`** вернёт пустой `result: []`, а не ошибку.
* **Пары без котировки** просто опускаются из ответа.
* Курс — **оценочная** рыночная котировка для отображения, не гарантия исполнения. Фактический курс
  платежа фиксируется при создании инвойса (см. [`POST /v1/payment`](/reference/payment-create)).

***

## Связанные страницы

<CardGroup cols={2}>
  <Card title="Форматы сумм и денег" href="/reference/basics-money" icon="arrow-right" horizontal />

  <Card title="POST /v1/payment" href="/reference/payment-create" icon="arrow-right" horizontal>
    там курс фиксируется под конкретный счёт.
  </Card>
</CardGroup>