Курсы дня учёта

Курс валюты к валюте магазина на дату — по нему журнал денег пересчитывает валютные счета; для переоценки и сверки.

Загружаем поисковый индекс…

Курсы дня учёта

Объекты

ExchangeRate

  • currencystringобязательно

    Валюта курса — код ISO 4217 или актива (USDT): 1 единица этой валюты = rate единиц валюты магазина.

  • store_currencystringобязательно

    Валюта магазина, код ISO 4217.

  • datestringобязательно

    Учётная дата запроса, YYYY-MM-DD в часовом поясе магазина.

  • ratestring или nullобязательно

    Курс дня учёта десятичной строкой: 1 currency = rate валюты магазина — им журнал денег пересчитывает движения по счёту в этой валюте на эту дату. null — курс дня ещё не зафиксирован (его фиксирует первая валютная операция дня) или пару не котирует ни один источник. У валюты магазина — "1".

  • rate_datestring или nullобязательно

    День, которым курс зафиксирован: на дату без своего курса журнал берёт ближайший прошлый, на дату раньше первой фиксации — первый. null — курса нет.

  • sourcestring или nullобязательно

    Источник рыночного курса из правила магазина: coingecko, criptoya_p2p, ar_oficial, ar_blue, ar_mep, ar_ccl, ar_mayorista, cbr. null — пару не котирует ни один источник (магазин принимает её только по ручному курсу) или это валюта магазина.

    Значения:
    coingeckocriptoya_p2par_oficialar_bluear_mepar_cclar_mayoristacbrnull

Методы

Курс дня учёта валюты на дату: по нему журнал денег пересчитывает движения по валютным счетам

get/exchange-rates/{currency}

Scope: finance:read

Параметры

Путь

  • currencystringобязательно

    Код валюты ISO 4217 или актива (USDT, USDC) из набора валют денежного счёта.

Строка запроса

  • datestring (date)

    Учётная дата YYYY-MM-DD в часовом поясе магазина; по умолчанию сегодня.

Ответы

200Успешно

application/json

Возвращает ExchangeRate

401Токена нет, он неверен, истёк или отозван

Заголовки

  • WWW-Authenticatestringобязательно

    Схема аутентификации (RFC 6750).

    Пример:
    Bearer

application/problem+json

Возвращает Problem

403Запрос не разрешают тариф, IP-адрес или scopes токена

Заголовки

  • WWW-Authenticatestring

    Схема аутентификации (RFC 6750).

    Пример:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Возвращает ForbiddenProblem

404Объекта нет или он недоступен приложению

application/problem+json

Возвращает Problem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки

Пример запроса
curl "https://api.saleya.app/v1/exchange-rates/{currency}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Пример ответа · 200
{
  "currency": "string",
  "store_currency": "string",
  "date": "string",
  "rate": "string",
  "rate_date": "string",
  "source": "coingecko"
}