API курсов валют Bank Al-Maghrib
Официальные ежедневные курсы Bank Al-Maghrib (Morocco) в формате JSON: 30 валют, история с 2026 года. Публикуемые курсы MAD для налоговой отчётности, аудита и выставления счетов.
О банке Bank Al-Maghrib
Банк Аль-Магриб публикует ежедневные справочные курсы (cours de référence) марокканского дирхама — около 30 валют каждый рабочий день около полудня по Рабату. При режиме управляемого плавания это официальный ориентир, на который ссылаются марокканский учёт, таможня и контракты; архив на сайте банка доходит до 2000 года — в ранние годы котировки покупки/продажи, с 2017 года публикуется средний курс.
- Официальный сайт: www.bkam.ma
- Официальная публикация курсов: Cours de référence
Быстрый старт
Один запрос для нужной пары — USD к MAD по официальному курсу Bank Al-Maghrib:
curl "https://allratestoday.com/api/v1/central-bank/bam/latest?source=USD&target=MAD" \
-H "Authorization: Bearer art_live_your_key" Или полная опубликованная таблица банка:
curl "https://allratestoday.com/api/v1/central-bank/bam/latest" \
-H "Authorization: Bearer art_live_your_key" На платных тарифах — любая историческая дата или временной ряд:
curl "https://allratestoday.com/api/v1/central-bank/bam/history?source=USD&target=MAD&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Последние опубликованные курсы (2026-08-19)
Самая свежая таблица, опубликованная Bank Al-Maghrib, — ровно то, что сейчас возвращает эндпоинт /latest. Значения указаны в MAD за 1 единицу каждой валюты:
Скачать таблицу: Excel (.xlsx) CSV (требуется платный тариф)
По одной строке на валюту за каждую дату публикации. До одного года за загрузку. Тарифицируется как один API-запрос за каждую валюту за каждый месяц данных.
| База | Котировка | Тип | Курс |
|---|---|---|---|
AED | MAD | reference | 2.524 |
AUD | MAD | reference | 6.5806 |
BHD | MAD | reference | 24.59 |
BRL | MAD | reference | 1.7854 |
CAD | MAD | reference | 6.6931 |
CHF | MAD | reference | 11.483 |
CNY | MAD | reference | 1.3765 |
DKK | MAD | reference | 1.4419 |
DZD | MAD | reference | 0.0698 |
EGP | MAD | reference | 0.1829 |
EUR | MAD | reference | 10.7796 |
GBP | MAD | reference | 12.596 |
GIP | MAD | reference | 12.596 |
INR | MAD | reference | 0.0968 |
JOD | MAD | reference | 13.085 |
JPY | MAD | reference | 0.05838599999999999 |
KWD | MAD | reference | 30.051 |
LYD | MAD | reference | 1.9338 |
MRU | MAD | reference | 0.23428000000000002 |
NOK | MAD | reference | 0.98895 |
OMR | MAD | reference | 24.079 |
QAR | MAD | reference | 2.5426 |
RUB | MAD | reference | 0.1092 |
SAR | MAD | reference | 2.4691 |
SEK | MAD | reference | 0.97724 |
TND | MAD | reference | 3.1817 |
TRY | MAD | reference | 0.1934 |
USD | MAD | reference | 9.2704 |
XOF | MAD | reference | 0.016433 |
ZAR | MAD | reference | 0.5733 |
Клиент для Node.js / TypeScript
Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — bank-al-maghrib-exchange-rate:
npm install bank-al-maghrib-exchange-rate import { getRate } from 'bank-al-maghrib-exchange-rate';
const pair = await getRate('USD', 'MAD', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.
Зачем нужен официальный курс Bank Al-Maghrib?
Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Morocco и не только) обычно требуют официальный курс, опубликованный Bank Al-Maghrib на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.
Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через MAD) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.
Эндпоинты
GET /api/v1/central-bank/bam/latest— последняя таблица или одна пара (все тарифы)GET /api/v1/central-bank/bam/{YYYY-MM-DD}— таблица на любую дату (платные тарифы)GET /api/v1/central-bank/bam/history— временной ряд, до 5 000 строк (платные тарифы)GET /api/v1/central-bank/bam/availability— календарь публикаций: даты, на которые банк реально публиковал таблицу (все тарифы)
Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в рабочий день, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.
Часто задаваемые вопросы
Есть ли API для курсов валют Bank Al-Maghrib?
Да — этот. Официальные ежедневные курсы MAD в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.
Как часто обновляются курсы?
Bank Al-Maghrib публикует курсы один раз в рабочий день; API загружает каждую новую таблицу вскоре после публикации (последняя: 2026-08-19).
Это официальные курсы?
Да — данные берутся из публикаций самого Bank Al-Maghrib и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.
Курсы Bank Al-Maghrib — один API-ключ
Последняя таблица на любом тарифе. История с 2026 года на платных тарифах. Кредитная карта не нужна.
Получить бесплатный API-ключ Документация