finwire.pl - Polish financial data

السجل الرسمي الحكومة والقانون

Live Polish rates, FX, housing prices, rents, credit market, legal limits and macro data.

ماذا يمكنك أن تفعل مع finwire.pl - Polish financial data؟

  • Mortgage and savings calculators - NBP reference rate and market median mortgage rates in one call (/v1/snapshot).
  • Newsroom and research charts - CPI since 1982, unemployment since 2011, bond yields since 2001, with a ready citation in meta.
  • Real estate analysis - transaction prices per district, rents, rental yield and housing supply for 17 cities.
  • Labour market and HR - wages by occupation with deciles and the gender pay gap, unemployment by county.
  • Personal finance apps - IKE/IKZE limits, retail bond rates, deposit and savings rate medians.
  • AI assistants and agents - an MCP server (Streamable HTTP, no key) serves rates, FX, housing prices, rents, the credit market, legal limits, law changes and macro data to Claude, ChatGPT, Cursor, VS Code and other MCP cl...

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http finwire-pl-polish-financial-data 'https://public-api.finwire.pl/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "finwire-pl-polish-financial-data": {
            "type": "http",
            "url": "https://public-api.finwire.pl/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. finwire API - free Polish financial data API (NBP, GUS, RCN)
  2. Contents
  3. Data coverage
  4. Use cases
  5. Quick start
  6. MCP server for AI assistants
  7. Response format and citation
  8. Endpoints
  9. FAQ
  10. Glossary
  11. OpenAPI specification and TypeScript types
  12. Rate limits
  13. Usage policy and disclaimer

finwire API - free Polish financial data API (NBP, GUS, RCN)

finwire API is a free, open REST API with financial, labour market and real estate data for Poland: NBP policy rates, CPI inflation, NBP exchange rates, 10-year government bond yields, flat transaction prices from notarial deeds, rents, housing supply, wages by occupation, unemployment by province and county, and an economic calendar. No API key, JSON over HTTPS, OpenAPI 3 specification, every response with its primary source and a ready-to-paste citation. Built and maintained by finwire.pl.

curl "https://public-api.finwire.pl/v1/series/interest-rate/stopa-referencyjna?days=90"
  • Base URL: https://public-api.finwire.pl
  • Auth: none - no key, no sign-up, GET only, CORS enabled (works from the browser)
  • Format: JSON, UTF-8, { data, meta } envelope
  • Specification: openapi.json · interactive reference · llms.txt · dataset pages
  • Data license: CC BY 4.0 for finwire indicators and aggregates; public data requires attribution to the original source; the license of each dataset is in its license field
  • WIBOR and POLSTR: not available. They are GPW Benchmark data; redistribution requires a Market Data License Agreement with GPW (gpwbenchmark.pl)
  • Changes: CHANGELOG.md

Po polsku: darmowe API z polskimi danymi finansowymi - stopy NBP, inflacja CPI (GUS), kursy walut NBP, rentowności obligacji, ceny transakcyjne mieszkań z Rejestru Cen Nieruchomości, czynsze i rentowność najmu, podaż mieszkań, wynagrodzenia GUS (także według zawodów), bezrobocie w województwach i powiatach, próg wejścia (ile trzeba zarabiać na kredyt na mieszkanie), limity podatku od nieruchomości, kalendarz odczytów makro. Bez klucza i rejestracji. Opis po polsku: finwire.pl/otwarte-api.


Contents


Data coverage

Every dataset comes from its primary source and is served in one format, with that source in meta.

Each dataset name links to its documentation page with fields, source and citation.

