Skip to main content
GET
FX rates (USD base)
Все цены в API CSBoard выражены в USD. Эндпоинт currency возвращает ту же таблицу курсов, что используется во внутренних потоках сайта для платежей и отображения цен, обеспечивая единый слой конвертации для показа пользователям цен в локальной валюте. Курсы получаются из OpenExchangeRates для основных валют и из Центрального банка России для RUB; кэшируются примерно на один час. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

Параметры

Этот эндпоинт не принимает query-параметров.

Поля ответа

string
обязательно
Всегда "USD". Все курсы выражены относительно одного доллара США.
object
обязательно
Соответствие кодов валют ISO 4217 их курсам к USD (единиц этой валюты за 1 USD). Пример: { "USD": 1, "EUR": 0.92, "RUB": 78.4, "GBP": 0.79 }.
datetime
обязательно
Временная метка ISO 8601, когда таблица курсов была последний раз обновлена.
string
Идентификатор источника курса RUB, например "cbr" (Центральный банк России).
string
Идентификатор источника для курсов, отличных от RUB, например "openexchangerates".

Конвертация цен

Чтобы отобразить значение price_usd в локальной валюте, умножьте его на соответствующий курс:
Поскольку таблица курсов кэшируется примерно на 1 час, запрашивайте её один раз при старте приложения и периодически обновляйте, а не вызывайте этот эндпоинт для каждого товара.

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

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

Коды ошибок

Кэшируйте ответ rates на стороне клиента и обновляйте не чаще одного раза в час. Курсы обновляются на том же ~1-часовом цикле, поэтому более частые опросы не дадут более свежих данных и впустую расходуют лимит запросов.

Авторизации

Authorization
string
header
обязательно

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

Ответ

Current FX rates.

base
string
обязательно
Пример:

"USD"

rates
object
обязательно

Currency code → units per 1 USD.

updated_at
string<date-time>
обязательно
rub_source
string
base_source
string