@allratestoday/bcb-exchange-rate

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

官方Banco Central do Brasil (巴西)每日汇率——156种货币对 BRL,自2016年以来的历史. 零依赖性节点.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 USD/BRL today rate date

巴西中央银行(巴西)Node.js和TypeScript的官方每日汇率。 已公布的中央银行在税务申报、海关估价、审计和符合要求的发票之后的利率——不是市场估计,而是Banco Central do Brasil本身印制的数字——每一个工作日.

为什么是这个客户?

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

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

获取您的 API 密钥

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

最近公布的表格

Latest Banco Central do Brasil table

图像从无键端点进行直播,因此它跟随了中央银行在 npm 和 GitHub 上的出版物,没有新的发行. 与文本相同的表格折叠如下, 用于搜索和复制- 粘贴: 在 GitHub 每日行动 中央银行发布新表格时更新;npm上是软件包的发布日期.

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

* 安装

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

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

快速启动

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

const pair = await getRate('USD', 'BRL', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); // the official Banco Central do Brasil rate, on the central bank's own date

API 参考


最新配对率

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

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

回应:

{
  bank: 'bcb',
  name: 'Banco Central do Brasil',
  rate_date: '2026-10-13',   // Banco Central do Brasil's own publication date
  source: 'USD',
  target: 'BRL',
  rate: 5.0096,
  rate_type: 'sell',
  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/bcb-exchange-rate';

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

回应:

{
  bank: 'bcb',
  name: 'Banco Central do Brasil',
  rate_date: '2026-10-13',
  rates: [
    { "base": "USD", "quote": "BRL", "type": "sell", "value": 5.0096 },
    { "base": "USD", "quote": "BRL", "type": "buy", "value": 5.009 },
    // … the rest of the published table (156 currencies vs BRL)
  ],
  disclaimer: '…'
}

日期表

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

import { getRatesForDate } from '@allratestoday/bcb-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: 'BRL' });

回应:

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

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

回应:

{
  bank: 'bcb',
  source: 'USD',
  target: 'BRL',
  from: '2026-01-01',
  to: '2026-10-13',
  count: 152,
  rates: [
    // one entry per publication date
    { date: '2026-10-13', rate: 5.0096, rate_type: 'sell', derived: false, method: 'published' },
    // …
  ],
  disclaimer: '…'
}

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


* 涵盖的货币

巴西中央银行目前公布的费率包括: 156种货币 对 BRL (截至最新表格):

🇦🇪 AED • 妇女 AFN • 妇女 ALL • 妇女 AMD • 妇女 AOA • 妇女 ARS • 妇女 AUD • 妇女 AWG • 妇女 AZN • 妇女 BBD • 妇女 BDT • 妇女 BHD • 妇女 BIF • 妇女 BMD • 妇女 BND • 妇女 BOB • 妇女 BSD • 妇女 BTN • 妇女 BWP • 妇女 BYN • 妇女 BZD • 妇女 CAD • 妇女 CDF • 妇女 CHF • 妇女 CLF • 妇女 CLP • 妇女 CNH • 妇女 CNY • 妇女 COP • 妇女 COU • 妇女 CRC • 妇女 CUP • 妇女 CVE • 妇女 CZK • 妇女 DJF • 妇女 DKK • 妇女 DOP • 妇女 DZD • 妇女 EGP • 妇女 ERN • 妇女 ETB • 妇女 EUR • 妇女 FJD • 妇女 FKP • 妇女 GBP • 妇女 GEL • 妇女 GHS • 妇女 GIP • 妇女 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 • 妇女 MOP • 妇女 MRO • 妇女 MRU • 妇女 MUR • 妇女 MVR • 妇女 MWK • 妇女 MXN • 妇女 MYR • 妇女 MZN • 妇女 NAD • 妇女 NGN • 妇女 NIO • 妇女 NOK • 妇女 NPR • 妇女 NZD • 妇女 OMR • 妇女 PAB • 妇女 PEN • 妇女 PGK • 妇女 PHP • 妇女 PKR • 妇女 PLN • 妇女 PYG • 妇女 QAR • 妇女 RON • 妇女 RSD • 妇女 RUB • 妇女 RWF • 妇女 SAR • 妇女 SBD • 妇女 SCR • 妇女 SDG • 妇女 SDR • 妇女 SEK • 妇女 SGD • 妇女 SHP • 妇女 SLL • 妇女 SOS • 妇女 SRD • 妇女 SSP • 妇女 STN • 妇女 SVC • 妇女 SYP • 妇女 SZL • 妇女 THB • 妇女 TJS • 妇女 TMT • 妇女 TND • 妇女 TOP • 妇女 TRY • 妇女 TTD • 妇女 TWD • 妇女 TZS • 妇女 UAH • 妇女 UGX • 妇女 USD • 妇女 UYU • 妇女 UZS • 妇女 VES • 妇女 VND • 妇女 VUV • 妇女 WST • 妇女 XAF • 妇女 XAU • 妇女 XCD • 妇女 XCG • 妇女 XOF • 妇女 XPF • 妇女 YER • 妇女 ZAR • 妇女 ZMW

来源

巴西中央银行(Banco Central do Brasil)是巴西的中央银行. 其PTAX率——真实值的官方参考率——从每个营业日的经销商调查中计算出,关闭公告公布于巴西利亚时间下午一早. 该公报涵盖约155种货币,其收尾销售率也是巴西海关根据Portaria MF第6/1999号规定对进口进行估价的费率——因此巴西没有单独的税务授权率.

  • 出版社自己的页面 : PTAX汇率 • 妇女 联合国
  • 出版:每一个工作日;准确的时间安排、新鲜度状况和目前的任何延误均在 巴西中央银行利率页
  • 在API中:通常通过 协调世界时17:15 (根据过去10个出版物衡量) 在此时或之后安排同步并按小时重试直至 rate_date 移动;每个响应都带有与 available_by_utc 看到了吗 何时投票
  • 价值没有修改, 由出版商自己存储 rate_date 在每一行——见 方法

读取数字

  • value 总是 每单位基准货币的引号 (单位:千美元)base: "EUR", quote: "USD", value: 1.15 1欧元=1.15美元).
  • 巴西中央银行引述 每单位外币BRL (例如:. base: "USD", quote: "BRL" 表示每美元BRL).
  • 要换个角度吗? 询问 getRate(target, source) 和标注的 API 反转或交叉 derived: true ——从遵守工作流程中从不将公布的评分自己分出.
  • 贵金属编码XAU, (中文(简体) ), XAG, (中文(简体) ), XPT, (中文(简体) ), XPD引用) 每克盎司。 。 。 .
  • rate_type 告诉你中央银行的系列中哪一个属于(sell 这里);一些出版商的印刷品购买/销售或为同一对进行几件固定.