DataEndpointPrimary sourceFrequencyHistory
NBP policy rates (reference, lombard, deposit, rediscount, discount)/v1/series/interest-rate/{id}NBPon MPC decisionsup to 10 years
CPI inflation (YoY, MoM)/v1/series/cpiGUSmonthlysince 1982
NBP exchange rates (table A mid, table C bid/ask)/v1/series/fx/{code}NBPdaily (business days)up to 10 years
10-year government bond yields: PL, DE, euro area, EU + spreads/v1/series/bond-yields/{geo}Eurostat irt_lt_mcby_mmonthlysince 2001
Retail government bonds (OTS, ROR, DOR, TOS, COI, EDO, ROS, ROD)/v1/bondsMinistry of Financemonthly issuescurrent issues
Flat transaction prices per m² (median, quartiles, primary/secondary) - 17 cities and their districts/v1/housing/transactions/{city}Real Estate Price Register (RCN, GUGiK + city registers)quarterly, ingested dailylast 12 quarters per city
Housing prices per m² in 17 cities/v1/series/housing/{city}GUSquarterlylatest quarters
Housing supply: dwellings per 1000, completions, permits, migration/v1/housing/supply/{city}GUS BDL, Census 2021yearlysince 2010
Asking rents per city and district/v1/rent/{city}znajdznajem.pldaily snapshotcurrent + previous month
Rental yield (gross, net, payback)/v1/rent/yieldfinwire.pl (rents + RCN prices)dailycurrent
Wages: median, percentiles, 16 provinces/v1/wagesGUSon GUS releasecurrent
Wages by occupation: mean, median, deciles, gender gap - about 175 groups/v1/wages/occupations/{code}GUSevery 2 yearssurvey editions
Registered unemployment: Poland, 16 provinces, highest/lowest counties/v1/series/unemploymentGUS BDLmonthlysince 2011
Macroeconomic indicators: GDP, retail sales, output, CPI, unemployment, wages, FX, credit, limits/v1/macro/indicatorsGUS, NBP, Eurostat, Ministry of Financeon releasefull history per indicator
Consumer sentiment: BWUK, WWUK and 13 components/v1/macro/consumer-sentimentGUSmonthlysince 2010
Average wage, enterprise sector by province/v1/wages/enterpriseGUSmonthly2 years
Gold price (1 g, fineness 1000)/v1/series/goldNBPdaily (business days)since 2013
Maximum fuel prices: Pb95, Pb98, diesel/v1/fuel-pricesMinister of Energy (Monitor Polski)on announcementall announcements
Retail prices in shops: 30 goods and services, finwire shopping basket, minutes of work/v1/prices/retailGUS (Dziedzinowa Baza Wiedzy)monthlyfrom 2018
Business registrations: new, closed, suspended and resumed sole proprietorships in CEIDG, share of women, finwire_new_business_ratio/v1/business-registrationsMRiT (dane.gov.pl)monthlyfrom November 2019
Vehicle registrations: first registrations by vehicle type and province, passenger-car brands, share of brands from China, finwire_car_registrations_pulse, finwire_chinese_brands_share/v1/vehicle-registrationsMinistry of Digital Affairs (CEPiK data, dane.gov.pl)monthlyfrom January 2014, brands from January 2023
Electric cars: BEV and PHEV fleet and new cars, fuel mix of new cars, counties and provinces, charging vs EV correlation, finwire_ev_share_new_cars/v1/electric-vehiclesEurostat, GUS BDL, UDT EIPAyearlyEurostat from 2013
EV charging points: locations, stations and points, fast sites by province and county, finwire_ev_charging_coverage/v1/ev-chargingUDT EIPAmonthly (month ends), daily current statefrom December 2019
IKE and IKZE retirement accounts: accounts, assets and contributions by institution type, limit usage, finwire_ike_ikze_avg_balance/v1/ike-ikzeKNFhalf-yearlyfrom June 2020
Car insurance: average OC and autocasco premium: average premium per policy over 4 quarters and in the quarter, policies in force, claims paid per 100 PLN of premium, 18 non-life classes, finwire_oc_avg_premium/v1/car-insuranceKNFquarterlyfrom Q1 2017
Investment funds: assets and net flows of the market, fund groups, PPK, bond types, equity regions, finwire_fund_flows_index/v1/investment-fundsIZFiAmonthlymarket from February 2020, groups from February 2022
Czyste Powietrze subsidy programme: applications, contracts, payouts, payout queue, heat sources, finwire_clean_air_payout_rate/v1/subsidies/clean-airNFOŚiGWweeklyfrom February 2024 (archived readings)
Average ZUS pension: gross and net, other pensions, allowances, finwire_pension_wage_ratio/v1/pensionsZUS, GUSmonthly (preliminary data)from December 2023
Average Pole (finwire_average_pole): median age, median wage, flat price, average mortgage and model payment, pension, spending, car age, top car brand/v1/average-poleEurostat, GUS, BIK, NBP, ZUS, Ministry of Digital Affairseach trait on its source's release (annual to monthly)latest readings
Daily price index (finwire_daily_price_index, experimental): online shelf prices of a fixed basket of food, household and personal care products, base month = 100, categories, m/m, food part vs GUS CPI food/v1/daily-price-indexfinwire.pl from Frisco.pl, Rossmann.pl, zakupy.biedronka.pl; GUS CPI weights
Pension forecast (finwire_pension_forecast): first ZUS pension as % of the last wage and in today's money by birth year, sex and retirement age and wage level, P10/P50/P90, effect of demography and longer life, OECD and EC benchmarks/v1/pension-forecastZUS, Eurostat, GUS, Ministry of Financerecomputed when ZUS indexation, Eurostat or GUS inputs changebirth years 1966-2006, retirement years to 2075
PPK (Employee Capital Plans): net assets, active accounts, participants, participation rate, average fee, finwire_ppk_avg_account/v1/ppkPFR Portal PPK (monthly bulletin)monthlyfrom October 2021
Retail savings bonds vs bank deposits: first-year bond rates minus best deposits, savings accounts and average new deposit after tax, finwire_retail_bond_premium/v1/retail-bond-premiumMinistry of Finance, NBP, finwire.pl deposit indicesmonthlyfrom the first month with both bond issue and deposit data
Household fixed cost burden: mortgage, admin fee, utilities and TV licence as % of net income, Poland and 16 provinces, finwire_fixed_cost_burden/v1/fixed-cost-burdenGUS, NBP, KRRiTmonthlylast 36 months with complete inputs
Heating season: degree days since 1 July vs the 20-season norm, cold index, season cost of a 100 m2 house, Poland and 17 cities, finwire_heating_season_index, finwire_heating_season_cost/v1/heating-seasonIMGW-PIB, Eurostat, URE, GUSdailyseasons since 1966/67
Polish public debt and state budget: State Treasury debt, debt per resident finwire_public_debt_per_capita, public debt % of GDP, budget deficit/v1/public-debtMinistry of Finance, GUS, Eurostatmonthly (debt), quarterly (% of GDP), monthly (budget estimate)debt from January 2001, budget from 2018
PIT returns by municipality: PIT due per resident finwire_pit_per_capita, by type of return (PIT-37, PIT-36L, PIT-28, PIT-38), every municipality and province/v1/pit/summary, /v1/pit/municipalities, /v1/pit/municipalities/{teryt}Ministry of Finance, GUSyearlytax years from 2022
Regulated electricity and gas prices: household tariffs G11, G12, G12w and W-1.1 to W-4/v1/energy/regulated-pricesPresident of URE (tariff decisions)on new decisiontariff years in force
Brokerage account fees: commissions on GPW, US and German stocks, account and FX fees/v1/brokersbrokers' official fee tables, compiled by finwire.plweekly checkcurrent fee tables
Legal changes radar: acts entering into force, bills in the Sejm/v1/legal-changesSejm ELI APIdailyupcoming and recent
Residents income by municipality and county/v1/income/municipalitiesMinistry of Finance (Rb-27S), GUS BDL, computed by finwire.plyearly, quarterly updatebudget years
Coal price and waste fee by province (finwire_coal_price_pl, finwire_waste_fee_pl)/v1/coal-waste-pricesGUS BDLyearly2020 onwards
Housing running costs in 20 cities/v1/housing/upkeep/{city}GUS BDLyearlylatest year
House prices and housing conditions in Europe/v1/housing/europeEurostatquarterly, yearlysince 2010 (conditions)
Bank lending survey/v1/credit-market/surveyNBPquarterlyeditions
Household loans and deposits/v1/credit-market/monetaryNBPmonthlyup to 400 months
Housing loan demand (BIK)/v1/credit-market/demandBIK, NBPmonthlyfrom 2025-08
Mortgage payment risk and fixed-rate premium: chance the variable-rate payment rises by more than 5% in 12 months, payment percentiles in 3, 6 and 12 months, backtest accuracy, finwire_rate_risk_gauge, finwire_fixed_rate_premium/v1/credit-market/rate-riskfinwire.pl model on GPW Benchmark WIBOR (result only), bank offers, ECB MIRdailymonth ends from 2008
Interest rates on new loans in Europe/v1/credit-market/ecb-ratesECB MIRmonthlysince 2014
Electricity and gas prices for households in the EU: EUR, PPS, PLN, finwire_eu_power_price_gap, kWh per minimum wage/v1/europe/energy-pricesEurostat (nrg_pc_204, nrg_pc_202)half-yearlysince 2007
Fuel prices in EU countries: petrol 95, diesel, LPG, heating oil in EUR and PLN per litre, taxes, rank, finwire_eu_fuel_price_gap/v1/europe/fuel-pricesEuropean Commission (Weekly Oil Bulletin), NBPweeklysince 2005
GDP per capita in the EU: PPS (EU27 = 100) and EUR per inhabitant, real growth, AIC consumption, price level, latest quarter GDP growth, finwire_eu_convergence_years/v1/europe/gdp-per-capitaEurostat (nama_10_pc, prc_ppp_ind_1, namq_10_gdp)yearly and quarterlysince 1995
Minimum wages in the EU: EUR, PPS, national currency/v1/europe/minimum-wagesEurostat (earn_mw_cur)half-yearlysince 1999
Inflation (HICP) in EU countries: ranking, Poland, core, food, energy, services, basket since a year, finwire_eu_inflation_gap/v1/europe/inflationEurostat
Unemployment in EU countries: total and under 25, rank, Poland rank over time, finwire_eu_youth_unemployment_ratio/v1/europe/unemploymentEurostat (une_rt_m)monthlysince 2010
Net earnings in the EU by household type: EUR, PPS, gross, tax, contributions, labour cost per hour, tax wedge, finwire_eu_net_wage_gap, own salary vs every EU country/v1/europe/net-earningsEurostat (earn_nt_net, lc_lci_lev, earn_nt_taxwedge)yearlysince 2010
Government debt and deficit in the EU: % of GDP, ranks, 3% and 60% reference values, finwire_eu_debt_threshold_gap/v1/europe/public-debtEurostat (gov_10dd_edpt1, gov_10q_ggdebt)yearly, quarterlysince 2000 (yearly), 2010 (quarterly)
Living conditions in the EU (EU-SILC): own home with and without a mortgage, renting, people who cannot face an unexpected expense, median and mean household income per person in EUR and PPS, finwire_eu_mortgaged_owners, finwire_eu_household_income_gap/v1/europe/living-conditionsEurostat (ilc_lvho02, ilc_mdes04, ilc_di03)yearlysince 2005
Economic calendar: MPC (RPP) decisions, CPI, wages, GDP, unemployment/v1/calendarGUS, NBP, compiled by finwire.plcontinuousupcoming events
IKE / IKZE contribution limits/v1/legal-limitsMinistry of Family announcementsyearlycurrent year
Property tax upper limits/v1/legal-limits/local-taxMinister of Finance (Monitor Polski)yearlyannounced tax years
Deposit, savings, mortgage and cash loan rate aggregates/v1/market/*finwire.pl (aggregate of offers on the market)dailycurrent
finwire index registry: every index computed by finwire.pl under a stable finwire_* id (list)/v1/finwire-index/{id}finwire.pl (method and sources per index)daily, monthly or quarterly per indexper index
Legal calendar (finwire_legal_calendar): PIT, ZUS and VAT deadlines, IKE/IKZE year end, changes of statutory values, acts entering into force, RPP meetings, retail bond sales/v1/legal-calendarSejm ELI API, NBP, Ministry of Finance, statutory deadlines, compiled by finwire.pldailyupcoming events, ICS at finwire.pl/kalendarz-zmian.ics
KNF public warnings: entries verbatim from KNF, counts by legal basis, entity lookup, weekly new entries (finwire_knf_warnings_monitor)/v1/knf-warningsKNF, lista ostrzeżeń publicznych3 times a daycurrent list, weekly series since November 2026
BFG deposit guarantee list: banks and credit unions covered by the BFG guarantee, counts by group with history (finwire_bfg_guarantee_monitor), latest changes, lookup by name or website/v1/bfg-guaranteeBFG, lista podmiotów objętych gwarancjamitwice a dayevery change of the list since 2019
Court rulings in credit disputes: rulings of common courts on CHF and other currency mortgages, WIBOR, free credit sanction, early repayment refunds and unit-linked policies, monthly counts, share for the borrower (finwire_borrower_win_share), instances, newest rulings with links/v1/credit-judgmentsCourt Rulings Portal, Ministry of Justice via SAOSdailyall published rulings, history filled over the first weeks
Tax rulings: KIS and municipal individual rulings by personal finance topic, weekly counts (finwire_tax_rulings_pulse), most cited provisions, newest rulings with links/v1/tax-rulingsMinistry of Finance, EUREKAdailylast 53 weeks, growing
Next-year statutory limits (finwire_next_year_limits): pension indexation, minimum wage, IKE/IKZE limits, ZUS caps and bases, flat-rate tax and small CIT taxpayer limits for the next year from the formulas in law, with stage, 80% interval and backtest/v1/legal-limits/next-yearfinwire.pl calculation from GUS and NBP data and acts in the Journal of Laws and Monitor Polskiseveral times a daynext year, estimate path since June, backtest on past years
Entry threshold: wage needed for a mortgage on a model flat, 17 cities/v1/index/entry-thresholdfinwire.pl (prices from notarial deeds in RCN, GUS RCiWN fallback, mortgage offers, GUS wage distribution)dailysince September 2026
Finwire Nowcast: forecasts of CPI and core inflation and the RPP decision/v1/macro/nowcastfinwire.pl model (inputs: GUS, NBP, EC Oil Bulletin)daily, frozen 3 working days before publicationbacktest since 2019 (CPI, core), 2012 (RPP)
finwire lead forecasts: core inflation in 6-12 months and impaired loans in 2-4 quarters/v1/macro/lead-forecastsfinwire.pl models (inputs: GUS, NBP, Eurostat, KNF)daily model run, monthly datarolling backtest, published only above 70% interval coverage
finwire indicators: credit stress map, barometers/v1/index/*finwire.pl (computed from the above)daily (credit stress), monthly (barometers)barometers since 2015
Consumer bankruptcies: people declared bankrupt as consumers per month, year on year, since January, rank in the series, yearly totals, finwire_consumer_bankruptcies/v1/consumer-bankruptciesCOIG (from announcements in KRZ and MSiG; reuse with attribution to COIG, not CC BY)monthlyfrom January 2015
PIT settlement in Poland: scale taxpayers and returns by form, taxpayers in each bracket and their share in tax due, reliefs (IKZE, child relief, thermal modernisation and more), overpayments, flat tax, lump-sum tax, finwire_pit_top_bracket_multiplier/v1/pit/nationalMinistry of Finance (yearly information; the same series on dane.gov.pl is CC0 1.0)yearlytax years from 2019
Family housing loan price limits: maximum price per m2 for a mortgage without down payment with a BGK guarantee, 52 locations, primary and secondary market, finwire_rkm_offer_fit/v1/rkm-price-limitsBGK (from voivode announcements; no reuse terms stated by BGK, cite with attribution, not CC BY)quarterlyfrom Q1 2023
Child benefits paid by ZUS: 800 plus and the three Aktywny Rodzic benefits per month, amounts since January and in the month, 800 plus applications, voivodeships, finwire_child_benefits_payout/v1/family-benefitsZUS Portal Statystyczny (CC0 1.0 on dane.gov.pl)monthlyfrom January 2024 (Aktywny Rodzic from December 2024)
Savings bond sales: retail savings bonds sold per month, series, exchange, IKE/IKZE, channels, buyer age, since January vs every year, finwire_savings_bond_sales/v1/savings-bond-salesMinistry of Finance (gov.pl, reuse with attribution)monthlyfrom January 2015

Aggregates never expose single offers, deeds or listings - only medians, percentiles and counts.


Use cases

  • Mortgage and savings calculators - NBP reference rate and market median mortgage rates in one call (/v1/snapshot).
  • Newsroom and research charts - CPI since 1982, unemployment since 2011, bond yields since 2001, with a ready citation in meta.
  • Real estate analysis - transaction prices per district, rents, rental yield and housing supply for 17 cities.
  • Labour market and HR - wages by occupation with deciles and the gender pay gap, unemployment by county.
  • Personal finance apps - IKE/IKZE limits, retail bond rates, deposit and savings rate medians.
  • AI assistants and agents - an MCP server (Streamable HTTP, no key) serves rates, FX, housing prices, rents, the credit market, legal limits, law changes and macro data to Claude, ChatGPT, Cursor, VS Code and other MCP clients; llms.txt and the OpenAPI spec describe every dataset in machine-readable form.

Quick start

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 (browser or 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"])

MCP server for AI assistants

https://public-api.finwire.pl/mcp - Model Context Protocol over Streamable HTTP, stateless, no key, read-only. The same data, whitelist and licenses as /v1. What it answers, with a coverage table and example questions: finwire.pl/en/mcp (Polish: finwire.pl/mcp).

ClientHow to connect
Claude (claude.ai, Desktop)Settings - Connectors - Add custom connector - URL https://public-api.finwire.pl/mcp
Claude Codeclaude mcp add --transport http finwire https://public-api.finwire.pl/mcp
ChatGPTConnectors in developer mode - create a connector with the URL above, no authentication
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"}}}

Tools (all read-only, each with outputSchema):

  • Macro: get_macro_snapshot, list_macro_indicators, get_macro_indicator, compare_macro_indicators, get_macro_changes, get_macro_calendar
  • Rates and prices: get_interest_rates (NBP), get_currency_rates (NBP FX, gold), get_fuel_prices, get_energy_prices (URE electricity and gas tariffs), get_retail_prices (GUS shop prices, finwire shopping basket)
  • Subsidies: get_subsidy_stats (Czyste Powietrze heating subsidy programme: applications, contracts, payouts, payout queue, finwire_clean_air_payout_rate)
  • Pensions: get_pension_stats (average ZUS pension gross and net, other pensions, allowances, finwire_pension_wage_ratio)
  • Typical person: get_average_pole (Average Pole finwire_average_pole: median age, wage, flat, mortgage and model payment, pension, spending, car age, top brand; each trait with measure and period)
  • Online prices: get_daily_price_index (experimental Daily price index finwire_daily_price_index: online shelf prices of a fixed basket, base month = 100, categories, largest rise and fall, food part vs GUS CPI food; no single product prices)
  • Pension forecast: get_pension_forecast (model of the future ZUS pension finwire_pension_forecast: replacement rate and pension in today's money by birth year 1966-2006, profile k60/k65/m65 and wage level, P10/P50/P90, effect of the shrinking workforce and longer life, OECD and EC benchmarks)
  • Businesses: get_business_registrations (applications in CEIDG to register, close, suspend and resume a sole proprietorship, finwire_new_business_ratio)
  • Cars: get_vehicle_registrations (first registrations by type, province and passenger-car brand, share of brands from China, finwire_car_registrations_pulse, finwire_chinese_brands_share), get_electric_vehicles (BEV and PHEV fleet and new cars, counties, charging vs EV correlation, finwire_ev_share_new_cars), get_ev_charging (EIPA charging points, fast sites, finwire_ev_charging_coverage, AFIR power classes with median prices), find_ev_chargers (chargers near a city or point: power, free now, price per kWh, one site card), growth of charging infrastructure in get_ev_charging (finwire_ev_infrastructure_growth), get_ev_charging_prices (price per kWh by power class and network, price changes, finwire_ev_charging_price_index)
  • PPK: get_ppk_stats (Employee Capital Plans from the PFR Portal PPK bulletin: net assets, active accounts, participants, participation rate, average fee, finwire_ppk_avg_account)
  • Retail bonds vs deposits: get_retail_bond_premium (first-year premium of each retail savings bond series over the best deposits, savings accounts and the average new deposit after tax, retail bond sales, finwire_retail_bond_premium)
  • Household budget: get_fixed_cost_burden (share of net income taken by mortgage, admin fee, utilities and TV licence, Poland and 16 provinces, finwire_fixed_cost_burden)
  • Heating season: get_heating_season (degree days vs norm, cold index, season forecast and heating cost of a 100 m2 house, Poland and 17 cities, finwire_heating_season_index, finwire_heating_season_cost)
  • Investment funds: get_investment_funds (IZFiA assets, inflows, outflows and net flows by fund group, PPK, finwire_fund_flows_index)
  • IKE and IKZE: get_ike_ikze_stats (KNF half-yearly accounts, assets and contributions by institution type, limit usage, finwire_ike_ikze_avg_balance)
  • Net earnings in the EU: get_eu_earnings (Eurostat net pay by household type in EUR and PPS, labour cost per hour, tax wedge, a net salary in PLN compared with every EU country, finwire_eu_net_wage_gap)
  • Car insurance: get_car_insurance_market (KNF quarterly average OC and autocasco premium per policy, policies in force, claims paid per 100 PLN of premium, 18 non-life classes, finwire_oc_avg_premium)
  • Fuel prices in the EU: get_eu_fuel_prices (European Commission Weekly Oil Bulletin: petrol 95, diesel, LPG and heating oil in PLN and EUR per litre in 27 EU countries, rank, taxes, full-tank difference against Poland, finwire_eu_fuel_price_gap)
  • Inflation in the EU: get_eu_inflation (Eurostat HICP in 27 EU countries: ranking, place of Poland, components, price growth since a year, finwire_eu_inflation_gap).
  • Unemployment in the EU: get_eu_unemployment (Eurostat monthly unemployment rate, total and under 25, rank of Poland since 2010, finwire_eu_youth_unemployment_ratio)
  • Living conditions in the EU: get_eu_living_conditions (Eurostat EU-SILC: own home with and without a mortgage, renting, people who cannot face an unexpected expense, median household income per person in 27 EU countries, finwire_eu_mortgaged_owners, finwire_eu_household_income_gap)
  • Public debt: get_public_debt (State Treasury debt, debt per resident finwire_public_debt_per_capita, public debt % of GDP, state budget deficit)
  • finwire indices: list_finwire_indices (all finwire_* ids with the latest reading), get_finwire_index (one index by id or alias, with history and citation)
  • Forecasts: get_nowcast (Finwire Nowcast: CPI and core inflation, RPP decision probabilities, accuracy)
  • Lead forecasts: get_lead_forecasts (core inflation in 6-12 months finwire_cost_pressure, impaired housing and consumer loans in 2-4 quarters finwire_npl_forecast; shown only above the accuracy threshold)
  • Housing: get_housing_prices (notarial deeds, cities and districts), get_rents (rents, rental yield), get_housing_costs, get_coal_waste_prices (annual coal price and waste fee, Poland and 16 provinces), get_housing_balance (finwire_housing_pressure new residents per new dwelling, finwire_housing_pipeline completions forecast from building permits, finwire_rent_forecast 6-month rent forecast)
  • Credit, savings and investing: get_credit_market, get_rate_risk (mortgage payment risk in 3, 6 and 12 months with backtest, finwire_rate_risk_gauge; fixed-rate premium finwire_fixed_rate_premium), get_bank_rates (aggregates only, no single offers; retail bonds), get_broker_fees (brokerage fee tables)
  • Law: get_legal_limits (IKE/IKZE, PIT, minimum wage, local tax limits), get_next_year_limits (next-year statutory values from legal formulas before the act, finwire_next_year_limits), get_legal_changes (acts, bills in the Sejm and the next 30 days of finwire_legal_calendar), get_tax_rulings (tax rulings by personal finance topic), check_knf_warnings (a firm or website on the KNF public warnings list), check_bfg_guarantee (a bank or credit union on the BFG deposit guarantee list)
  • Business in Poland (also for founders from abroad): plan_business_entry (forms available to the owner with reasons, taxes and net per form with the treaty dividend rate, setup steps, residence, deadlines), get_business_forms, calc_net_income (employment, mandate, work contract, B2B), compare_business_forms (JDG vs sp. z o.o.), calc_employer_cost, calc_zus_contributions, get_tax_treaty (withholding tax, treaty rates), get_compliance_calendar, get_business_guide (verified facts with legal basis), get_business_glossary
  • Regions and Europe: get_regional_data (income and PIT per resident by municipality, unemployment, wages), get_europe_data (house prices, mortgage rates, bond yields, household electricity and gas prices, minimum wages in the EU), get_eu_gdp (GDP per capita in PPS and EUR, AIC, price levels, quarterly GDP growth of EU countries, finwire_eu_convergence_years)
  • Any dataset: search_datasets, get_dataset
  • Consumer bankruptcies: get_consumer_bankruptcies (people declared bankrupt as consumers per month from COIG, year on year, since January, rank in the series, yearly totals, finwire_consumer_bankruptcies)
  • PIT settlement: get_pit_settlement_stats (PIT settlement in Poland by tax year from the Ministry of Finance: taxpayers in each bracket and their share in tax, returns by form, reliefs, child relief, overpayments, flat and lump-sum tax, finwire_pit_top_bracket_multiplier)
  • Family housing loan: get_rkm_price_limits (BGK price limit per m2 for a mortgage without down payment in 52 locations, primary and secondary market, check of a price per m2, share of developer offers within the limit finwire_rkm_offer_fit)
  • Child benefits: get_family_benefits (800 plus and Aktywny Rodzic paid by ZUS per month, amounts, applications, voivodeships with the share of Aktywny Rodzic variants, municipalities with 800 plus per 1000 residents, finwire_child_benefits_payout)
  • Savings bond sales: get_savings_bond_sales (retail savings bonds sold per month from the Ministry of Finance: series, exchange of maturing bonds, IKE/IKZE, channels, buyer age, since January vs every year, finwire_savings_bond_sales)

Every result carries the period of the data, the original source, license, a ready citation and url - the finwire.pl page with the full table, chart and calculator (with utm_source=mcp). Resources: macro://catalog, finwire://datasets, finwire://dataset/{id}; prompts: macro_briefing, explain_indicator, city_housing_report, personal_finance_limits.

Discovery: server card (application/mcp-server-card+json), /.well-known/ard.json, registry manifest server.json.


Response format and citation

Every response uses the same envelope. Values below are illustrative - call the endpoint for current data.

{
  "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 - the date of the data at the source (not the time of your request).
  • meta.citation - a ready-to-use attribution string with a link. Use it as is.

How to cite: Source: finwire.pl (<primary source>), https://public-api.finwire.pl/datasets/<dataset-id>

CodeMeaning
200OK
404Unknown dataset, indicator, city or geo code
429Rate limit exceeded (see Retry-After)
503Primary source temporarily unavailable

Endpoints

Interest rates, inflation, FX, bond yields, unemployment
EndpointReturns
GET /v1/series/interest-rateCurrent table of NBP policy rates
GET /v1/series/interest-rate/{id}?days=365Daily history. id: stopa-referencyjna, stopa-lombardowa, stopa-depozytowa, stopa-redyskontowa, stopa-dyskontowa. days: 7-3650
GET /v1/series/cpi?type=monthly&limit=24CPI YoY and MoM. type: monthly or yearly, limit: 1-600
GET /v1/series/fxCurrent NBP FX table
GET /v1/series/fx/{code}?days=365FX history, e.g. EUR, USD, CHF, GBP
GET /v1/series/bond-yieldsLatest 10-year yields for PL, DE, EA, EU27_2020, PL-DE and PL-EA spreads in bps
GET /v1/series/bond-yields/{geo}?since=2015-01Monthly history for one geo
GET /v1/series/unemploymentRegistered unemployment rate: Poland and 16 provinces, latest month, YoY change in pp
GET /v1/series/unemployment/counties?limit=10Counties (powiaty) with the lowest and highest rate, limit 1-50
GET /v1/series/unemployment/history?unit={unitId}Monthly history since 2011 for Poland (default) or a province (unitId from regions[])
Real estate
EndpointReturns
GET /v1/housing/transactions17 cities: median, p25, p75 price per m² from notarial deeds, primary vs secondary market, transaction count, YoY, quarterly trend
GET /v1/housing/transactions/{city}Districts of a city: 12-month median price per m², transaction count, YoY, difference vs city median
GET /v1/housing/location-premium/{city}Districts of a city: actual vs expected price per m² from neighbourhood quality, premium %, model fit (finwire_location_premium)
GET /v1/local-tax-squeezeProperty tax as % of property tax + PIT share in municipal budgets: Poland, provinces, cities, municipalities in the squeeze (finwire_local_tax_squeeze); /municipalities for every municipality
GET /v1/jst-budget/municipalitiesMunicipal budgets: spending, debt and EU funding per resident of every municipality (finwire_gmina_spending_per_capita); /municipalities/{teryt} for one municipality by category vs neighbours, similar municipalities and Poland; /ranking by metric
GET /v1/series/housing and /{city}GUS housing prices per m² for 17 cities, latest quarters, nominal and real YoY
GET /v1/rent and /{city}Asking rents: median, mean, per m², month-over-month change, districts
GET /v1/rent/yieldGross and net rental yield and payback period per city
GET /v1/housing/carryHousing carry per city: net rental yield minus mortgage rate, monthly (finwire_housing_carry)
GET /v1/housing/supplyDwellings per 1000 residents, stock, completions, permits, floor area per person, population and migration: Poland, 16 provinces, 17 cities, yearly since 2010, Census 2021, GUS population forecast
GET /v1/housing/supply/{city}One city vs its province and Poland, rank among 17 cities, yearly history

provisionalQuarters in transaction data lists quarters the registry is still filling in - treat them as preliminary.

EndpointReturns
GET /v1/bondsRetail government bond rates by issue
GET /v1/wagesGUS wage median, percentiles and provincial averages
GET /v1/wages/occupationsGross wages for about 175 occupation groups: mean, median, deciles D1-D9, men vs women, public vs private, gender pay gap
GET /v1/wages/occupations/{code}One occupation group with its parent groups and survey edition history
GET /v1/legal-limitsIKE / IKZE annual contribution limits and related values
GET /v1/legal-limits/local-taxUpper limits of property tax rates (land, buildings, structures) per tax year, with the act and legal basis
GET /v1/legal-limits/next-year?path=falseNext-year statutory values from the formulas in law (finwire_next_year_limits): value, 80% interval, stage (projekcja, projekt, obwieszczenie, obowiazuje), calculation, inputs, estimate path and backtest
GET /v1/macro/indicatorsHeadline indicators with the latest reading, change, sparkline and source
GET /v1/macro/indicators/{key}/history?from=2020-01Full history of one indicator
GET /v1/macro/consumer-sentimentGUS BWUK, WWUK and components with the history
GET /v1/wages/enterpriseGUS average wage in the enterprise sector, real change, by province
GET /v1/series/goldNBP gold price: latest, period changes, all-time high, 12-month average
GET /v1/series/gold/history?range=1yGold price history, range: 1m, 1y, 5y, max
GET /v1/fuel-pricesMaximum fuel prices: in force today, announced for tomorrow, history
GET /v1/prices/retailAverage retail prices of 30 goods and services (GUS), changes, minutes of work, finwire shopping basket; ?product= for one price history
GET /v1/subsidies/clean-airCzyste Powietrze programme (NFOŚiGW): applications, contracts and payouts cumulative, Modernisation Fund edition, last week, payout queue and pace, heat sources, reading history
GET /v1/pensionsAverage ZUS pension gross and net, other pensions, allowances, pension to wage ratio, monthly history
GET /v1/average-poleAverage Pole (finwire_average_pole): traits of the typical person in Poland with measure (median, mean, model, distribution, mode), period and source
GET /v1/daily-price-indexDaily price index finwire (finwire_daily_price_index, experimental): daily series, monthly readings with m/m, basket categories, food part vs GUS CPI food, collection state and basket list without prices
GET /v1/pension-forecastPension forecast finwire (finwire_pension_forecast): headline (man, average wage, retiring 30 years after the base year), grid birth year x profile x wage level with replacement rates and pension in today's money (P10/P50/P90), fan by retirement year, decomposition, working-age population, OECD and EC benchmarks, parameters
GET /v1/business-registrations?months=24Applications filed in CEIDG (MRiT): registrations, closures, suspensions and resumptions of sole proprietorships, net, same month in earlier years, share of women, finwire_new_business_ratio, monthly history
GET /v1/vehicle-registrations?months=24&province=14First registrations in Poland (Ministry of Digital Affairs, CEPiK data): passenger cars and all vehicles, 17 types, provinces per 1000 residents, held-back months, brands of the month and 12 months, share of brands from China, finwire_car_registrations_pulse, finwire_chinese_brands_share
GET /v1/electric-vehicles?counties=allBEV and PHEV passenger cars: fleet and new cars by year (Eurostat), fuel mix of new cars, provinces and counties per 1000 cars (GUS BDL), top and bottom counties, correlation of charging sites and EVs with a version controlling wages, finwire_ev_share_new_cars
GET /v1/ev-charging/chargers?city=Łódź&minKw=150EV charging sites (UDT EIPA, end-user data account) by city or point and radius: power class, kW, points free now, lowest ad hoc price per kWh; /v1/ev-charging/chargers/{id} = one site with points, connectors, prices and status
GET /v1/ev-charging/pricesAd hoc charging prices per kWh by AFIR power class, AC vs DC, networks, cities, recent changes, finwire_ev_charging_price_index
GET /v1/ev-charging/networksCharging networks: stations, points, median prices, reliability, ranking with weights; /v1/ev-charging/networks/{slug} = one network price list, finwire_ev_charger_reliability
GET /v1/ev-charging/occupancyCharger occupancy now, weekly trend and by weekday x hour, busiest sites, cities and networks, finwire_ev_charger_occupancy (full weeks, after 14 days of readings)
GET /v1/ev-charging/growth?network=greenwayGrowth of charging infrastructure: EIPA month ends since December 2019 with monthly change, year on year and records, CNG/LNG; daily sites and points by power class, province and network (or one network / city), finwire_ev_infrastructure_growth
GET /v1/ev-charging/coverage?counties=allDistance from each county to the nearest charging site from 150 kW, finwire_ev_fast_coverage
GET /v1/ev-charging/gasCNG, LNG and hydrogen stations with prices per m3 or kg
GET /v1/ev-charging?months=24Public EV charging (UDT EIPA): points, stations and locations today and at month ends since December 2019, sites and fast sites by province and county, finwire_ev_charging_coverage
GET /v1/ppk?months=12PPK (Employee Capital Plans) from the monthly PFR Portal PPK bulletin: net assets, active accounts, participants, employers, participation rate, average fee, finwire_ppk_avg_account, monthly history
GET /v1/retail-bond-premium?months=12Premia obligacji skarbowych finwire: retail savings bonds vs the finwire deposit and savings indices and the NBP average new deposit, after tax, per series, retail bond debt change, sales response test
GET /v1/fixed-cost-burden?region=mazowieckieSztywne koszty gospodarstwa finwire: share of household net income taken by fixed costs, Poland and 16 provinces, components in PLN, monthly history
GET /v1/ike-ikzeIKE and IKZE (KNF, half-yearly): accounts, assets, contributions, withdrawals and returns by institution type, holders by sex and age, average contribution vs annual limit, finwire_ike_ikze_avg_balance, history in PLN
GET /v1/car-insuranceCar insurance (KNF quarterly bulletin, part D): average OC (class 10) and autocasco (class 3) premium per policy over 4 quarters and in the quarter, policies written and in force, claims paid per 100 PLN of premium, 18 non-life classes, finwire_oc_avg_premium, quarterly history since 2017
GET /v1/investment-funds?months=24Investment funds (IZFiA): assets, purchases, redemptions and net flows of the market and fund groups, bond types, equity regions, finwire_fund_flows_index, monthly history in PLN million
GET /v1/public-debtState Treasury debt monthly since 2001, debt per resident, growth per second, structure, public debt % of GDP, budget deficit with plan
GET /v1/energy/regulated-prices?date=2026-10-29Household electricity and gas tariffs approved by URE in force on a day (default today): energy and distribution rates, fees, cheaper-zone hours, decision and PDF per row; net amounts
GET /v1/brokersBroker fee tables: commissions by market, account and FX fees, IKE/IKZE, active promotions, fee table URL and weekly check status
GET /v1/legal-changes?days=90Acts entering into force soon and recently, open bills in the Sejm
GET /v1/legal-changes/process/{term}/{number}One bill: last stage, passage, published act
GET /v1/legal-calendar?kategorie=przepisy,wartosci&od=2026-11-01&do=2027-03-31Legal calendar finwire_legal_calendar: dated events with category, legal basis, source and finwire.pl page, the number of changes in acts and values in the next 30 days. kategorie: przepisy, wartosci, podatki, firma, oszczednosci, obligacje, stopy
GET /v1/knf-warningsKNF public warnings list: entries by legal basis, prosecutors, new entries per full week (finwire_knf_warnings_monitor), newest entries verbatim from KNF
GET /v1/bfg-guaranteeBFG deposit guarantee list: counts of banks and credit unions with history (finwire_bfg_guarantee_monitor), latest changes, EUR limit and its PLN equivalent; /search?q= looks up an entity
GET /v1/credit-judgments?category=wiborCourt rulings in WIBOR disputes: monthly counts, share ruled for the borrower at least in part (finwire_borrower_win_share), instance I vs II, newest rulings with case number, court, outcome and Court Rulings Portal link
GET /v1/tax-rulings?topic=najem_prywatnyTax rulings on a personal finance topic: weekly counts (finwire_tax_rulings_pulse), most cited provisions, newest rulings with signature, authority, shortened thesis and EUREKA link
GET /v1/knf-warnings/search?q=tradereu.comLook up a firm by name, website, KRS, NIP or REGON; onList: false does not mean the firm holds a KNF licence
GET /v1/income/municipalities?year=2025Residents income per capita by municipality: rank, ratio to the national average, change
GET /v1/income/counties?year=2025The same by county
GET /v1/housing/upkeep/{city}Monthly running costs of a flat in a city (list: /v1/housing/upkeep)
GET /v1/housing/europeEurostat house price index: Poland vs EU vs euro area and country ranking
GET /v1/housing/europe/overburden and /overcrowdingHousing cost overburden and overcrowding rates by country
GET /v1/europe/energy-prices?product=electricity&compare=DEHousehold electricity or gas prices per kWh in EU countries (Eurostat, half-yearly): ranking in EUR and PPS, Poland in PLN, EU average, history since 2007, finwire_eu_power_price_gap, kWh per monthly minimum wage
GET /v1/europe/fuel-prices?fuel=diesel&compare=HRFuel prices at filling stations in EU countries (European Commission Weekly Oil Bulletin, weekly since 2005): ranking in EUR and PLN per litre with and without taxes, EU and euro area averages, last year weekly, finwire_eu_fuel_price_gap
GET /v1/europe/gdp-per-capita?compare=DEGDP per capita in EU countries (Eurostat): ranking in PPS (EU27 = 100), EUR per inhabitant, real growth per capita, AIC consumption and price level, latest quarter of GDP growth, history since 1995, finwire_eu_convergence_years (years to the EU average at the 10-year pace)
GET /v1/europe/minimum-wages?compare=DEMonthly statutory minimum wages in EU countries (Eurostat, half-yearly): ranking in EUR and PPS, medians, history of Poland and a comparison country
GET /v1/europe/inflation?compare=DE&since=2015&country=HUHICP inflation in EU countries (Eurostat, monthly since 2000): ranking with 5 components, Poland, EU and euro area, history, price growth since a chosen year, finwire_eu_inflation_gap; with country its component history
GET /v1/europe/unemployment?compare=DEUnemployment rate in EU countries (Eurostat une_rt_m, monthly, seasonally adjusted, ILO definition): total and under 25, rank, Poland rank each month since 2010, history of Poland, EU, euro area and a comparison country, finwire_eu_youth_unemployment_ratio
GET /v1/europe/net-earnings?household=single&compare=DE&salary=7000Annual net earnings in EU countries by household type (Eurostat, yearly): ranking in EUR and PPS, gross, tax, contributions, labour cost per hour, tax wedge, finwire_eu_net_wage_gap; salary (monthly net PLN) compared with the average in every country
GET /v1/europe/public-debt?compare=DEGovernment debt, deficit and interest in EU countries (Eurostat), % of GDP: latest quarter and year with ranks, countries above the 3% and 60% reference values, history of Poland, the EU and a comparison country, finwire_eu_debt_threshold_gap
GET /v1/europe/living-conditions?compare=DELiving conditions in EU countries (Eurostat EU-SILC, yearly since 2005): share of people in their own home without and with a mortgage, in market and reduced rent, people who cannot face an unexpected expense, median and mean equivalised income in EUR and PPS, ranks, history of Poland, the EU and a comparison country, finwire_eu_mortgaged_owners, finwire_eu_household_income_gap
GET /v1/credit-market/survey?quarters=12NBP bank lending survey
GET /v1/credit-market/monetary?months=25NBP household loans, deposits and new loans
GET /v1/credit-market/demand?months=12BIK housing loan demand, requested vs granted amount, granted loans (BIK) and new housing loans (NBP)
GET /v1/credit-market/rate-risk?days=30Ryzyko raty finwire (chance the payment rises by more than 5% or 10% in 3, 6 and 12 months, payment percentiles, backtest since 2008) and Premia za stałą stopę finwire (5-year fixed minus expected variable cost, daily and monthly from ECB MIR, negative premium windows)
GET /v1/credit-market/ecb-rates?product=mortgage_total&period=2026-08ECB MIR rate on new loans by country
GET /v1/credit-market/ecb-rates/series?areas=PL,U2,DE&from=2018-01ECB MIR history for selected countries
GET /v1/calendar?limit=10Upcoming releases and decisions with date, Warsaw time, category, importance 1-10
GET /v1/market/deposit-rates?amount=10000&period=3Term deposit rates: median, percentiles, spread
GET /v1/market/savings-rates?amount=10000Savings account rates: median, percentiles
GET /v1/market/mortgage-rates?amount=400000&period=25Mortgage APRC (RRSO), margin, nominal rate: median, percentiles
GET /v1/market/cash-loan-rates?amount=20000&period=48Cash loan APRC and nominal rate: median, percentiles
GET /v1/consumer-bankruptcies?months=24Consumer bankruptcies (COIG, from court announcements in KRZ and MSiG): latest month with year-on-year change, sum since January vs the same period a year earlier, last 12 months, rank of the latest month in the series and among the same calendar month, yearly totals, finwire_consumer_bankruptcies, monthly history; data COIG, reuse with attribution
GET /v1/pit/national?years=3PIT settlement in Poland by tax year (Ministry of Finance yearly information): scale taxpayers, returns by form, brackets with the upper bracket share in tax due, reliefs deducted from income, child relief, overpayments, flat tax, PIT-38, PIT-39, lump-sum tax returns, finwire_pit_top_bracket_multiplier
GET /v1/rkm-price-limits?location=krakow&quarters=4Price limits per m2 in the family housing loan (BGK, from voivode announcements): 52 locations (voivodeship city, neighbouring municipalities, other municipalities), primary market (first buyer from the developer) and secondary market, change vs previous quarter and year, quarterly history, finwire_rkm_offer_fit; data BGK, cite with attribution
GET /v1/family-benefits?months=12&gmina=krakowChild benefits paid by ZUS: 800 plus and Aktywny Rodzic (working parents, nursery, at home) - benefits paid in the month, PLN in the month and since January, 800 plus applications and refusals, 16 voivodeships with the share of Aktywny Rodzic variants, municipalities with 800 plus per 1000 residents (gmina = name or TERYT), finwire_child_benefits_payout; ZUS data CC0 1.0
GET /v1/savings-bond-sales?months=24Retail savings bond sales (Ministry of Finance statistics): latest month with month-on-month and year-on-year change, series shares and amounts, exchange and new money, IKE/IKZE, channels, buyer age, sum since January with rank among years, yearly totals, finwire_savings_bond_sales, monthly history; gov.pl, reuse with attribution
finwire indicators
EndpointReturns
GET /v1/finwire-indexAll finwire indices: id finwire_*, name, group, status, latest and previous reading with periods, change and its kind (pp, pct, abs), method version, sources, stale, pageUrl, methodologyUrl, citation
GET /v1/finwire-index/{id}?limit=120&from=2024-01One index by finwire_* id or alias, with history (limit 1-600, default 120; from YYYY-MM); requestedId echoes the id used
GET /v1/macro/nowcastFinwire Nowcast: next CPI and core inflation reading (point, 80% interval) and RPP decision probabilities, freeze date and status, settled history vs actual readings, backtest and live accuracy
GET /v1/macro/lead-forecasts?index=nplfinwire lead forecasts: NBP core inflation in 6 and 12 months (finwire_cost_pressure) and share of impaired (Stage 3) housing and consumer loans in 2 and 4 quarters (finwire_npl_forecast), 80% intervals, rolling backtest; numbers withheld (published: false) below 70% interval coverage
GET /v1/index/entry-thresholdGross monthly wage per person needed for a mortgage on a model flat (parameters in params) within KNF DSTI limits in 17 cities, the installment, and the share of employees earning at least that
GET /v1/index/entry-threshold/history?household=singleDaily change points per city, household: single or couple
GET /v1/index/credit-stressMortgage installment for a 50 m² flat as % of the average net wage in 16 provinces, with KNF Recommendation S DSTI thresholds
GET /v1/indexAll barometers with value, position against history and monthly change
GET /v1/index/{slug}One barometer with monthly series, methodology and best/worst month since 2015. slug: real-deposit-rate, housing-affordability, credit-cost, borrowing-power, purchasing-power
GET /v1/snapshotRates, inflation, FX, credit stress and barometers in one call

Full field-level schemas: openapi.json.

finwire indices (finwire_* ids)

Every index computed by finwire.pl has one stable id, the same in this API, in MCP, in CSV files on finwire.pl (column series_id) and in the page JSON-LD (identifier). Old dataset ids are accepted as aliases by /v1/finwire-index/{id}. The live list with readings: /v1/finwire-index; hub with charts: finwire.pl/indeksy.

idIndexGroupReadingAliases
finwire_mortgage_barometerBarometr kredytu hipotecznego finwirecreditdaily-
finwire_credit_capacity_indexIndeks zdolności kredytowej finwirecreditmonthly-
finwire_borrowing_power_barometer ¹Barometr zdolności kredytowej finwirecreditmonthlyborrowing-power
finwire_mortgage_cost_barometer ¹Barometr kosztu kredytu finwirecreditmonthlycredit-cost
finwire_rate_risk_gauge ¹Ryzyko raty finwirecreditdailyrate-risk
finwire_fixed_rate_premium ¹Premia za stałą stopę finwirecreditdailyrate-risk
finwire_credit_market_index ¹Wskaźnik rynku kredytów hipotecznych finwirecreditmonthlycredit-market-index, credit-market
finwire_npl_forecast ¹Stres kredytowy wyprzedzający finwirecreditmonthly (forecast)-
finwire_credit_stress_index ¹Mapa stresu kredytowego finwirecreditdailycredit-stress
finwire_deposit_rate_indexIndeks lokat finwiresavingsmonthlydeposit-rate-index, deposit_rate_index
finwire_savings_rate_indexIndeks kont oszczędnościowych finwiresavingsmonthly-
finwire_real_deposit_rate_barometerBarometr opłacalności lokat finwiresavingsmonthlyreal-deposit-rate
finwire_purchasing_power_barometerBarometr siły nabywczej złotówki finwiresavingsmonthlypurchasing-power
finwire_account_cost_indexKoszt konta osobistego wg finwiresavingsmonthly-
finwire_household_inflation_indexInflacja gospodarstw domowych finwiresavingsmonthly-
finwire_pension_wage_ratioEmerytura do płacy finwiresavingsmonthly-
finwire_fund_flows_indexIndeks napływów do funduszy finwiresavingsmonthly-
finwire_new_business_ratioWskaźnik nowych firm finwiremarketmonthly-
finwire_car_registrations_pulsePuls rejestracji aut finwiremarketmonthly-
finwire_chinese_brands_shareUdział marek z Chin finwiremarketmonthly-
finwire_ev_share_new_carsUdział elektryków w nowych autach finwiremarketyearly-
finwire_ev_charging_coverageNasycenie ładowarkami finwiremarketmonthly-
finwire_ev_charging_price_indexIndeks cen ładowania finwiremarketmonthly-
finwire_ev_charger_occupancyObłożenie ładowarek finwiremarketweekly (full week)-
finwire_ev_charger_reliabilitySprawność ładowarek finwiremarketdaily-
finwire_ev_fast_coverageZasięg ultraszybkich ładowarek finwiremarketdaily-
finwire_ev_infrastructure_growthPrzyrost ładowarek finwiremarketmonthly-
finwire_ppk_avg_accountŚrednie konto PPK finwiresavingsmonthly-
finwire_retail_bond_premiumPremia obligacji skarbowych finwiresavingsmonthly-
finwire_fixed_cost_burdenSztywne koszty gospodarstwa finwirehousingmonthly-
finwire_heating_season_indexIndeks chłodu sezonu finwirehousingdaily-
finwire_heating_season_costKoszt sezonu grzewczego finwirehousingdaily-
finwire_ike_ikze_avg_balanceŚrednie saldo IKE i IKZE finwiresavingshalf-yearly-
finwire_oc_avg_premiumŚrednia składka OC finwiremarketquarterly-
finwire_eu_inflation_gapLuka inflacji Polska-UE finwiremarketmonthly-
finwire_clean_air_payout_rateWskaźnik wypłat Czystego Powietrza finwirehousingweekly-
finwire_public_debt_per_capitaDług na osobę finwiremarketmonthly-
finwire_pit_per_capitaPIT na mieszkańca finwiremarketyearly-
finwire_pit_top_bracket_multiplierMnożnik drugiego progu PIT finwirelawyearlypit-national
finwire_rcn_price_indexIndeks cen transakcyjnych finwirehousingquarterly-
finwire_price_gap_indexIndeks luki cenowej finwirehousingquarterly-
finwire_entry_threshold_index ¹Próg wejścia finwirehousingdailyentry-threshold
finwire_housing_affordability_barometer ¹Barometr dostępności mieszkania finwirehousingmonthlyhousing-affordability
finwire_housing_carry ¹Carry nieruchomości finwirehousingmonthlyhousing-carry
finwire_housing_permits_indexIndeks pozwoleń na budowę finwirehousingmonthly-
finwire_housing_pressurePresja demograficzna na mieszkania finwirehousingyearly-
finwire_housing_pipelinePodaż mieszkań za 2 lata finwirehousingquarterly-
finwire_rent_forecastPrognoza czynszów finwirehousingmonthly-
finwire_eu_mortgaged_ownersWłaściciele mieszkań z kredytem finwirehousingyearlyeu-living-conditions
finwire_offer_tickerTicker zmian ofert finwiremarketdailyoffer-changes
finwire_demand_indexIndeks popytu finwiremarketmonthly-
finwire_power_price_indexIndeks ceny prądu finwiremarketdaily-
finwire_shopping_basket_indexKoszyk zakupowy finwiremarketmonthly-
finwire_eu_power_price_gapLuka cen prądu Polska-UE finwiremarkethalf-yearly-
finwire_eu_fuel_price_gapLuka cen paliw Polska-UE finwiremarketweeklyeu-fuel-prices
finwire_eu_youth_unemployment_ratioMnożnik bezrobocia młodych finwiremarketmonthly-
finwire_eu_net_wage_gapPensja w Polsce wobec średniej UE finwiremarketyearly-
finwire_eu_convergence_yearsLicznik doganiania UE finwiremarketyearlyeu-gdp-per-capita
finwire_eu_debt_threshold_gapDług Polski wobec progu 60% PKB finwiremarketquarterly-
finwire_eu_household_income_gapDochód gospodarstw w Polsce wobec UE finwiremarketyearlyeu-living-conditions
finwire_nowcastFinwire Nowcastmarketmonthlynowcast
finwire_cost_pressurePresja kosztowa finwiremarketmonthly (forecast)-
finwire_legal_calendarKalendarz zmian w finansach finwirelawdaily-
finwire_knf_warnings_monitorMonitor ostrzeżeń KNF finwirelawweeklyknf-warnings
finwire_bfg_guarantee_monitorLicznik instytucji z gwarancją BFG finwiresavingson every list changebfg-guarantee
finwire_tax_rulings_pulsePuls interpretacji podatkowych finwirelawweeklytax-rulings
finwire_borrower_win_shareWyroki dla kredytobiorców finwirelawmonthlycredit-judgments
finwire_next_year_limitsLimity na przyszły rok finwirelawdailynext-year-limits
finwire_local_tax_squeezeNożyce fiskalne gmin finwirehousingyearlylocal-tax-squeeze
finwire_gmina_spending_per_capitaWydatki gmin na mieszkańca finwiremarketyearlyjst-budget
finwire_average_polePrzeciętny Polak finwirecreditmonthlyaverage-pole
finwire_daily_price_indexDzienny indeks cen finwiremarketdailydaily-price-index
finwire_pension_forecastPrognoza emerytur finwiresavingsyearlypension-forecast
finwire_location_premiumPremia za okolicę finwirehousingquarterlylocation-premium
finwire_coal_price_plCena węgla finwirehousingyearlycoal-waste-prices
finwire_waste_fee_plOpłata za odpady finwirehousingyearlycoal-waste-prices
finwire_consumer_bankruptciesLicznik upadłości konsumenckich finwirecreditmonthly-
finwire_rkm_offer_fitMieszkania w limicie kredytu bez wkładu finwirehousingdailyrkm-price-limits
finwire_child_benefits_payoutWypłaty na dzieci z ZUS finwiresavingsmonthlyfamily-benefits
finwire_savings_bond_salesLicznik obligacji oszczędnościowych finwiresavingsmonthly-

¹ Computed from WIBOR (GPW Benchmark): only the result is published, never WIBOR or POLSTR (usesBenchmarkRate: true).

License CC BY 4.0, attribution finwire.pl. Each index carries a ready citation with the id and method version, e.g.:

Source: Indeks zdolności kredytowej finwire (finwire_credit_capacity_index, method v1), finwire.pl, https://finwire.pl/indeksy/zdolnosc-kredytowa, CC BY 4.0

methodVersion changes with every change of the definition; history is recomputed or marked.


FAQ

Does the API return WIBOR or POLSTR?

No. WIBOR and POLSTR are administered by GPW Benchmark, and redistributing them requires a Market Data License Agreement with GPW (dystrybucja.informacji@gpw.pl). The API returns NBP policy rates: current values at /v1/series/interest-rate and daily history at /v1/series/interest-rate/{id}.

Where can I get Polish CPI inflation data as JSON?

/v1/series/cpi returns GUS consumer price inflation year-over-year and month-over-month, monthly since 1982 (type=monthly) or annually (type=yearly), with the GUS source in meta.

Is there an API for real estate transaction prices in Poland?

/v1/housing/transactions returns median, quartile and per-district flat prices per m² computed from notarial deeds in the Polish Real Estate Price Register (Rejestr Cen Nieruchomości) for 17 cities, with a quarterly trend for the last 12 quarters and a 12-month median per district. Single deeds are never exposed.

How much do I need to earn to buy a flat in a Polish city?

/v1/index/entry-threshold returns, for 17 Polish cities, the gross monthly wage one person needs to get a mortgage on a model 50 m² secondary-market flat (20% down payment, 25 years) within the KNF DSTI limits, the monthly installment and the share of employees who earn at least that. It is recomputed every night from prices per m² in notarial deeds (Real Estate Price Register, GUS RCiWN as a fallback for small samples), current mortgage offers and the GUS wage distribution; /history shows how it changed. Index id: finwire_entry_threshold_index.

How do I cite a finwire index?

Use the citation field of /v1/finwire-index/{id}: index name, finwire_* id, method version, finwire.pl and the page URL, CC BY 4.0. The id stays the same when the name or the method changes, so it is the safe key for your own database.

Is there an API for Polish tax and ZUS deadlines?

/v1/legal-calendar returns PIT, ZUS and VAT deadlines (moved to the next working day per art. 12 § 5 of the Tax Ordinance), the year end for IKE and IKZE contributions, changes of statutory values, acts entering into force, RPP meetings and retail bond sales. The same calendar is available as an ICS subscription at https://finwire.pl/kalendarz-zmian.ics.

Where can I get unemployment data by county (powiat)?

/v1/series/unemployment returns the GUS registered unemployment rate for Poland and the 16 provinces, /v1/series/unemployment/counties the counties with the lowest and highest rate, and /v1/series/unemployment/history the monthly series since 2011, all from the GUS Local Data Bank (BDL).

Is there an API for salaries by occupation in Poland?

/v1/wages/occupations returns mean, median and deciles of gross monthly wages for about 175 occupation groups from the GUS survey of wages by occupation (published every two years), split by gender and by public vs private sector, with the gender pay gap.

Do I need an API key or an account?

No key, token or sign-up is required. All endpoints are public, read-only (GET) and CORS-enabled, so they can be called directly from a browser.

Can I use the data commercially?

finwire indicators and aggregates are licensed under CC BY 4.0, which allows commercial use with attribution. Public data (NBP, GUS, Ministry of Finance, Eurostat, GPW Benchmark) requires attribution to the original source; meta.license states the terms per dataset.

How fresh is the data?

Each dataset is refreshed automatically from its primary source on the source's own schedule (daily for FX and rents, monthly for CPI and bond yields, quarterly for housing prices). meta.asOf always shows the date of the data at the source.

What is the difference between WIBOR and POLSTR?

WIBOR and POLSTR are both Polish interest rate benchmarks administered by GPW Benchmark. In the ongoing Polish benchmark reform supervised by KNF, POLSTR is the designated successor to WIBOR. Neither is available in this API (license required from GPW Benchmark).

Does the API give investment advice?

No. The data is informational. finwire.pl is not a licensed investment adviser and does not issue recommendations within the meaning of the EU Market Abuse Regulation (MAR).


Glossary

  • NBP reference rate - the main policy rate of Narodowy Bank Polski, set by the Monetary Policy Council (RPP).
  • WIBOR (Warsaw Interbank Offered Rate) - Polish interbank benchmark used for floating-rate loans.
  • POLSTR (Polish Short Term Rate) - GPW Benchmark interest rate index, WIBOR's successor in the benchmark reform.
  • CPI - consumer price index published monthly by GUS (Statistics Poland).
  • RCN (Rejestr Cen Nieruchomości) - Real Estate Price Register with prices from notarial deeds.
  • RRSO - Polish APRC (annual percentage rate of charge), the total cost of a loan.
  • DSTI - debt service to income ratio, the share of income spent on loan installments.
  • bps - basis points, 1 bps = 0.01 percentage point.
  • BDL (Bank Danych Lokalnych) - GUS Local Data Bank with statistics for provinces, counties and municipalities.
  • TERYT - official Polish territorial code of provinces, counties and municipalities.
  • Entry threshold (próg wejścia) - finwire indicator: the wage needed to qualify for a mortgage on a model flat.
  • finwire_\* - stable id of an index computed by finwire.pl, the key in /v1/finwire-index, MCP and CSV series_id.
  • Property tax upper limit - the maximum local property tax rate set yearly by the Minister of Finance; municipalities choose their rate up to it.

OpenAPI specification and TypeScript types

This repository ships the OpenAPI specification and TypeScript types generated from it. Both are regenerated from the live API on every release.

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

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

Rate limits

  • 120 requests per minute per IP, 30 per minute for /v1/snapshot.
  • Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset; 429 comes with Retry-After.
  • Responses are cached at the edge (5 minutes to 1 hour depending on the dataset), so typical use never hits the limit.

Usage policy and disclaimer

  • Free and open, GET only. Please cache responses on your side.
  • Attribute the data with the meta.citation string or Source: finwire.pl, https://public-api.finwire.pl.
  • Single bank offers, notarial deeds and rental listings are never exposed - only statistics.
  • Informational data only, not investment advice (see FAQ).

Built by finwire.pl - Polish personal finance tools: mortgage decision tool, flat prices by city, deposit rankings.

الأسئلة الشائعة

ما هو finwire.pl - Polish financial data؟

Live Polish rates, FX, housing prices, rents, credit market, legal limits and macro data.

كيف أثبّت finwire.pl - Polish financial data؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http finwire-pl-polish-financial-data 'https://public-api.finwire.pl/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج finwire.pl - Polish financial data إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل finwire.pl - Polish financial data مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون finwire.pl - Polish financial data؟

ينشره finwire-pl. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.