@allratestoday/bazg-exchange-rate

中文文档
1.3.27发布于 2026/11/03MITTypeScriptESM + CJS零依赖近 30 天下载 2032

瑞士联邦海关和边境安全局(瑞士)官方每日汇率——73种货币对瑞士法郎,2000年以来的历史。 零依赖性节点.js/TypeScript客户端.

中文使用文档
文档目录24 节
  1. 为什么是这个客户?
  2. 获取您的 API 密钥
  3. 最近公布的表格
  4. * 安装
  5. 快速启动
  6. API 参考
  7. 最新配对率
  8. 完整公布的表格
  9. 日期表
  10. 每日时间序列
  11. * 涵盖的货币
  12. 来源
  13. 读取数字
  14. ERP和会计系统
  15. AI探员
  16. * 公布与衍生费率
  17. QQ 处理出错
  18. QQ 类型脚本
  19. 常规JS
  20. 配额提示
  21. 方法参考
  22. QQ 批量数据( 无密钥)
  23. 链接
  24. 许可证

瑞士联邦海关和边境安全局

npm version license zero dependencies TypeScript EUR/CHF today rate date

瑞士联邦海关和边境安全局官方(瑞士)Node.js和TypeScript的每日汇率。 税务申报、海关估价、审计和符合要求的发票后面公布的税务当局税率——不是市场估计,而是瑞士联邦海关和边境安全局自己印制的数字——每一个工作日.

为什么是这个客户?

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

官方汇率,不是中市: 这里的每个价值都是瑞士联邦海关和边境安全局自己出版的、印出后固定的和税务当局自己的数字 rate_date 申报和审计需要什么。 需要现场市场汇率来定价还是展示? 使用 市场中间API 或者说 @allratestoday/sdk两者可以相差几个百分点.

获取您的 API 密钥

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

最近公布的表格

Latest Swiss Federal Office for Customs and Border Security table

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

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

* 安装

npm install @allratestoday/bazg-exchange-rate
yarn add @allratestoday/bazg-exchange-rate
pnpm add @allratestoday/bazg-exchange-rate

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

快速启动

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

const pair = await getRate('EUR', 'CHF', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); // the official Swiss Federal Office for Customs and Border Security rate, on the tax authority's own date

API 参考


最新配对率

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

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

回应:

{
  bank: 'bazg',
  name: 'Swiss Federal Office for Customs and Border Security',
  rate_date: '2026-10-15',   // Swiss Federal Office for Customs and Border Security's own publication date
  source: 'EUR',
  target: 'CHF',
  rate: 0.94191,
  rate_type: 'reference',
  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/bazg-exchange-rate';

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

回应:

{
  bank: 'bazg',
  name: 'Swiss Federal Office for Customs and Border Security',
  rate_date: '2026-10-15',
  rates: [
    { "base": "EUR", "quote": "CHF", "type": "reference", "value": 0.94191 },
    { "base": "EUR", "quote": "CHF", "type": "monthly_average", "value": 0.9507 },
    // … the rest of the published table (73 currencies vs CHF)
  ],
  disclaimer: '…'
}

日期表

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

import { getRatesForDate } from '@allratestoday/bazg-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: 'EUR', target: 'CHF' });

回应:

{
  bank: 'bazg',
  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/bazg-exchange-rate';

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

回应:

{
  bank: 'bazg',
  source: 'EUR',
  target: 'CHF',
  from: '2026-01-01',
  to: '2026-10-15',
  count: 152,
  rates: [
    // one entry per publication date
    { date: '2026-10-15', rate: 0.94191, rate_type: 'reference', derived: false, method: 'published' },
    // …
  ],
  disclaimer: '…'
}

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


* 涵盖的货币

瑞士联邦海关和边境安全局目前公布的费率包括: 73种货币 (截至最新表格):

🇦🇪 AED • 妇女 ALL • 妇女 ARS • 妇女 AUD • 妇女 AZN • 妇女 BAM • 妇女 BDT • 妇女 BGN • 妇女 BHD • 妇女 BRL • 妇女 CAD • 妇女 CLP • 妇女 CNY • 妇女 COP • 妇女 CRC • 妇女 CZK • 妇女 DKK • 妇女 DOP • 妇女 DZD • 妇女 EGP • 妇女 ETB • 妇女 EUR • 妇女 GBP • 妇女 GEL • 妇女 GTQ • 妇女 HKD • 妇女 HNL • 妇女 HUF • 妇女 IDR • 妇女 ILS • 妇女 INR • 妇女 ISK • 妇女 JPY • 妇女 KES • 妇女 KHR • 妇女 KRW • 妇女 KWD • 妇女 KYD • 妇女 KZT • 妇女 LBP • 妇女 LKR • 妇女 LYD • 妇女 MAD • 妇女 MUR • 妇女 MXN • 妇女 MYR • 妇女 NGN • 妇女 NOK • 妇女 NZD • 妇女 OMR • 妇女 PAB • 妇女 PEN • 妇女 PHP • 妇女 PKR • 妇女 PLN • 妇女 QAR • 妇女 RON • 妇女 RSD • 妇女 RUB • 妇女 SAR • 妇女 SEK • 妇女 SGD • 妇女 THB • 妇女 TND • 妇女 TRY • 妇女 TWD • 妇女 TZS • 妇女 UAH • 妇女 USD • 妇女 UYU • 妇女 VES • 妇女 VND • 妇女 ZAR

来源

联邦海关和边境安全局规定了适用于瑞士海关申报和进口增值税的汇率。 它每工作上午公布一个合法有效的费率——星期五的出版物涵盖周末和星期一——这使它成为瑞士唯一正式的每日费率:瑞士国家银行每月公布平均汇率,而不是每日固定汇率.

读取数字

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

ERP和会计系统

将瑞士联邦海关和边境安全局的官方费率装入会计系统是辅助工作流程,而不是黑客。 各系统所期望的方向的分步指南:

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

curl "https://allratestoday.com/api/v1/central-bank/bazg/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('bazg') 财务报告和审定财务报表 @allratestoday/mcp-server 0.6+有一个 get_official_rates 工具 —— 两者都返回源代码的最新表格, 没有密钥, 这样您就可以在不依赖第二个的情况下添加它
  • Claude 代码插件( 无密钥) : /plugin marketplace add AllRates-Today/claude-code-plugin 接下来 /plugin install allratestoday@allratestoday 捆绑 MCP 服务器外加一个 /official-rate bazg ... 命令
  • 评估? 特工可以自行签发一个没有注册的审判密钥: POST https://allratestoday.com/api/agent/keys (发送) Content-Type: application/json返回一个有效期为7天的100调键,涵盖自由计划方法(最新表格、对);日期表和历史需要一个 付费计划MCP服务器将其曝光为 request_trial_key
  • 机器可读网站指南 : 页:1 • 妇女 用于援助的代理人

* 公布与衍生费率

如果瑞士联邦海关和边境安全局不直接打印一对,API从税务当局自己的表格中解决,并说是这样——官方和计算值永远不会混淆:

methodderived含义
publishedfalse税务局直接印制了这副
inversetrue计算为 1 QQ 已公布的相反方向
crosstrue通过共同人道主义基金从两个公布的比率计算

QQ 处理出错

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

try {
  const pair = await getRate('EUR', 'XXX', { apiKey: 'art_live_...' });
} catch (err) {
  console.log(err.message); // human-readable reason
  console.log(err.status);  // e.g. 404
}
状态含义
—— 说失踪 apiKey (在任何请求之前提出)
400日期或参数不正确
401无效的 API 密钥
403端点需要一个 付费计划 (历史日期和系列)
404瑞士联邦海关和边境安全局未涵盖的对等或日期范围
429月配额超过

QQ 类型脚本

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

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

常规JS

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

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

配额提示

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

方法参考

方法计划说明
getRate(source, target, { apiKey })免费一对的最新费率,从公布的表格中解决
getLatestRates({ apiKey })免费税务局最新公布的表格
getRatesForDate(date, { apiKey, source?, target? })已支付YYY-MM-DD 日期的官方表格( 或一对)
getHistory({ symbol | source+target, from?, to? }, { apiKey })已支付2000年以来的每日系列

QQ 批量数据( 无密钥)

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

许可证

麻省理工学院

版本与发布记录

@allratestoday/bazg-exchange-rate 共发布 26 个版本,首次发布于 2026/08/10;过去 12 个月发布了 26 个版本。

版本发布日期距今
1.3.27latest2026/11/035 天前
1.3.262026/11/016 天前
1.3.252026/10/317 天前
1.3.242026/10/308 天前
1.3.222026/10/299 天前
1.3.192026/10/2711 天前

关于 @allratestoday/bazg-exchange-rate 的常见问题

@allratestoday/bazg-exchange-rate 是什么?

瑞士联邦海关和边境安全局(瑞士)官方每日汇率——73种货币对瑞士法郎,2000年以来的历史。 零依赖性节点.js/TypeScript客户端.

如何安装 @allratestoday/bazg-exchange-rate?

在项目目录运行 npm install @allratestoday/bazg-exchange-rate,或使用 pnpm add / yarn add / bun add。

@allratestoday/bazg-exchange-rate 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@allratestoday/bazg-exchange-rate 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@allratestoday/bazg-exchange-rate 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@allratestoday/bazg-exchange-rate 可以商用吗?

@allratestoday/bazg-exchange-rate 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@allratestoday/bazg-exchange-rate 的下载量有多少?

根据 npm 官方下载统计,@allratestoday/bazg-exchange-rate 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,032 次,日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@allratestoday/bazg-exchange-rate 还在维护吗?

最新版本 1.3.27 发布于 2026/11/03(5 天前);至今共发布 26 个版本,其中过去 12 个月发布了 26 个;首次发布于 2026/08/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。