ERP和会计系统

将官方的Banco Central do Brasil利率装入会计系统是一种支持的工作流程,而不是黑客. 各系统所期望的方向的分步指南:

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

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

* 公布与衍生费率

如果Banco Central do Brasil不直接打印一对,API从中央银行自己的表格中解决,并这样说——官方和计算值永远不会混淆:

methodderived含义
publishedfalse中央银行直接打印了这对
inversetrue计算为 1 QQ 已公布的相反方向
crosstrue通过BRL从两个公布的比率计算

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
}
状态含义
—— 说失踪 apiKey (在任何请求之前提出)
400日期或参数不正确
401无效的 API 密钥
403端点需要一个 付费计划 (历史日期和系列)
404巴西中央银行未涵盖的对等或日期范围
429月配额超过

QQ 类型脚本

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

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

常规JS

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

getRate('USD', 'BRL', { 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 })已支付2016年以来的每日系列

QQ 批量数据( 无密钥)

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

许可证

麻省理工学院

版本与发布记录

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

版本发布日期距今
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/bcb-exchange-rate 的常见问题

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

官方Banco Central do Brasil (巴西)每日汇率——156种货币对 BRL,自2016年以来的历史. 零依赖性节点.js/TypeScript客户端.

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

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

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

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

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

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

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

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

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

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

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

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

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

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