美国财政部汇率司

美国财政部官方(美国)对Node.js和TypeScript的季度汇率. 税务申报、海关估价、审计和符合规定的发票背后公布的税务当局税率——不是市场估计,而是美国财政部自己印制的数字.

为什么是这个客户?

• 🏛️ 官方公布的费率 ——美国财政部自有桌子,有出版社自有 rate_date 每次答复
• 📅 历史可以追溯到2001年 ——过去任何日期的时点表和每日系列
• 🔀 发布 vs 来源, 总是标注 - 计算反向/对相承 derived: true,从未与官方指纹相混合
• ⚡ 零依赖关系 ——纯无害环境管理+CJS优于全球 fetch; 节点 18+、 Bun、 Deno 和边缘运行时间
• 🔷 类型安全 ——随包一起运出的全部类型脚本定义
• 🧾 合规级元数据 —— 说 rate_type,公布日期,以及来源对每项答复的免责声明

官方汇率,不是中市: 这里的每个值都是美国财政部自己出版的, 固定一次印刷, 并携带税务当局自己的 rate_date 申报和审计需要什么。 需要现场市场汇率来定价还是展示? 使用 市场中间API 或者说 @allratestoday/sdk两者可以相差几个百分点.

获取您的 API 密钥

获取免费 API 密钥 allatestoday.com/注册员 - 不需要信用卡。 每个计划都有最新费率,包括免费费率.

最近公布的表格

图片由无键端点进行直播,因此它跟随税务当局出版的 npm 和 GitHub 都一样,没有新版本. 与文本相同的表格折叠如下, 用于搜索和复制- 粘贴: 在 GitHub 每日行动 税务机关公布新表格时更新;npm上是包的发布日期.

表格由每日工作流程填入.

* 安装

npm install @allratestoday/ustreasury-exchange-rate

yarn add @allratestoday/ustreasury-exchange-rate

pnpm add @allratestoday/ustreasury-exchange-rate

要求节点18+(全球) fetch);也运行于Bun,Deno和边缘跑道. 范围镜像 ustreasury-exchange-rate ——代码相同,版本相同.

快速启动

import { getRate } from '@allratestoday/ustreasury-exchange-rate';

const pair = await getRate('USD', 'EUR', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); // the official U.S. Department of the Treasury rate, on the tax authority's own date

API 参考

• 最新配对率 最新公布的表格中的一对
• 完整公布的表格 - 税务局的每样东西,一个电话
• 日期表 发票或申报日期的正式表格
• 每日时间序列 ——一对跨日期范围

最新配对率

