Перейти к основному содержанию
GET
/
currency
FX rates (USD base)
curl --request GET \
  --url https://csboard.com/v1/currency \
  --header 'Authorization: Bearer <token>'
{
  "base": "USD",
  "rates": {
    "USD": 1,
    "EUR": 0.92,
    "RUB": 78.4,
    "GBP": 0.79
  },
  "updated_at": "2026-06-29T17:00:00Z",
  "rub_source": "cbr",
  "base_source": "openexchangerates"
}
Все цены в API CSBoard выражены в USD. Эндпоинт currency возвращает ту же таблицу курсов, что используется во внутренних потоках сайта для платежей и отображения цен, обеспечивая единый слой конвертации для показа пользователям цен в локальной валюте. Курсы получаются из OpenExchangeRates для основных валют и из Центрального банка России для RUB; кэшируются примерно на один час. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

​
Параметры

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

​
Поля ответа

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

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

Чтобы отобразить значение price_usd в локальной валюте, умножьте его на соответствующий курс: 
local_price = price_usd × rates["EUR"]
# например, 14.37 USD × 0.92 = 13.22 EUR
Поскольку таблица курсов кэшируется примерно на 1 час, запрашивайте её один раз при старте приложения и периодически обновляйте, а не вызывайте этот эндпоинт для каждого товара.

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

curl https://csboard.com/v1/currency \
  -H "Authorization: Bearer csb_pub_..."

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

{
  "base": "USD",
  "rates": {
    "USD": 1,
    "EUR": 0.92,
    "RUB": 78.4,
    "GBP": 0.79
  },
  "updated_at": "2026-06-29T17:00:00Z",
  "rub_source": "cbr",
  "base_source": "openexchangerates"
}

​
Коды ошибок

HTTP-статусКодЗначение
401unauthorizedОтсутствует или некорректный API-ключ.
429rate_limit_exceededБолее 30 запросов/мин. Перед повтором сверьтесь с заголовком Retry-After.
Кэшируйте ответ 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