> ## 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.

# GET /v1/currencies

Публичный каталог принимаемых активов и сетей, на которых их можно оплачивать/выводить — данные для
страницы «Наши монеты» или для построения списка выбора валюты в чекауте.

Отдаёт **два списка**: `currencies` — в чём можно **получать** (валюты расчёта, только крипта), и
`pricing_currencies` — в чём можно **назначать цену** (**38 записей: 15 монет + 23 фиата**). Разница
между ролями — [Форматы сумм и денег](/reference/basics-money).

**URL:** `https://api.oblodai.com/v1/currencies` · **Метод:** `GET` · **Аутентификация:** не
требуется (публичные данные).

***

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

Нет. Обычный `GET` без тела и без подписи.

***

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

<CodeGroup>
  ```bash cURL theme={null}
  curl -s https://api.oblodai.com/v1/currencies
  ```

  ```python Python theme={null}
  import requests
  r = requests.get("https://api.oblodai.com/v1/currencies")
  print(r.json())
  ```

  ```js Node.js theme={null}
  const r = await fetch("https://api.oblodai.com/v1/currencies");
  console.log(await r.json());
  ```
</CodeGroup>

***

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

Ответ отдаётся **напрямую** (без конверта `{state, result}`, как у публичных `GET`-эндпоинтов):

```json theme={null}
{
  "currencies": [
    {
      "symbol": "USDT",
      "decimals": 6,
      "networks": [
        {
          "network": "tron",
          "kind": "token",
          "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
          "min_confirmations": 20,
          "available": true,
          "deposit_available": true,
          "payout_available": true
        }
      ]
    }
  ],
  "pricing_currencies": [
    { "symbol": "USD",  "decimals": 2, "fiat": true },
    { "symbol": "EUR",  "decimals": 2, "fiat": true },
    { "symbol": "RUB",  "decimals": 2, "fiat": true },
    { "symbol": "JPY",  "decimals": 0, "fiat": true },
    { "symbol": "USDT", "decimals": 6, "fiat": false },
    { "symbol": "BTC",  "decimals": 8, "fiat": false }
  ]
}
```

### `currencies` — в чём можно получать

Валюты **расчёта**: чем покупатель платит и в чём мерчант получает деньги. Только крипта.

<ResponseField name="currencies" type="array">
  Список активов.
</ResponseField>

<ResponseField name="currencies[].symbol" type="string">
  Код актива (`USDT`, `BTC`, …).
</ResponseField>

<ResponseField name="currencies[].decimals" type="int64">
  Число знаков после запятой у актива.
</ResponseField>

<ResponseField name="currencies[].networks" type="array<object>">
  Сети, на которых доступен актив.

  <Expandable title="поля networks[]">
    <ResponseField name="network" type="string">
      Код сети (`tron`, `ethereum`, …).
    </ResponseField>

    <ResponseField name="kind" type="string">
      `native` (монета сети) или `token`.
    </ResponseField>

    <ResponseField name="contract" type="string">
      Адрес контракта токена (только для `token`; у `native` отсутствует).
    </ResponseField>

    <ResponseField name="min_confirmations" type="int64">
      Полный reorg‑безопасный порог подтверждений для этой сети.
    </ResponseField>

    <ResponseField name="available" type="bool">
      Доступен ли **приём** (депозиты) — синоним `deposit_available`.
    </ResponseField>

    <ResponseField name="deposit_available" type="bool">
      Доступен ли приём платежей в этой сети прямо сейчас.
    </ResponseField>

    <ResponseField name="payout_available" type="bool">
      Доступны ли выплаты в этой сети прямо сейчас.
    </ResponseField>
  </Expandable>
</ResponseField>

### `pricing_currencies` — в чём можно назначать цену

Валюты **цены**: допустимые значения поля `currency` в [`POST /v1/payment`](/reference/payment-create). Это
**15 монет плюс 23 фиата** — всего 38 записей. Набор монет здесь шире списка `currencies`: цену
можно назначить и в монете, которой нет среди валют расчёта.

<ResponseField name="pricing_currencies" type="array">
  Список валют ценообразования (38 записей).
</ResponseField>

<ResponseField name="pricing_currencies[].symbol" type="string">
  Код валюты цены (`USD`, `EUR`, `RUB`, `USDT`, `BTC`, …).
</ResponseField>

<ResponseField name="pricing_currencies[].decimals" type="int64">
  Число знаков после точки. У большинства фиатов — 2, у `JPY` и `KRW` — **0**.
</ResponseField>

<ResponseField name="pricing_currencies[].fiat" type="bool">
  `true` — фиат: в нём можно **только назначать цену**, но не получать оплату.
</ResponseField>

Сетей у элемента `pricing_currencies` нет: валюта цены не определяет, как пойдут деньги, — это
задаёт валюта расчёта `to_currency`.

#### Поддерживаемые фиатные валюты (23)

| Знаков | Валюты                                                                                                                                            |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **2**  | `USD`, `EUR`, `GBP`, `RUB`, `UAH`, `PLN`, `CZK`, `TRY`, `CNY`, `INR`, `BRL`, `CAD`, `AUD`, `CHF`, `AED`, `ZAR`, `MXN`, `IDR`, `THB`, `VND`, `NGN` |
| **0**  | `JPY`, `KRW` — у иены и воны нет разменной единицы: `"10000"`, а не `"10000.00"`                                                                  |

**Тенге (`KZT`), сом (`KGS`), сум (`UZS`) не поддерживаются** — счёт в такой валюте вернёт
`payment.unknown_currency`.

***

## Нюансы

* **Цена и расчёт — разные списки.** Элемент с `fiat: true` (`USD`, `EUR`, `RUB`, …) годится только
  для поля `currency`; передать его в `to_currency` нельзя — расчёт всегда идёт в крипте. Если цена в
  фиате и задана `network`, но не задана `to_currency`, создание счёта вернёт
  `payment.to_currency_required`.
* **Не хардкодьте список фиатов.** Берите `pricing_currencies` из этого метода: набор валют может
  расширяться.
* **Приём и выплаты разделены.** `deposit_available` и `payout_available` независимы: сеть может быть
  доступна только на приём или только на вывод. Стройте UI по нужному направлению.
* **Актуальный источник.** Список отражает текущую конфигурацию шлюза — используйте его, а не
  захардкоженный перечень, чтобы новые сети появлялись автоматически. Сводный перечень пар «на бумаге»
  — в [Поддерживаемые сети и валюты](/reference/basics-networks).
* Для методов приёма/выплат **конкретного мерчанта** (с лимитами и комиссией) — см.
  [`POST /v1/payment/services`](/reference/payment-services) и [`POST /v1/payout/services`](/reference/payout-services).

***

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

<CardGroup cols={2}>
  <Card title="Поддерживаемые сети и валюты" href="/reference/basics-networks" icon="arrow-right" horizontal />

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

  <Card title="POST /v1/payment/services" href="/reference/payment-services" icon="arrow-right" horizontal />

  <Card title="POST /v1/payout/services" href="/reference/payout-services" icon="arrow-right" horizontal />
</CardGroup>