自由计划并上. 税务机关不直接打印的对价从其表格中解决并标出(见 已公布与衍生费率 页:1.

const pair = await getRate('USD', 'EUR', { apiKey: 'art_live_...' });

回应:

{
  bank: 'ustreasury',
  name: 'U.S. Department of the Treasury',
  rate_date: '2026-09-30',   // U.S. Department of the Treasury's own publication date
  source: 'USD',
  target: 'EUR',
  rate: 0.881,
  rate_type: 'quarterly',
  derived: false,
  method: 'published',
  disclaimer: 'Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned.'
}

完整公布的表格

自由计划并上. 最近出版日期的完整表格.

import { getLatestRates } from '@allratestoday/ustreasury-exchange-rate';

const table = await getLatestRates({ apiKey: 'art_live_...' });
console.log(table.rate_date, table.rates.length);

回应:

{
  bank: 'ustreasury',
  name: 'U.S. Department of the Treasury',
  rate_date: '2026-09-30',
  rates: [
    { "base": "USD", "quote": "EUR", "type": "quarterly", "value": 0.881 },
    // … the rest of the published table (145 currencies vs USD)
  ],
  disclaimer: '…'
}

日期表

已付计划。 自2001年以来任何日期的正式表格——周末和节假日返回最近公布的日期,通过 published_on_requested_date,这恰恰是实际费率 备案需求.

import { getRatesForDate } from '@allratestoday/ustreasury-exchange-rate';

const day = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...' });
// Optionally narrow to one pair:
const one = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...', source: 'USD', target: 'EUR' });

回应:

{
  bank: 'ustreasury',
  requested_date: '2026-06-30',
  rate_date: '2026-06-30',                // the date actually published
  published_on_requested_date: true,      // false when a weekend/holiday fell back
  rates: [ /* the full table for that date */ ],
  disclaimer: '…'
}

每日时间序列

已付计划。 每个出版日期有一个解决的费率——可供制图、重新估价或审计工作文件使用.

import { getHistory } from '@allratestoday/ustreasury-exchange-rate';

const series = await getHistory(
  { source: 'USD', target: 'EUR', from: '2026-01-01', to: '2026-09-30' },
  { apiKey: 'art_live_...' }
);

回应:

{
  bank: 'ustreasury',
  source: 'USD',
  target: 'EUR',
  from: '2026-01-01',
  to: '2026-09-30',
  count: 152,
  rates: [
    // one entry per publication date
    { date: '2026-09-30', rate: 0.881, rate_type: 'quarterly', derived: false, method: 'published' },
    // …
  ],
  disclaimer: '…'
}

过 { symbol: 'EUR' } 改为 source编号 :target 以获得一种货币的原始出版行(所有速率类型,无对分辨率).

* 涵盖的货币

美国财政部目前公布的费率涵盖: 145个货币 (截至最新表格):

🇦🇪 AED • 妇女 AFN • 妇女 ALL • 妇女 AMD • 妇女 AOA • 妇女 ARS • 妇女 AUD • 妇女 AZN • 妇女 BAM • 妇女 BBD • 妇女 BDT • 妇女 BGN • 妇女 BHD • 妇女 BIF • 妇女 BMD • 妇女 BND • 妇女 BOB • 妇女 BRL • 妇女 BSD • 妇女 BWP • 妇女 BYN • 妇女 BZD • 妇女 CAD • 妇女 CDF • 妇女 CHF • 妇女 CLP • 妇女 CNY • 妇女 COP • 妇女 CRC • 妇女 CUC • 妇女 CUP • 妇女 CVE • 妇女 CZK • 妇女 DJF • 妇女 DKK • 妇女 DOP • 妇女 DZD • 妇女 EGP • 妇女 ERN • 妇女 ETB • 妇女 EUR • 妇女 FJD • 妇女 GBP • 妇女 GEL • 妇女 GHS • 妇女 GMD • 妇女 GNF • 妇女 GTQ • 妇女 GYD • 妇女 HKD • 妇女 HNL • 妇女 HTG • 妇女 HUF • 妇女 IDR • 妇女 ILS • 妇女 INR • 妇女 IQD • 妇女 IRR • 妇女 ISK • 妇女 JMD • 妇女 JOD • 妇女 JPY • 妇女 KES • 妇女 KGS • 妇女 KHR • 妇女 KMF • 妇女 KRW • 妇女 KWD • 妇女 KYD • 妇女 KZT • 妇女 LAK • 妇女 LBP • 妇女 LKR • 妇女 LRD • 妇女 LSL • 妇女 LYD • 妇女 MAD • 妇女 MDL • 妇女 MGA • 妇女 MKD • 妇女 MMK • 妇女 MNT • 妇女 MRU • 妇女 MUR • 妇女 MVR • 妇女 MWK • 妇女 MXN • 妇女 MYR • 妇女 MZN • 妇女 NAD • 妇女 NGN • 妇女 NIO • 妇女 NOK • 妇女 NPR • 妇女 NZD • 妇女 OMR • 妇女 PEN • 妇女 PGK • 妇女 PHP • 妇女 PKR • 妇女 PLN • 妇女 PYG • 妇女 QAR • 妇女 RON • 妇女 RSD • 妇女 RUB • 妇女 RWF • 妇女 SAR • 妇女 SBD • 妇女 SCR • 妇女 SDG • 妇女 SEK • 妇女 SGD • 妇女 SLE • 妇女 SOS • 妇女 SRD • 妇女 SSP • 妇女 STN • 妇女 SYP • 妇女 SZL • 妇女 THB • 妇女 TJS • 妇女 TMT • 妇女 TND • 妇女 TOP • 妇女 TRY • 妇女 TTD • 妇女 TWD • 妇女 TZS • 妇女 UAH • 妇女 UGX • 妇女 UYU • 妇女 UZS • 妇女 VES • 妇女 VND • 妇女 VUV • 妇女 WST • 妇女 XAF • 妇女 XCD • 妇女 XCG • 妇女 XOF • 妇女 YER • 妇女 ZAR • 妇女 ZMW • 妇女 ZWG

来源

美国财政部通过财政局每季度公布"财政报告汇率". 每个美国政府机构都必须使用这些汇率将外国货币余额转换成美元作为正式报告,承包商、赠款接受人和审计员也采用同样的表格。 汇率在季度中,当货币急剧波动时,将加以修正.

• 出版社自己的页面 : 财务报告汇率 • 妇女 网址:www.treasury.gov
• 出版:每个季度;准确的时间安排、新鲜度状况和任何目前的拖延时间都在 美国财政部税率页面
• 价值没有修改, 由出版商自己存储 rate_date 在每一行——见 方法

读取数字

• value 总是 每单位基准货币的引号 (单位:千美元)base: "EUR", quote: "USD", value: 1.15 1欧元=1.15美元).
• 美国财政部引文 1美元兑换外币 (例如:. base: "USD", quote: "USD" 即每美元1美元美元).
• 要换个角度吗? 询问 getRate(target, source) 和标注的 API 反转或交叉 derived: true ——从遵守工作流程中从不将公布的评分自己分出.
• rate_type 告诉你税务局的系列中哪一个属于quarterly 这里);一些出版商的印刷品购买/销售或为同一对进行几件固定.

