税务机关汇率 API

一个 API 获取官方税务机关汇率:英国 HMRC 每月海关与增值税汇率、美国财政部每季度报告汇率,以 JSON 提供,历史数据可追溯至 2001 年。这些是报关单、增值税发票和联邦报告必须使用的固定汇率。

By Madhushan, Founder & Lead Developer ·

一句话:各国税务机关为合规目的公布的汇率 — HMRC 每月、美国财政部每季度 — 以干净的 JSON 提供,历史数据可追溯至 2001 年。这些不是市场汇率:每个汇率在其整个期间内固定不变,是申报单或报告必须使用的数字。最新汇率表包含在所有套餐中。获取 API 密钥。

为什么税务机关汇率不是市场汇率

在任何一天,市场汇率和你依法必须适用的汇率是两个不同的数字 — 对海关和税务而言只有后者算数。税务机关为一个期间确定一个汇率并予以公布,要求该期间内的每一份申报都使用它,无论其间市场如何波动。若改用当天的市场汇率换算发票,关税或增值税金额将无法与机关计算的结果对上。

这是特性,不是局限。一个按月或按季度固定的汇率,让进口商、其报关行和海关当局各自独立地算出同一个数字 — 因此出现差异意味着确实有错误,而不是两个系统在相隔几小时的时点取了市场价。

两种发布周期的差别

两个数据源以不同的时间表解决同一个问题,集成时这一差别很重要:

API 返回的是现行有效的汇率表,而不是共享最新日期的那些行:即该期间的汇率并已套用其后的所有修订,每一行都带有它实际发布的日期。你直接得到申报人今天应据以报告的状态,无需从原始数据流重建。

当海关汇率就是央行汇率时

多数国家根本不单独发布税务汇率——其海关与税务规则直接指定央行公布的汇率。这些汇率同样在本 API 中,归属于发布它们的央行,可引用性完全相同。常见情形:

覆盖的税务机关

实时覆盖 — 此表由 API 所用的同一数据库生成,因此始终与 /api/v1/central-banks 一致:

机关 国家/地区 代码 发布周期 货币数 历史起始 最新汇率表 入库时间 (UTC)
India flagCentral Board of Indirect Taxes and Customs (CBIC) India cbic Fortnightly 22 2020年1月 2026-11-06 —
United Kingdom flagHM Revenue & Customs United Kingdom hmrc Monthly 141 2021年1月 2026-11-01 —
United States flagInternal Revenue Service (yearly average rates) United States irs Yearly 38 2021年12月 2025-12-31 —
Peru flagSUNAT (Peru tax and customs authority) Peru sunat — 1 2026年11月 2026-11-06 —
Switzerland flagSwiss Federal Office for Customs and Border Security Switzerland bazg — 72 2000年1月 2026-11-06 05:15
United States flagU.S. Department of the Treasury United States ustreasury Quarterly 145 2001年3月 2026-10-30 —

货币数统计各机关当前汇率表中的货币数量。早期表中已删除的货币不计入该数字,但仍可通过历史数据端点获取。

路线图上还有更多机关 — 包括爱尔兰 Revenue、挪威与瑞典海关,以及印尼税务总局。需要特定机关?告诉我们 — 请求会让相应数据源提前排期。

快速开始

与 AllRatesToday 其余部分相同的 API 密钥、认证和端点 — 税务机关由同样的 /central-bank/ 路由提供服务。用熟悉的 source/target 参数查询货币对:

curl "https://allratestoday.com/api/v1/central-bank/hmrc/latest?source=GBP&target=USD" \
  -H "Authorization: Bearer art_live_your_key"

响应带有该汇率所属汇率表的发布日期:

{
  "bank": "hmrc",
  "name": "HM Revenue & Customs",
  "rate_date": "2026-08-01",
  "source": "GBP",
  "target": "USD",
  "rate": 1.3367,
  "rate_type": "monthly",
  "derived": false,
  "method": "published"
}

或获取该机关公布的完整汇率表 — 当前期间它公布的每一种货币:

curl "https://allratestoday.com/api/v1/central-bank/ustreasury/latest" \
  -H "Authorization: Bearer art_live_your_key"

付费套餐可查任意历史日期上现行有效的汇率表 — 发票日期、进口日期、报告日期:

curl "https://allratestoday.com/api/v1/central-bank/hmrc/2026-03-20?source=GBP&target=USD" \
  -H "Authorization: Bearer art_live_your_key"

人们用它做什么

套餐

由于汇率按月或按季度固定,每个期间缓存一次请求即可覆盖该期间的全部单据 — 在这里,很小的配额也能用很久。查看套餐。

常见问题

什么是税务机关汇率 API?

返回各国税务和海关机关为合规目的公布的汇率(如 HMRC 每月海关与增值税汇率或美国财政部每季度报告汇率)而非实时市场汇率的 API。申报单、发票和官方报告必须使用这些汇率。

覆盖哪些税务机关?

6:Central Board of Indirect Taxes and Customs (CBIC), HM Revenue & Customs, Internal Revenue Service (yearly average rates), SUNAT (Peru tax and customs authority), Swiss Federal Office for Customs and Border Security, U.S. Department of the Treasury。还在持续增加,同一个 API 也覆盖 123 家央行。

这与央行汇率 API 有何不同?

这是同一个 API、同样的端点 — 只是发布方不同。央行作为货币政策的一部分每个工作日发布一次汇率;税务机关每月或每季度固定一个汇率,正是为了让该期间内的各项申报彼此一致。你需要哪一种,取决于你要遵守的规则。

报关时应该用哪个汇率?

用申报所属期间的税务机关汇率,而不是当天的市场汇率。查询期间内的任意日期都会返回该期间的官方汇率,因此按发票日期或进口日期查询即可得到你必须适用的汇率。

季中修订如何处理?

美国财政部会在季度中途修订个别货币,因此它最新的发布日期往往只有寥寥数行而不是一张汇率表。API 返回现行有效的汇率表 — 该季度的汇率并已套用其后的所有修订 — 且每一行都带有它实际发布的日期。

官方税务机关汇率,一个 API 密钥

最新汇率表适用于所有套餐。开始使用无需信用卡。

免费获取 API 密钥 查看文档