API курсов валют Saudi Central Bank (SAMA)
Официальные курсы Saudi Central Bank (SAMA) на 31 июл. 2026 г.: 1 USD = 3.75 SAR, 1 EUR = 4.2976 SAR. Все публикуемые валюты: 12 валют, история с 2009 года. Бесплатный JSON API для отчётности, аудита и счетов.
О банке Saudi Central Bank (SAMA)
Центральный банк Саудовской Аравии (SAMA) публикует курсы риала ежемесячно — средние за период и на конец периода значения для 12 валют; сам риал с 1986 года привязан к доллару США на уровне 3,75. Собственного машиночитаемого канала у SAMA нет, поэтому серия берётся из зеркала открытых данных KAPSARC, воспроизводящего таблицу SAMA, и обычно отстаёт от календаря примерно на два месяца.
- Официальный сайт: www.sama.gov.sa
- Официальная публикация курсов: Exchange rates — KAPSARC open-data mirror
Быстрый старт
Один запрос для нужной пары — EUR к SAR по официальному курсу Saudi Central Bank (SAMA):
curl "https://allratestoday.com/api/v1/central-bank/sama/latest?source=EUR&target=SAR" \
-H "Authorization: Bearer art_live_your_key" Или полная опубликованная таблица банка:
curl "https://allratestoday.com/api/v1/central-bank/sama/latest" \
-H "Authorization: Bearer art_live_your_key" На платных тарифах — любая историческая дата или временной ряд:
curl "https://allratestoday.com/api/v1/central-bank/sama/history?source=EUR&target=SAR&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Последние опубликованные курсы (2026-07-31)
Самая свежая таблица, опубликованная Saudi Central Bank (SAMA), — ровно то, что сейчас возвращает эндпоинт /latest. Значения указаны в SAR за 1 единицу каждой валюты:
Скачать таблицу: Excel (.xlsx) CSV (требуется платный тариф)
По одной строке на валюту за каждую дату публикации. До одного года за загрузку. Тарифицируется как один API-запрос за каждую валюту за каждый месяц данных.
| База | Котировка | Тип | Курс |
|---|---|---|---|
AUD | SAR | close | 2.63058047221363 |
AUD | SAR | monthly_average | 2.61183063501772 |
BRL | SAR | close | 0.739165577840677 |
BRL | SAR | monthly_average | 0.734010568058027 |
CHF | SAR | close | 4.6253693732891 |
CHF | SAR | monthly_average | 4.62296633968702 |
CNY | SAR | close | 0.554618414531289 |
CNY | SAR | monthly_average | 0.553378781072114 |
EUR | SAR | close | 4.29760140142838 |
EUR | SAR | monthly_average | 4.28048973052737 |
GBP | SAR | close | 5.03046195705751 |
GBP | SAR | monthly_average | 5.01331824526424 |
INR | SAR | close | 0.0392357079697051 |
INR | SAR | monthly_average | 0.0391362080096797 |
JPY | SAR | close | 0.0232939683467162 |
JPY | SAR | monthly_average | 0.0230591741146819 |
KRW | SAR | close | 0.0025965805007124 |
KRW | SAR | monthly_average | 0.00250938390171408 |
THB | SAR | close | 0.111984058708896 |
THB | SAR | monthly_average | 0.111920065604215 |
TRY | SAR | close | 0.0788477353462766 |
TRY | SAR | monthly_average | 0.0797603736961918 |
USD | SAR | close | 3.75 |
USD | SAR | monthly_average | 3.75 |
Клиент для Node.js / TypeScript
Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — sama-exchange-rate:
npm install sama-exchange-rate import { getRate } from 'sama-exchange-rate';
const pair = await getRate('EUR', 'SAR', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.
Полная документация — установка, все четыре функции, формат ответов, коды ошибок: sama-exchange-rate (на английском).
Зачем нужен официальный курс Saudi Central Bank (SAMA)?
Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Saudi Arabia и не только) обычно требуют официальный курс, опубликованный Saudi Central Bank (SAMA) на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.
Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через SAR) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.
Эндпоинты
GET /api/v1/central-bank/sama/latest— последняя таблица или одна пара (все тарифы)GET /api/v1/central-bank/sama/{YYYY-MM-DD}— таблица на любую дату (платные тарифы)GET /api/v1/central-bank/sama/history— временной ряд, до 5 000 строк (платные тарифы)GET /api/v1/central-bank/sama/availability— календарь публикаций: даты, на которые банк реально публиковал таблицу (все тарифы)
Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в месяц, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.
Часто задаваемые вопросы
Есть ли API для курсов валют Saudi Central Bank (SAMA)?
Да — этот. Официальные среднемесячные курсы SAR в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.
Как часто обновляются курсы?
Saudi Central Bank (SAMA) публикует среднемесячные курсы — по одному усреднённому курсу за календарный месяц, публикуются после закрытия месяца; API загружает каждую новую таблицу вскоре после публикации (последняя: 2026-07-31).
Это официальные курсы?
Да — данные берутся из публикаций самого Saudi Central Bank (SAMA) и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.
Курсы Saudi Central Bank (SAMA) — один API-ключ
Последняя таблица на любом тарифе. История с 2009 года на платных тарифах. Кредитная карта не нужна.
Получить бесплатный API-ключ Документация