API курсов валют Saudi Central Bank (SAMA)

Официальные среднемесячные курсы Saudi Central Bank (SAMA) (Saudi Arabia) в формате JSON: 12 валют, история с 2009 года. Публикуемые курсы SAR для налоговой отчётности, аудита и выставления счетов.

Saudi Central Bank (SAMA) — официальные среднемесячные курсы валют в формате JSON: 12 валют к SAR, история с 2009 года. Последняя таблица — на любом тарифе. Получить 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-06-30)

Самая свежая таблица, опубликованная Saudi Central Bank (SAMA), — ровно то, что сейчас возвращает эндпоинт /latest. Значения указаны в SAR за 1 единицу каждой валюты:

Скачать таблицу: Excel (.xlsx) CSV (требуется платный тариф)

База	Котировка	Тип	Курс
AUD	SAR	close	2.5758671691385
AUD	SAR	monthly_average	2.63205404391809
BRL	SAR	close	0.724498765523559
BRL	SAR	monthly_average	0.731625565702254
CHF	SAR	close	4.63592688818998
CHF	SAR	monthly_average	4.6936388907394
CNY	SAR	close	0.552729857572648
CNY	SAR	monthly_average	0.553434825178344
EUR	SAR	close	4.27274636822692
EUR	SAR	monthly_average	4.31918711966172
GBP	SAR	close	4.96328323248097
GBP	SAR	monthly_average	5.00106159149281
INR	SAR	close	0.0396415765021359
INR	SAR	monthly_average	0.039495523814247
JPY	SAR	close	0.0231195671940353
JPY	SAR	monthly_average	0.0233358383613183
KRW	SAR	close	0.00243269566548509
KRW	SAR	monthly_average	0.00245694424966144
THB	SAR	close	0.112856213951403
THB	SAR	monthly_average	0.113974409631228
TRY	SAR	close	0.0805
TRY	SAR	monthly_average	0.0812
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-среды.

Зачем нужен официальный курс 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-06-30).

Это официальные курсы?

Да — данные берутся из публикаций самого Saudi Central Bank (SAMA) и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.

Другие центральные банки

Все охваченные центральные банкиПокрытие, эндпоинты и тарифы US Federal Reserve (H.10)United States — официальные курсы USD Bank of EnglandUnited Kingdom — официальные курсы GBP People's Bank of China (CFETS)China — официальные курсы CNY Reserve Bank of AustraliaAustralia — официальные курсы AUD Bank of RussiaRussia — официальные курсы RUB Central Bank of TürkiyeTürkiye — официальные курсы TRY Banco Central do Brasil (PTAX)Brazil — официальные курсы BRL Bank IndonesiaIndonesia — официальные курсы IDR Reserve Bank of IndiaIndia — официальные курсы INR Bank of CanadaCanada — официальные курсы CAD Bank Negara MalaysiaMalaysia — официальные курсы MYR Central Bank of Sri LankaSri Lanka — официальные курсы LKR Czech National BankCzech Republic — официальные курсы CZK European Central BankEurozone — официальные курсы EUR Narodowy Bank PolskiPoland — официальные курсы PLN Norges BankNorway — официальные курсы NOK Sveriges RiksbankSweden — официальные курсы SEK Central Bank of NigeriaNigeria — официальные курсы NGN Central Bank of KuwaitKuwait — официальные курсы KWD Central Bank of BahrainBahrain — официальные курсы BHD Central Bank of AzerbaijanAzerbaijan — официальные курсы AZN Central Bank of Bosnia and HerzegovinaBosnia and Herzegovina — официальные курсы BAM Bulgarian National BankBulgaria — официальные курсы EUR Central Reserve Bank of PeruPeru — официальные курсы PEN Bank of JapanJapan — официальные курсы JPY Hong Kong Monetary AuthorityHong Kong — официальные курсы HKD Bank of IsraelIsrael — официальные курсы ILS Central Bank of ArgentinaArgentina — официальные курсы ARS South African Reserve BankSouth Africa — официальные курсы ZAR Swiss National BankSwitzerland — официальные курсы CHF Reserve Bank of New ZealandNew Zealand — официальные курсы NZD Bank of KoreaSouth Korea — официальные курсы KRW National Bank of RomaniaRomania — официальные курсы RON National Bank of UkraineUkraine — официальные курсы UAH Banco de MéxicoMexico — официальные курсы MXN Bangko Sentral ng PilipinasPhilippines — официальные курсы PHP Banco Central de la República DominicanaDominican Republic — официальные курсы DOP Banco Central del ParaguayParaguay — официальные курсы PYG National Bank of CambodiaCambodia — официальные курсы KHR Bank of GhanaGhana — официальные курсы GHS Central Bank of EgyptEgypt — официальные курсы EGP Bank of AlbaniaAlbania — официальные курсы ALL Banco de GuatemalaGuatemala — официальные курсы GTQ Bank of MongoliaMongolia — официальные курсы MNT Monetary Authority of SingaporeSingapore — официальные курсы SGD Banca d'ItaliaItaly — официальные курсы EUR Danmarks NationalbankDenmark — официальные курсы DKK Superintendencia Financiera de Colombia (TRM)Colombia — официальные курсы COP National Bank of KazakhstanKazakhstan — официальные курсы KZT National Bank of GeorgiaGeorgia — официальные курсы GEL Central Bank of UzbekistanUzbekistan — официальные курсы UZS Magyar Nemzeti BankHungary — официальные курсы HUF Central Bank of IcelandIceland — официальные курсы ISK Central Bank of the UAEUnited Arab Emirates — официальные курсы AED State Bank of PakistanPakistan — официальные курсы PKR Nepal Rastra BankNepal — официальные курсы NPR Central Bank of JordanJordan — официальные курсы JOD Bangladesh BankBangladesh — официальные курсы BDT Central Bank of OmanOman — официальные курсы OMR Palestine Monetary AuthorityPalestine — официальные курсы ILS API курсов налоговых органовОфициальные курсы HMRC и Минфина США