Курсы дня учёта
Курс валюты к валюте магазина на дату — по нему журнал денег пересчитывает валютные счета; для переоценки и сверки.
Курсы дня учёта
Объекты
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"{
"currency": "string",
"store_currency": "string",
"date": "string",
"rate": "string",
"rate_date": "string",
"source": "coingecko"
}