finwire.pl - Polish financial data

finwire API - 波兰免费金融数据 API（NBP、GUS、RCN）

**finwire API 是一个免费的开放 REST API，提供波兰的金融、劳动力市场和房地产数据：NBP 政策利率、CPI 通胀、NBP 汇率、10 年期政府债券收益率、公证契约中的公寓交易价格、租金、住房供应量、按职业划分的工资、按省和县划分的失业率，以及经济日历。**无需 API 密钥，通过 HTTPS 提供 JSON，附带 OpenAPI 3 规范；每个响应都包含主要来源和可直接粘贴的引用。由 finwire.pl 构建并维护。

curl "https://public-api.finwire.pl/v1/series/interest-rate/stopa-referencyjna?days=90"

• 基础 URL： https://public-api.finwire.pl
• 身份验证： 无——无需密钥，无需注册，仅支持 GET，已启用 CORS（可在浏览器中使用）
• 格式： JSON、UTF-8，{ data, meta } 信封结构
• 规范： openapi.json · 交互式参考 · llms.txt · 数据集页面
• 数据许可： finwire 指标和汇总数据采用 CC BY 4.0；公共数据需注明原始来源；各数据集的许可信息位于其 license 字段中
• WIBOR 和 POLSTR： 不提供。这些是 GPW Benchmark 的数据；重新分发需与 GPW 签订市场数据许可协议（gpwbenchmark.pl）
• 变更： CHANGELOG.md

波兰语介绍： 提供免费的波兰数据 API，包括 NBP 利率、CPI 通胀（GUS）、NBP 汇率、债券收益率、来自房地产价格登记册的公寓交易价格、租金和租赁收益率、住房供应量、GUS 工资（也按职业划分）、按省和县划分的失业率、入门门槛（申请住房贷款需要赚多少钱）、房产税上限、宏观经济数据发布时间表。无需密钥或注册。波兰语说明：finwire.pl/otwarte-api。

---

目录

• 数据覆盖范围
• 使用场景
• 快速开始
• 面向 AI 助手的 MCP 服务
• 响应格式和引用
• 端点
• 常见问题
• 术语表
• OpenAPI 规范和 TypeScript 类型
• 速率限制
• 使用政策和免责声明

---

数据覆盖范围

每个数据集均来自其主要来源，并以统一格式提供；来源信息位于 meta 中。

每个数据集名称都链接到其文档页面，页面包含字段、来源和引用。

