> For the complete documentation index, see [llms.txt](https://wiki.aaio.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.aaio.so/api/kurs-valyut-pri-vyvode-sredstv.md).

# Курс валют при выводе средств

## Запрос

<mark style="color:blue;">`GET`</mark> / <mark style="color:green;">`POST`</mark>  `https://aaio.so/api/rates-payoff`

### Заголовки

`Accept: application/json` <mark style="color:red;">**\***</mark>\
`X-Api-Key: {api_key}` <mark style="color:red;">**\***</mark>

#### Определения

`{api_key}` - Ключ API из раздела <https://aaio.so/business/api/keys> с разрешениями:\ <mark style="color:green;">Вывод средств</mark>\
\ <mark style="color:red;">**\***</mark>**&#x20;- обязательные заголовки. Без них Вы не сможете получить корректный ответ.**

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

**Формат ответа** `application/json`

{% tabs %}
{% tab title="Успех - 200" %}

```json
{
    "type": "success",
    "USD": 96.54, // Курс USD
    "UAH": 3.56, // Курс UAH
    "USDT": 96.93, // Курс USDT
    "BTC": 2712968 // Курс BTC
}
```

{% endtab %}

{% tab title="Ошибка: 400, 401, 429, 500, 503  " %}
**Пользовательские коды ошибок** - `400`, `401`, `429`\
**Серверные коды ошибок** - `500`, `503`

```json
{
  "type": "fail",
  "code": "400",
  "message": "message"
}
```

{% endtab %}

{% tab title="Другой код ответа" %}
Если код ответа другой, то возможна проблема на стороне сервера API. \
**Рекомендуем учитывать такие ситуации в коде.**
{% endtab %}
{% endtabs %}

## Готовые примеры запроса

{% tabs %}
{% tab title="cURL" %}

```bash
curl -X 'GET' \
'https://aaio.so/api/rates-payoff' \
-H 'accept: application/json' \
-H 'x-api-key: API_KEY'
```

{% endtab %}
{% endtabs %}