ERP和会计系统

将美国财政部的官方利率装入会计系统是支持的工作流程,而不是黑客. 各系统所期望的方向的分步指南:

• 365 商业中心 ——内置货币汇率服务,无编码
• 西罗 • 妇女 在线快书 • 妇女 SAP S/4HANA 和ECC 运输公司 • 妇女 奥都

相同的按键端点返回 ?format=csv, (中文(简体) ), ?format=xml 财务报告和审定财务报表 ?format=xlsx,并接受键为 ?api_key= 无法发送信头的导入者 :

curl "https://allratestoday.com/api/v1/central-bank/ustreasury/latest?format=xml&api_key=art_live_..."

AI探员

• MCP 服务器 : npx -y @allratestoday/central-bank-mcp (stdio)或主机端点 https://allratestoday.com/api/mcp 官方利率、历史、跨银行比较和出版日历工具
• 已经使用通用的 SDK 或 MCP 服务器了吗 ? 自2026-10-01年起 @allratestoday/sdk 1.4+ 拥有 officialRates('ustreasury') 财务报告和审定财务报表 @allratestoday/mcp-server 0.6+有一个 get_official_rates 工具 —— 两者都返回源代码的最新表格, 没有密钥, 这样您就可以在不依赖第二个的情况下添加它
• Claude 代码插件( 无密钥) : /plugin marketplace add AllRates-Today/claude-code-plugin 接下来 /plugin install allratestoday@allratestoday 捆绑 MCP 服务器外加一个 /official-rate ustreasury ... 命令
• 评估? 特工可以自行签发一个没有注册的审判密钥: POST https://allratestoday.com/api/agent/keys (发送) Content-Type: application/json返回一个有效期为7天的100调键,涵盖自由计划方法(最新表格、对);日期表和历史需要一个 付费计划MCP服务器将其曝光为 request_trial_key
• 机器可读网站指南 : 页:1 • 妇女 用于援助的代理人

* 公布与衍生费率

如果美国财政部不直接打印一对,API从税务当局自己的表格中解决,并说是这样——官方和计算值永远不会被混淆:

QQ 处理出错

错误显示为 Error 与 status (HTTP代码)和 body (API的JSON错误)附后:

try {
  const pair = await getRate('USD', 'XXX', { apiKey: 'art_live_...' });
} catch (err) {
  console.log(err.message); // human-readable reason
  console.log(err.status);  // e.g. 404
}

QQ 类型脚本

载有全套定义的船舶——否 @types 安装 :

import type { LatestRates, PairRate, DatedRates, RateEntry, HistoryQuery, RequestOptions } from '@allratestoday/ustreasury-exchange-rate';

常规JS

const { getRate } = require('@allratestoday/ustreasury-exchange-rate');

getRate('USD', 'EUR', { apiKey: 'art_live_...' }).then((pair) => console.log(pair.rate));

配额提示

• 利率每四分之一变化一次——在当地缓存已公布的表格,而少量的月配额则很长一段时间.
• 每个请求都与你的AllRatesToday配额一致 共享到你的钥匙上的AllRatesToday终点.

方法参考

QQ 批量数据( 无密钥)

需要整个档案 而不是API的电话? 同样的公布的表格每天与开放数据相映射:

• 拥抱相: 今天/中央银行汇率 - 每个机构1个CSV(rates/ustreasury.csv(中文(简体) )
• 凯格: 每日汇率/中央银行汇率
• Raw JSON在GitHub上说: https://raw.githubusercontent.com/AllRates-Today/central-bank-exchange-rates/main/data/ustreasury/latest.json

链接

• 网站: allatestoday.com (英语)
• 美国财政部税率页面 ——活桌,出版cadence,FAQ
• 所有税务机关来源
• 下载中央银行利率 ——每家银行的最新表格和历史为Excel,CSV或JSON
• 站点上的文件包 • 妇女 企业资源规划整合指南
• API 文档 • 妇女 交互式参考 • 妇女 方法
• 注册( 免费) • 妇女 盘子 • 妇女 定价
• 状态
• 邮递员收藏
• ChatGPT 应用程序 ——向ChatGPT索取活期和官方央行利率
• GitHub 图像

许可证

麻省理工学院