> For the complete documentation index, see [llms.txt](https://fkassa.gitbook.io/firekassa-api-v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fkassa.gitbook.io/firekassa-api-v2/accounts/kursy-konvertacii-so-scheta-na-schet.md).

# Курсы конвертации со счета на счет

## Метод запроса

POST

## Урл запроса

/api/v2/currency-exchange-rate

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

На вход принимаются следующие параметры

<table><thead><tr><th width="180">Название</th><th width="81" data-type="checkbox">Обяз.</th><th width="128">Формат</th><th>а</th><th>Описание</th><th data-hidden>Описание</th><th data-hidden>Формат</th><th data-hidden data-type="checkbox">Обязательно</th></tr></thead><tbody><tr><td>from</td><td>true</td><td>string</td><td>"sber"</td><td>код счета с которого будут списаны средства</td><td>Ваш уникальный номер заявки</td><td></td><td>false</td></tr><tr><td>to</td><td>true</td><td>string</td><td>"usdt"</td><td>код счета на который будут зачислены средства после конвертации</td><td></td><td></td><td>false</td></tr><tr><td>provider</td><td>false</td><td>string</td><td>"1"</td><td>0 - курс выдается в зависимости от настроек сайта , 1  - курс по бирже Garantex, 2 - курс по бирже Bybit</td><td></td><td></td><td>false</td></tr></tbody></table>

Коды счетов , можно узнать из апи  [Список счетов](/firekassa-api-v2/accounts/list.md)

## Пример запроса&#x20;

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

```sh
curl --request POST \
  --url https://{{your_api_domain}}/api/v2/currency-exchange-rate\
  --header 'Authorization: Bearer {{your_api_token}}' \
  --data '{
  "from": "sber",
  "to": "usdt-tron"
}'

```

{% endtab %}

{% tab title="PHP + Guzzle" %}

```php
$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{your_api_domain}}/api/v2/currency-exchange-rate', [
    'json' => [
        'from'   => 'sber',
        'to'     => 'usdt-tron'
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $yourApiToken,
    ]
]);
```

{% endtab %}
{% endtabs %}

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

<table><thead><tr><th width="180">Название</th><th width="151">Формат</th><th>Описание</th><th data-hidden>Описание</th><th data-hidden>Формат</th><th data-hidden data-type="checkbox">Обязательно</th></tr></thead><tbody><tr><td>rate</td><td>string</td><td>Курс обмена</td><td>Код метода, в данном случае card</td><td></td><td>false</td></tr><tr><td>expireAt</td><td>string</td><td>Время устаревания курса. Формат:<br>"2020-01-01T00:00:00+03:00"</td><td></td><td></td><td>false</td></tr></tbody></table>

*Независимо от направления обмена курс показывается в отношении основной валюты.  К примеру при  обмене USDT на рубли возвращается количество рублей которое вы получите после конвертации 1 USDT. А при обмене рублей на USDT возвращается  количество рублей необходимых для покупки 1 USDT.*

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

```
{
    "rate": "93.236",
    "expiredAt": "2024-09-11T12:10:06+03:00"
}
```