数据	端点	主要来源	更新频率	历史数据
NBP 政策利率（参考利率、典当利率、存款利率、再贴现利率、贴现利率）	/v1/series/interest-rate/{id}	NBP	MPC 决议公布时	最长 10 年
CPI 通胀率（同比、环比）	/v1/series/cpi	GUS	每月	自 1982 年起
NBP 汇率（A 表中间价、C 表买入价／卖出价）	/v1/series/fx/{code}	NBP	每日（工作日）	最长 10 年
10 年期政府债券收益率：波兰、德国、欧元区、欧盟及利差	/v1/series/bond-yields/{geo}	Eurostat irt_lt_mcby_m	每月	自 2001 年起
零售政府债券（OTS、ROR、DOR、TOS、COI、EDO、ROS、ROD）	/v1/bonds	财政部	每月发行	当前发行
每平方米公寓成交价格（中位数、四分位数、一手／二手房）—17 个城市及其城区	/v1/housing/transactions/{city}	房地产价格登记处（RCN，GUGiK及城市登记处）	每季度，逐日摄取	各城市最近 12 个季度
每平方米住房价格，覆盖 17 个城市	/v1/series/housing/{city}	GUS	每季度	最近几个季度
住房供应：每千人住房数、竣工数、许可数、迁移	/v1/housing/supply/{city}	GUS BDL，2021 年人口普查	每年	自 2010 年起
挂牌租金，按城市和城区划分	/v1/rent/{city}	znajdznajem.pl	每日快照	当前月份及上个月
租金收益率（毛收益率、净收益率、回本期）	/v1/rent/yield	finwire.pl（租金及 RCN 价格）	每日	当前数据
工资：中位数、百分位数、16 个省	/v1/wages	GUS	GUS 发布时	当前数据
按职业划分的工资：均值、中位数、十分位数、性别差距 — 约 175 个组别	/v1/wages/occupations/{code}	GUS	每 2 年	调查批次
登记失业率：波兰、16 个省、失业率最高／最低的县	/v1/series/unemployment	GUS BDL	每月	自 2011 年起
宏观经济指标：GDP、零售额、产出、CPI、失业率、工资、汇率、信贷、限额	/v1/macro/indicators	GUS、NBP、Eurostat、财政部	发布时	各指标的完整历史数据
消费者信心：BWUK、WWUK 及 13 项分项指标	/v1/macro/consumer-sentiment	GUS	每月	自 2010 年起
按省份划分的企业部门平均工资	/v1/wages/enterprise	GUS	每月	2 年
黄金价格（1 g，成色 1000）	/v1/series/gold	NBP	每日（工作日）	自 2013 年起
燃油最高价格：Pb95、Pb98、柴油	/v1/fuel-prices	能源部长（Monitor Polski）	公告发布时	所有公告
受监管的电价和燃气价格：家庭用电价 G11、G12、G12w，以及 W-1.1 至 W-4	/v1/energy/regulated-prices	URE 主席（费率决议）	新决议发布时	生效中的费率年度
经纪账户费用：GPW、美国和德国股票的佣金、账户费和外汇费用	/v1/brokers	经纪商官方收费表，由 finwire.pl 汇编	每周核查	当前收费表
法律变更追踪：即将生效的法案、Sejm 审议中的法案	/v1/legal-changes	Sejm ELI API	每日	即将发生及近期变更
按市镇和县划分的居民收入	/v1/income/municipalities	财政部（Rb-27S）、GUS BDL，由 finwire.pl 计算	每年更新，每季度更新一次	各预算年度
20 个城市的住房日常开支	/v1/housing/upkeep/{city}	GUS BDL	每年	最近一年
欧洲房价和住房条件	/v1/housing/europe	Eurostat	每季度、每年	自 2010 年起（住房条件）
银行信贷调查	/v1/credit-market/survey	NBP	每季度	各期调查
家庭贷款和存款	/v1/credit-market/monetary	NBP	每月	最长 400 个月
欧洲新贷款利率	/v1/credit-market/ecb-rates	ECB MIR	每月	自 2014 年起
经济日历：MPC（RPP）决议、CPI、工资、GDP、失业率	/v1/calendar	GUS、NBP，由 finwire.pl 汇编	持续更新	即将发生的事件
IKE／IKZE 缴款限额	/v1/legal-limits	家庭部公告	每年	当前年份
房产税最高限额	/v1/legal-limits/local-tax	财政部长（Monitor Polski）	每年	已公布的纳税年度
存款、储蓄、抵押贷款和现金贷款利率汇总	/v1/market/*	finwire.pl（市场报价汇总）	每日	当前数据
准入门槛：在 17 个城市购买一套样板公寓所需的抵押贷款工资门槛	/v1/index/entry-threshold	finwire.pl（GUS 价格、抵押贷款报价、GUS 工资分布）	每日	自 2026 年 9 月起
Finwire Nowcast：CPI 和核心通胀率预测及 RPP 决议预测	/v1/macro/nowcast	finwire.pl 模型（输入：GUS、NBP、EC Oil Bulletin）	每日更新，发布前 3 个工作日冻结	回测数据自 2019 年起（CPI、核心通胀），自 2012 年起（RPP）
finwire 指标：信贷压力地图、景气指数	/v1/index/*	finwire.pl（根据上述数据计算）	每日（信贷压力），每月（景气指数）	景气指数自 2015 年起
聚合数据绝不披露单笔报价、契约或挂牌信息，只提供中位数、百分位数和数量。

---

用例

• 房贷和储蓄计算器 - 一次调用即可获取 NBP 参考利率和市场房贷利率中位数（/v1/snapshot）。
• 新闻编辑部和研究图表 - 1982 年以来的 CPI、2011 年以来的失业率、2001 年以来的债券收益率，并在 meta 中提供可直接使用的引用。
• 房地产分析 - 17 个城市的分区交易价格、租金、租金收益率和住房供应量。
• 劳动力市场和 HR - 按职业划分的工资、十分位数和性别薪酬差距，以及按县划分的失业率。
• 个人理财应用 - IKE/IKZE 限额、零售债券利率、存款和储蓄利率中位数。
• AI 助手和 Agent - MCP 服务（Streamable HTTP，无需密钥）可向 Claude、ChatGPT、Cursor、VS Code 和其他 MCP 客户端提供利率、外汇、房价、租金、信贷市场、法律限额、法律变更和宏观数据；llms.txt 和 OpenAPI 规范以机器可读形式描述每个数据集。

---

快速开始

curl

# Current table of NBP policy rates
curl "https://public-api.finwire.pl/v1/series/interest-rate"

# Median flat transaction price per m² by district in Kraków
curl "https://public-api.finwire.pl/v1/housing/transactions/krakow"

# Next 10 macro releases and MPC decisions
curl "https://public-api.finwire.pl/v1/calendar?limit=10"

JavaScript / TypeScript（浏览器或 Node 18+）

const res = await fetch('https://public-api.finwire.pl/v1/series/interest-rate/stopa-referencyjna?days=365');
const { data, meta } = await res.json();
console.log(data.points.at(-1), meta.citation);

Python

import requests

r = requests.get("https://public-api.finwire.pl/v1/series/cpi", params={"type": "monthly", "limit": 24})
payload = r.json()
for row in payload["data"]["entries"]:
    print(row["period"], row["yoy"])
print(payload["meta"]["citation"])

---

面向 AI 助手的 MCP 服务

https://public-api.finwire.pl/mcp - 基于 Streamable HTTP 的 Model Context Protocol，无状态、无需密钥、只读。与 /v1 使用相同的数据、白名单和许可证。

客户端	连接方式
Claude（claude.ai、Desktop）	设置 - 连接器 - 添加自定义连接器 - URL https://public-api.finwire.pl/mcp
Claude Code	claude mcp add --transport http finwire https://public-api.finwire.pl/mcp
ChatGPT	在开发者模式中打开连接器 - 使用上述 URL 创建连接器，无需身份验证
Cursor	~/.cursor/mcp.json：{"mcpServers": {"finwire": {"url": "https://public-api.finwire.pl/mcp"}}}
VS Code	.vscode/mcp.json：{"servers": {"finwire": {"type": "http", "url": "https://public-api.finwire.pl/mcp"}}}

工具（全部为只读，且均带有 outputSchema）：

• 宏观：get_macro_snapshot、list_macro_indicators、get_macro_indicator、compare_macro_indicators、get_macro_changes、get_macro_calendar
• 利率和价格：get_interest_rates（NBP）、get_currency_rates（NBP 外汇、黄金）、get_fuel_prices、get_energy_prices（URE 电力和天然气资费）
• 预测：get_nowcast（Finwire Nowcast：CPI 和核心通胀、RPP 决策概率、准确度）
• 住房：get_housing_prices（公证契约、城市和分区）、get_rents（租金、租金收益率）、get_housing_costs
• 信贷、储蓄和投资：get_credit_market、get_bank_rates（仅聚合数据，无单笔报价；零售债券）、get_broker_fees（经纪费用表）
• 法律：get_legal_limits（IKE/IKZE、PIT、最低工资、地方税限额）、get_legal_changes
• 地区和欧洲：get_regional_data、get_europe_data
• 任意数据集：search_datasets、get_dataset

每个结果都包含数据所属时期、原始来源、license、可直接使用的 citation 和 url - 指向 finwire.pl 页面的链接，其中提供完整表格、图表和计算器（带有 utm_source=mcp）。资源：macro://catalog、finwire://datasets、finwire://dataset/{id}；提示词：macro_briefing、explain_indicator、city_housing_report、personal_finance_limits。

发现入口：服务卡片（application/mcp-server-card+json）、/.well-known/ai-catalog.json、注册表清单 server.json。

---

响应格式和引用

每个响应都使用相同的封装格式。以下值仅供示例参考——请调用端点获取当前数据。

{
  "data": { "...": "dataset-specific payload" },
  "meta": {
    "datasetId": "interest-rates",
    "source": "NBP, GPW Benchmark",
    "sourceUrl": "https://nbp.pl",
    "license": "Public NBP / GPW Benchmark data - attribution required.",
    "asOf": "2026-10-14",
    "fetchedAt": "2026-10-15T08:00:00.000Z",
    "citation": "Source: finwire.pl (NBP, GPW Benchmark), https://public-api.finwire.pl/datasets/interest-rates",
    "docsUrl": "https://public-api.finwire.pl/datasets/interest-rates"
  }
}

• meta.asOf - 数据源中的数据日期（而非请求时间）。
• meta.citation - 可直接使用的署名字符串，包含链接。请原样使用。

引用方式： Source: finwire.pl (<primary source>), https://public-api.finwire.pl/datasets/<dataset-id>

代码	含义
200	正常
404	未知的数据集、指标、城市或 geo 代码
429	超出速率限制（请参阅 Retry-After）
503	主要数据源暂时不可用

---

端点

利率、通胀、外汇、债券收益率、失业率

端点	返回内容
GET /v1/series/interest-rate	NBP 政策利率当前表
GET /v1/series/interest-rate/{id}?days=365	每日历史数据。id：stopa-referencyjna、stopa-lombardowa、stopa-depozytowa、stopa-redyskontowa、stopa-dyskontowa。days：7-3650
GET /v1/series/cpi?type=monthly&limit=24	CPI 同比和环比。type：monthly 或 yearly，limit：1-600
GET /v1/series/fx	NBP 当前外汇表
GET /v1/series/fx/{code}?days=365	外汇历史数据，例如 EUR、USD、CHF、GBP
GET /v1/series/bond-yields	PL、DE、EA、EU27_2020 的最新 10 年期收益率，以及 PL-DE 和 PL-EA 利差（单位：bps）
GET /v1/series/bond-yields/{geo}?since=2015-01	单个 geo 的月度历史数据
GET /v1/series/unemployment	登记失业率：波兰和 16 个省，最新月份及同比变化（单位：pp）
GET /v1/series/unemployment/counties?limit=10	失业率最低和最高的县（powiaty），limit 为 1-50
GET /v1/series/unemployment/history?unit={unitId}	波兰（默认）或某个省自 2011 年以来的月度历史数据（unitId 取自 regions[]）

房地产

端点	返回内容
GET /v1/housing/transactions	17 个城市：根据公证契据计算的每平方米房价中位数、p25、p75，一级市场与二级市场，交易数量、同比变化、季度趋势
GET /v1/housing/transactions/{city}	城市各区：近 12 个月每平方米房价中位数、交易数量、同比变化、与城市中位数的差值
GET /v1/series/housing and /{city}	17 个城市的 GUS 每平方米房价数据，最新季度，以及名义和实际同比变化
GET /v1/rent and /{city}	挂牌租金：中位数、平均值、每平方米价格、月环比变化、各区数据
GET /v1/rent/yield	各城市的毛租金收益率、净租金收益率和回本周期
GET /v1/housing/supply	每 1000 名居民的住宅数量、存量、竣工量、许可证、每人建筑面积、人口和迁移数据：波兰、16 个省、17 个城市；自 2010 年以来的年度数据、2021 年人口普查、GUS 人口预测
GET /v1/housing/supply/{city}	单个城市与所属省及波兰的数据对比、在 17 个城市中的排名、年度历史数据

交易数据中的 provisionalQuarters 列出登记机构仍在补录的季度——请将其视为初步数据。

工资、法律限额、日历、市场汇总数据

Endpoint	返回内容
GET /v1/bonds	按发行批次列出的零售国债利率
GET /v1/wages	GUS 工资中位数、百分位数和各省平均值
GET /v1/wages/occupations	约 175 个职业组的税前工资：均值、中位数、D1-D9 十分位数、男性与女性、公共部门与私营部门、性别工资差距
GET /v1/wages/occupations/{code}	单个职业组及其上级分组和调查版本历史
GET /v1/legal-limits	IKE / IKZE 年度缴款限额及相关数值
GET /v1/legal-limits/local-tax	各纳税年度的房产税税率上限（土地、建筑物、构筑物），附法案和法律依据
GET /v1/macro/indicators	主要指标，包含最新读数、变动、迷你走势图和来源
GET /v1/macro/indicators/{key}/history?from=2020-01	单项指标的完整历史数据
GET /v1/macro/consumer-sentiment	GUS BWUK、WWUK 及各项指标的历史数据
GET /v1/wages/enterprise	GUS 企业部门平均工资、实际变动和各省数据
GET /v1/series/gold	NBP 黄金价格：最新价格、区间变动、历史最高价、12 个月平均价
GET /v1/series/gold/history?range=1y	黄金价格历史，range：1m、1y、5y、max
GET /v1/fuel-prices	最高燃油价格：今日生效价格、明日公布价格及历史数据
GET /v1/energy/regulated-prices?date=2026-10-29	URE 批准并在指定日期（默认今日）生效的居民电力和燃气费率：能源和输配费率、费用、优惠时段时长、每条记录对应的决定和 PDF；金额为净额
GET /v1/brokers	经纪商费率表：按市场划分的佣金、账户和外汇费用、IKE/IKZE、有效促销、费率表 URL 及每周核查状态
GET /v1/legal-changes?days=90	即将和近期生效的法案、众议院待审法案
GET /v1/legal-changes/process/{term}/{number}	单项法案：最新阶段、通过情况、已公布的法案
GET /v1/income/municipalities?year=2025	按市镇划分的居民人均收入：排名、相对于全国平均值的比率、变动
GET /v1/income/counties?year=2025	同上，按县划分
GET /v1/housing/upkeep/{city}	城市公寓的月度日常开支（列表：/v1/housing/upkeep）
GET /v1/housing/europe	Eurostat 房价指数：波兰、欧盟和欧元区对比，以及各国排名
GET /v1/housing/europe/overburden 和 /overcrowding	各国住房成本负担过重率和住房拥挤率
GET /v1/credit-market/survey?quarters=12	NBP 银行贷款调查
GET /v1/credit-market/monetary?months=25	NBP 居民贷款、存款和新增贷款
GET /v1/credit-market/ecb-rates?product=mortgage_total&period=2026-08	ECB 各国新增贷款的 MIR 利率
GET /v1/credit-market/ecb-rates/series?areas=PL,U2,DE&from=2018-01	所选国家的 ECB MIR 历史数据
GET /v1/calendar?limit=10	即将发布的数据和决策，包含日期、华沙时间、类别及 1-10 的重要性评级
GET /v1/market/deposit-rates?amount=10000&period=3	定期存款利率：中位数、百分位数、利差
GET /v1/market/savings-rates?amount=10000	储蓄账户利率：中位数、百分位数
GET /v1/market/mortgage-rates?amount=400000&period=25	抵押贷款 APRC（RRSO）、利差、名义利率：中位数、百分位数
GET /v1/market/cash-loan-rates?amount=20000&period=48	现金贷款 APRC 和名义利率：中位数、百分位数

finwire 指标

端点	返回内容
GET /v1/macro/nowcast	Finwire Nowcast：下一期 CPI 和核心通胀读数（点估计、80% 区间）及 RPP 决策概率、冻结日期和状态、已结算历史数据与实际读数、回测和实时准确率
GET /v1/index/entry-threshold	在 KNF DSTI 限额内，购买模型公寓所需的个人月度税前工资（参数见 params），覆盖 17 个城市；还返回月供及收入至少达到该水平的雇员占比
GET /v1/index/entry-threshold/history?household=single	各城市每日变化点；household：single 或 couple
GET /v1/index/credit-stress	16 个省份中，50 m² 公寓的月供占平均税后工资的比例，以及 KNF Recommendation S 的 DSTI 限额
GET /v1/index	所有晴雨表的数值、相对于历史数据的位置及月度变化
GET /v1/index/{slug}	单个晴雨表的月度序列、方法说明，以及自 2015 年以来表现最佳／最差的月份。slug：real-deposit-rate、housing-affordability、credit-cost、borrowing-power、purchasing-power
GET /v1/snapshot	一次调用即可获取利率、通胀、外汇、信贷压力和晴雨表数据

完整的字段级架构：openapi.json。

---

常见问题

API 会返回 WIBOR 或 POLSTR 吗？

不会。WIBOR 和 POLSTR 由 GPW Benchmark 管理，重新分发需要与 GPW 签署 Market Data License Agreement（[email protected]）。API 返回 NBP 政策利率：当前值见 /v1/series/interest-rate，每日历史数据见 /v1/series/interest-rate/{id}。

在哪里可以获取 JSON 格式的波兰 CPI 通胀数据？

/v1/series/cpi 返回 GUS 消费者价格同比和环比通胀数据，按月提供自 1982 年以来的数据（type=monthly），或按年提供（type=yearly）；meta 中包含 GUS 数据来源。

有波兰房地产交易价格的 API 吗？

/v1/housing/transactions 返回 17 个城市按区划分的公寓每平方米价格中位数、四分位数和价格，这些数据根据波兰房地产价格登记册（Rejestr Cen Nieruchomości）中的公证契约计算；还提供最近 12 个季度的趋势，以及各区的 12 个月中位数。绝不公开单笔契约数据。

在波兰城市买房，我需要赚多少钱？

/v1/index/entry-threshold 返回在 KNF DSTI 限额内购买 17 个波兰城市中模型二手公寓所需的个人月度税前工资。模型公寓面积为 50 m²，首付比例为 20%，贷款期限为 25 年。数据还包括月供，以及收入至少达到该水平的雇员占比。系统每晚根据 GUS 房价、当前抵押贷款报价和 GUS 工资分布重新计算；/history 显示其变化情况。

在哪里可以获取按县（powiat）划分的失业数据？

/v1/series/unemployment 返回波兰全国和 16 个省份的 GUS 登记失业率，/v1/series/unemployment/counties 返回失业率最低和最高的县，/v1/series/unemployment/history 返回自 2011 年以来的月度序列；所有数据均来自 GUS 地方数据银行（BDL）。

有波兰按职业划分的工资 API 吗？

/v1/wages/occupations 返回约 175 个职业组的月度税前工资均值、中位数和十分位数。这些数据来自 GUS 职业工资调查（每两年发布一次），按性别和公共／私营部门划分，并提供性别薪酬差距。

我需要 API 密钥或账户吗？

不需要密钥、令牌或注册。所有端点均为公开、只读（GET）且启用了 CORS，因此可以直接从浏览器调用。

我可以将这些数据用于商业用途吗？

finwire 指标和汇总数据采用 CC BY 4.0 许可，允许商业使用，但须注明出处。公共数据（NBP、GUS、财政部、Eurostat、GPW Benchmark）须注明原始来源；meta.license 会列出各数据集的许可条款。

数据更新得有多及时？

每个数据集都会按照其主要来源自身的时间安排自动刷新 （外汇和租金为每日，CPI 和债券收益率为每月，房价为每季度）。 meta.asOf 始终显示来源数据的日期。

WIBOR 和 POLSTR 有什么区别？

WIBOR 和 POLSTR 都是由 GPW Benchmark 管理的波兰利率基准。在 KNF 监督下持续进行的波兰基准改革中，POLSTR 被指定为 WIBOR 的继任者。本 API 不提供这两项数据（需获得 GPW Benchmark 的许可）。

API 会提供投资建议吗？

不会。数据仅供参考。finwire.pl 并非持牌投资顾问，也不会发布欧盟《市场滥用条例》（MAR）所指的投资建议。

---

术语表

• NBP 基准利率 - Narodowy Bank Polski 的主要政策利率，由货币政策委员会（RPP）制定。
• WIBOR（Warsaw Interbank Offered Rate）- 波兰银行间基准利率，用于浮动利率贷款。
• POLSTR（Polish Short Term Rate）- GPW Benchmark 利率指数，是基准改革中 WIBOR 的继任者。
• CPI - GUS（波兰统计局）每月发布的消费者价格指数。
• RCN（Rejestr Cen Nieruchomości）- 不动产价格登记簿，记录公证契约中的价格。
• RRSO - 波兰年化借款成本率（APRC），即贷款的总成本。
• DSTI - 债务偿付收入比，即用于偿还贷款分期款的收入占比。
• bps - 基点，1 bps = 0.01 个百分点。
• BDL（Bank Danych Lokalnych）- GUS 地方数据银行，提供省、县和市的统计数据。
• TERYT - 波兰省、县和市的官方行政区划代码。
• 准入门槛（próg wejścia）- finwire 指标：购买一套模型公寓并取得抵押贷款所需的工资。
• 房产税上限 - 财政部长每年设定的地方房产税最高税率；各市可在此上限内自行选择税率。

---

OpenAPI 规范和 TypeScript 类型

本仓库包含 OpenAPI 规范及据此生成的 TypeScript 类型。 每次发布时，二者都会根据实时 API 重新生成。

• openapi.json - OpenAPI 3 规范（实时版本：public-api.finwire.pl/openapi.json）
• types/api.ts - 使用 openapi-typescript 生成的 TypeScript 类型

import type { paths } from './types/api';

type TransactionPrices =
  paths['/v1/housing/transactions/{city}']['get']['responses']['200']['content']['application/json'];

---

速率限制

• 每个 IP 每分钟 120 个请求，/v1/snapshot 每分钟 30 个请求。
• 标头：X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset；429 响应会附带 Retry-After。
• 响应会缓存在边缘节点（根据数据集不同，缓存时间为 5 分钟至 1 小时），因此常规使用不会触及限制。

---

使用政策和免责声明

• 免费开放，仅支持 GET。请在本地缓存响应。
• 请使用 meta.citation 字符串或 Source: finwire.pl, https://public-api.finwire.pl 标注数据来源。
• 绝不公开单家银行的报价、公证契约和租房信息；仅提供统计数据。
• 数据仅供参考，不构成投资建议（参见 常见问题）。

由 finwire.pl 构建 - 波兰个人理财工具：抵押贷款决策工具、按城市查看公寓价格、存款排名。