Saudi Central Bank (SAMA) 汇率 API
Saudi Central Bank (SAMA)官方汇率(2026年7月31日):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
快速开始
一次请求获取所需货币对 — 按 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-07-31)
Saudi Central Bank (SAMA) 最近发布的汇率表 — 与 /latest 端点当前返回的内容完全一致。数值为每 1 单位货币对应的 SAR:
下载此汇率表: 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 及边缘运行时。
完整文档 — 安装、全部四个函数、响应结构、错误码: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 文档。每次请求计入套餐月度配额 — 汇率每月只变一次,本地缓存已发布的汇率表能让小配额用很久。
常见问题
Saudi Central Bank (SAMA) 的汇率有 API 吗?
有 — 就是这个。官方月度平均 SAR 汇率,干净的 JSON;最新汇率表适用于所有套餐(含免费版)。
汇率多久更新一次?
Saudi Central Bank (SAMA) 每月发布一次月度平均汇率 — 每个日历月一个平均汇率,于该月结束后发布;API 在发布后很快抓取新表(最新:2026-07-31)。
这些是官方汇率吗?
是 — 取自 Saudi Central Bank (SAMA) 自己发布的数据,原样提供并附银行发布日期。凡是计算而非公布的数值都会标记 derived。