Saudi Central Bank (SAMA) 汇率 API
Saudi Central Bank (SAMA)(Saudi Arabia)官方月度平均汇率,JSON 格式:12 种货币,历史数据可追溯至 2009 年。税务申报、审计与合规开票所需的官方 SAR 汇率。
关于 Saudi Central Bank (SAMA)
沙特中央银行(SAMA)按月发布里亚尔汇率——12 种货币的期间平均值和期末值;里亚尔自 1986 年起以 3.75 与美元挂钩。SAMA 本身不提供机器可读的数据接口,因此该序列取自 KAPSARC 开放数据平台对 SAMA 汇率表的镜像,通常滞后日历约两个月。
- 官方网站: www.sama.gov.sa
- 官方汇率发布页: Exchange rates — KAPSARC open-data mirror
快速开始
一次请求获取所需货币对 — 按 Saudi Central Bank (SAMA) 官方汇率查询 EUR 兑 SAR:
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 端点当前返回的内容完全一致。数值为每 1 单位货币对应的 SAR:
下载此汇率表: 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 及边缘运行时。
为什么使用 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 文档。每次请求计入套餐月度配额 — 汇率每月只变一次,本地缓存已发布的汇率表能让小配额用很久。
常见问题
Saudi Central Bank (SAMA) 的汇率有 API 吗?
有 — 就是这个。官方月度平均 SAR 汇率,干净的 JSON;最新汇率表适用于所有套餐(含免费版)。
汇率多久更新一次?
Saudi Central Bank (SAMA) 每月发布一次月度平均汇率 — 每个日历月一个平均汇率,于该月结束后发布;API 在发布后很快抓取新表(最新:2026-06-30)。
这些是官方汇率吗?
是 — 取自 Saudi Central Bank (SAMA) 自己发布的数据,原样提供并附银行发布日期。凡是计算而非公布的数值都会标记 derived。