Narodowy Bank Polski 汇率 API
Narodowy Bank Polski(Poland)官方每日汇率,JSON 格式:35 种货币,历史数据可追溯至 2016 年。税务申报、审计与合规开票所需的官方 PLN 汇率。
关于 Narodowy Bank Polski
波兰国家银行是波兰的中央银行。其 A 表外币平均汇率每个工作日华沙时间约 12:00 发布,是波兰会计、税务和海关的法定汇率。
- 官方网站: nbp.pl
- 官方汇率发布页: Exchange rates (Table A)
快速开始
一次请求获取所需货币对 — 按 Narodowy Bank Polski 官方汇率查询 EUR 兑 PLN:
curl "https://allratestoday.com/api/v1/central-bank/nbp/latest?source=EUR&target=PLN" \
-H "Authorization: Bearer art_live_your_key" 或获取银行发布的完整汇率表:
curl "https://allratestoday.com/api/v1/central-bank/nbp/latest" \
-H "Authorization: Bearer art_live_your_key" 付费套餐可查询任意历史日期或每日时间序列:
curl "https://allratestoday.com/api/v1/central-bank/nbp/history?source=EUR&target=PLN&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" 最新发布汇率(2026-08-04)
Narodowy Bank Polski 最近发布的汇率表 — 与 /latest 端点当前返回的内容完全一致。数值为每 1 单位货币对应的 PLN:
| 基准 | 报价 | 类型 | 汇率 |
|---|---|---|---|
AUD | PLN | middle | 2.6312 |
BRL | PLN | middle | 0.7361 |
CAD | PLN | middle | 2.6688 |
CHF | PLN | middle | 4.6244 |
CLP | PLN | middle | 0.00405 |
CNY | PLN | middle | 0.5548 |
CZK | PLN | middle | 0.1781 |
DKK | PLN | middle | 0.5768 |
EUR | PLN | middle | 4.3118 |
GBP | PLN | middle | 5.0363 |
HKD | PLN | middle | 0.4777 |
HUF | PLN | middle | 0.011849 |
IDR | PLN | middle | 0.00020791 |
ILS | PLN | middle | 1.2324 |
INR | PLN | middle | 0.039282 |
ISK | PLN | middle | 0.030365 |
JPY | PLN | middle | 0.023743 |
KRW | PLN | middle | 0.002614 |
MXN | PLN | middle | 0.2165 |
MYR | PLN | middle | 0.9147 |
NOK | PLN | middle | 0.3938 |
NZD | PLN | middle | 2.1996 |
PHP | PLN | middle | 0.0612 |
RON | PLN | middle | 0.8218 |
SEK | PLN | middle | 0.3916 |
SGD | PLN | middle | 2.9188 |
THB | PLN | middle | 0.1121 |
TRY | PLN | middle | 0.0787 |
UAH | PLN | middle | 0.0837 |
USD | PLN | middle | 3.7468 |
XDR | PLN | middle | 5.1072 |
ZAR | PLN | middle | 0.2269 |
Node.js / TypeScript 客户端
专用的零依赖 npm 包封装了这些端点 — nbp-exchange-rate:
npm install nbp-exchange-rate import { getRate } from 'nbp-exchange-rate';
const pair = await getRate('EUR', 'PLN', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); 零依赖,自带 TypeScript 类型,任何有 fetch 的环境都能运行 — Node 18+、Bun、Deno 及边缘运行时。
为什么使用 Narodowy Bank Polski 官方汇率?
市场汇率实时波动,但Poland及其他地区的税务申报、报关、审计和法定会计通常要求使用 Narodowy Bank Polski 在特定日期发布的官方汇率 — 一个固定、可引用、发布后不再变化的数字。本 API 提供的正是这些官方汇率表,每个响应都带有银行自己的发布日期(rate_date);周末和节假日返回最近的发布日期 — 这正是合规规则要求适用的汇率。
银行未直接公布的货币对由其汇率表推算(倒数或经 PLN 的交叉汇率),并明确标记 "derived": true — 银行公布的数字与计算得出的数字绝不混淆。
端点
GET /api/v1/central-bank/nbp/latest— 最新汇率表或单一货币对(所有套餐)GET /api/v1/central-bank/nbp/{YYYY-MM-DD}— 任意日期的汇率表(付费套餐)GET /api/v1/central-bank/nbp/history— 每日时间序列,单次最多 5,000 行(付费套餐)GET /api/v1/central-bank/nbp/availability— 发布日历:银行实际发布汇率表的日期(所有套餐)
完整参数说明见 API 文档。每次请求计入套餐月度配额 — 汇率每个工作日只变一次,本地缓存当日汇率表能让小配额用很久。
常见问题
Narodowy Bank Polski 的汇率有 API 吗?
有 — 就是这个。官方每日 PLN 汇率,干净的 JSON;最新汇率表适用于所有套餐(含免费版)。
汇率多久更新一次?
Narodowy Bank Polski 每个工作日发布一次;API 在发布后很快抓取新表(最新:2026-08-04)。
这些是官方汇率吗?
是 — 取自 Narodowy Bank Polski 自己发布的数据,原样提供并附银行发布日期。凡是计算而非公布的数值都会标记 derived。