Bank Al-Maghrib 汇率 API
Bank Al-Maghrib(Morocco)官方每日汇率,JSON 格式:30 种货币,历史数据可追溯至 2026 年。税务申报、审计与合规开票所需的官方 MAD 汇率。
关于 Bank Al-Maghrib
摩洛哥中央银行(Bank Al-Maghrib)每个营业日中午前后发布迪拉姆的每日参考汇率(cours de référence),约 30 种货币。在摩洛哥的有管理浮动机制下,它是该国会计、海关和合同引用的官方基准;银行网站的档案可追溯至 2000 年——早年为买入/卖出报价,2017 年起发布中间价。
- 官方网站: www.bkam.ma
- 官方汇率发布页: Cours de référence
快速开始
一次请求获取所需货币对 — 按 Bank Al-Maghrib 官方汇率查询 USD 兑 MAD:
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 端点当前返回的内容完全一致。数值为每 1 单位货币对应的 MAD:
下载此汇率表: 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 及边缘运行时。
为什么使用 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 文档。每次请求计入套餐月度配额 — 汇率每个工作日只变一次,本地缓存已发布的汇率表能让小配额用很久。
常见问题
Bank Al-Maghrib 的汇率有 API 吗?
有 — 就是这个。官方每日 MAD 汇率,干净的 JSON;最新汇率表适用于所有套餐(含免费版)。
汇率多久更新一次?
Bank Al-Maghrib 每个工作日发布一次;API 在发布后很快抓取新表(最新:2026-08-19)。
这些是官方汇率吗?
是 — 取自 Bank Al-Maghrib 自己发布的数据,原样提供并附银行发布日期。凡是计算而非公布的数值都会标记 derived。