finwire.pl - Polish financial data
Server Details
Live Polish rates, FX, housing prices, rents, credit market, legal limits and macro data.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- finwire-pl/api
- GitHub Stars
- 2
- ChatGPT
- –
- Claude
- finwire.pl - Polish financial data
TDQS
Scored across 94 tools
Despite 94 tools, descriptions are unusually explicit about routing — dozens contain "for X, use Y" cross-references (e.g. get_interest_rates vs get_bank_rates, get_macro_indicator vs get_macro_snapshot vs compare_macro_indicators). A handful of clusters (get_deposit_bank_average / get_deposit_forecast / get_bank_rates / get_retail_bond_premium, or the pension family) still require careful reading, but boundaries are stated.
Nearly all names follow a clean verb_noun snake_case pattern with meaningful verb families: get_, list_, check_, find_, compare_, calc_, plan_, search_. No mixed casing or vague standalone verbs; prefixes even encode tool type (calc_ for calculators, check_ for lookups).
94 tools for one server is far beyond what an agent can reliably scan or select from, even with strong descriptions. Many are thin single-indicator viewers that would be better folded into a parameterized tool or a dataset catalog.
Coverage of the stated domain (Polish personal finance, macro, housing, pensions, taxes, EU/OECD comparisons, indices) is remarkably broad, with dedicated tools for nearly every subdomain. Gaps are minor for the stated scope: no equity/GPW market data and no WIBOR, though the latter is documented as a licensing limitation.
Available Tools
94 toolscalc_employer_costCost of hiring an employee in PolandARead-onlyIdempotentInspect
Use for the cost of an employee to the employer. Give the inputs and the assumptions with the result. The result is a calculation from statutory rates. It is not advice. Total monthly cost to the employer of an employment contract (umowa o pracę) or a mandate contract (umowa zlecenie) in Poland for a given gross pay: employer pension and disability contributions, accident insurance (basic rate for payers up to 9 insured), Labour Fund (FP), Guaranteed Employee Benefits Fund (FGŚP), optional PPK, plus what the employee takes home. Rates of the Polish tax year.
Inputs: monthly_gross (required), ppk, year, contract. Returns: url, asOf, data, title, +9 more
calc_net_incomeTake-home pay in Poland for any form of workARead-onlyIdempotentInspect
Use for take-home pay from an employment, mandate or work contract or B2B self-employment. Give the inputs and the assumptions with the result. The result is a calculation from statutory rates. It is not advice. Monthly take-home pay in Poland from: employment contract (uop: umowa o pracę, standard costs, PIT-2 filed, no reliefs), mandate contract (zlecenie: ZUS, health, 20% costs, PIT-2), contract for specific work (dzielo: no ZUS, 20% costs) or B2B self-employment of a sole proprietor (b2b: tax scale, flat-rate tax (liniowy) or lump-sum ryczałt on revenue, chosen ZUS scheme). Returns social security (ZUS), health contribution, income tax, net, yearly totals, effective rate and, for uop and zlecenie, the cost to the payer. Rates of the Polish tax year, switching on 1 January. For one person choosing between business forms use compare_business_forms.
Inputs: form (required), monthly_amount (required), ppk, tax, +5 more. Returns: url, asOf, data, title, +9 more
calc_zus_contributionsSocial security (ZUS) of a sole proprietor in PolandARead-onlyIdempotentInspect
Use for the social security contributions of a sole proprietor. Give the inputs and the assumptions with the result. The result is a calculation from statutory rates. It is not advice. Monthly social security contributions (ZUS: pension, disability, sickness, accident, Labour Fund) of a sole proprietor (JDG) in Poland under each scheme: start relief (ulga na start), preferential ZUS and full ZUS, with the contribution base. The health contribution depends on the tax form and income; use calc_net_income with form b2b for it.
Inputs: year. Returns: url, asOf, data, title, +9 more
check_bfg_guaranteeCheck the BFG deposit guarantee of a bankARead-onlyIdempotentInspect
Use to check if the BFG deposit guarantee includes a bank or a credit union. Check whether a Polish bank or credit union (SKOK) is on the list of entities covered by the deposit guarantee of the Bankowy Fundusz Gwarancyjny (BFG), by name, trade name (e.g. "Inteligo") or website. Without query: counts of commercial banks, cooperative banks, credit unions and entities in bankruptcy (series finwire_bfg_guarantee_monitor) with history and latest changes, and the guarantee limit (EUR 100,000 per depositor per bank) with its PLN equivalent at the latest NBP rate. Branches of banks from other EU countries are covered by their home-country scheme, so no match for them is expected.
Inputs: limit, query. Returns: url, asOf, data, title, +9 more
check_knf_warningsCheck a firm on the KNF warnings listARead-onlyIdempotentInspect
Use to check if the KNF warnings list contains a company, an investment platform or a website. Look up a company, investment platform or website on the public warnings list of the Polish Financial Supervision Authority (KNF) by name, website domain, KRS, NIP or REGON. Returns matching entries verbatim from KNF (entity, identifiers, legal basis, prosecutor, final rulings, important information). An entry is a notification of a suspected offence, not a conviction; no match does NOT mean the firm is licensed or safe. Without query: list size, entries by legal basis, entries new this week and the weekly series finwire_knf_warnings_monitor.
Inputs: limit, query. Returns: url, asOf, data, title, +9 more
compare_business_formsSole proprietorship vs limited company in PolandARead-onlyIdempotentInspect
Use to compare a sole proprietorship (JDG) with a limited company (sp. z o.o.) by taxes and net income to the owner. For a shareholder resident abroad, give the dividend rate from get_tax_treaty. Give the inputs and the assumptions with the result. The result is a calculation from statutory rates. It is not advice. Compare yearly taxes and net income to the owner for running a business in Poland as a sole proprietorship (JDG: tax scale, flat-rate tax (liniowy), lump-sum ryczałt) or a limited liability company (sp. z o.o.) with one shareholder (shareholder pays ZUS and the health contribution) or with two or more shareholders. Company profit taxed with CIT (reduced small-taxpayer rate when revenue fits the EUR limit at the NBP rate set by law, otherwise the standard rate; the rate used is in citRate) and the dividend tax: Polish statutory rate by default, or pass dividend_tax_rate from a tax treaty for a shareholder resident abroad. Assumes all profit is paid out as dividend. Not covered here: who may open which form (residence status), management board pay, Estonian CIT.
Inputs: yearly_revenue (required), zus, year, yearly_costs, +2 more. Returns: url, asOf, data, title, +9 more
compare_macro_indicatorsCompare indicators side by sideARead-onlyIdempotentInspect
Use for 2-4 macro series side by side, for example inflation and wages. History of 2-4 indicators aligned by period. All keys must have the same frequency (all monthly, or all quarterly); otherwise the call fails and says which differ.
Inputs: keys (required), from. Returns: asOf, series, source, docsUrl, +4 more
find_ev_chargersFind EV chargers in Poland (UDT EIPA)ARead-onlyIdempotentInspect
Use to find EV chargers near a place: fast, free or available chargers. Public EV charging sites in Poland from the UDT register EIPA near a city or a point: give city, or lat and lon with radius_km. Filters: min_kw (e.g. 150 for ultra-fast), free_charging, available_now (at least one point free according to a status younger than 2 hours), network slug, connector (ccs, chademo, type2). Each site: name, address, network, power class (AFIR), maximum kW, points, points free now, lowest ad hoc price per kWh (price for a driver without a contract), distance. Pass id for one site with stations, points, connectors, prices and status. Operators report data; check the price at the charger.
Inputs: id, lat, lon, city, +7 more. Returns: url, asOf, data, title, +9 more
get_average_poleAverage Pole (typical person in Poland)ARead-onlyIdempotentInspect
Use for the typical or average person in Poland: median age, wage, flat, mortgage, pension, spending and car. Profile of the typical person in Poland (finwire_average_pole) built from the latest official readings: median age (Eurostat), median gross and net wage (GUS), median price per m2 of a flat (GUS), average new mortgage (BIK), model monthly mortgage payment, average ZUS pension, spending per person (GUS household budgets), car age classes (Eurostat) and the most registered car brand. Each trait carries its measure (median, mean, model, distribution, most frequent) and its own data period.
Inputs: no named parameters. Returns: url, asOf, data, title, +9 more
get_bank_penaltiesUOKiK and KNF fines of Polish banksARead-onlyIdempotentInspect
Use for fines imposed by UOKiK or KNF on a Polish bank, how many fines a bank had in the last 5 years and the sum, or which banks were fined most. For the KNF warnings list of unlicensed firms, use check_knf_warnings. For the BFG deposit guarantee, use check_bfg_guarantee. Fines imposed by the President of UOKiK (consumer protection) and by the Polish Financial Supervision Authority (KNF) on Polish banks described on finwire.pl, in the last 5 years: count and sum per bank (series finwire_bank_penalty_count; group companies such as mortgage banks, fund managers or leasing firms counted separately). With bank: the fines of that bank with the party verbatim from the source, amount (UOKiK press releases often give rounded amounts), dates, finality when the press release states it, and a link to the UOKiK press release or the KNF list. Matching uses current and former legal names (e.g. Santander Bank Polska = Erste Bank Polska); parties matched with lower confidence are left out. UOKiK fines start from the first press release read (the RSS feed has no history). Information only, not an assessment of the bank.
Inputs: bank, limit. Returns: url, asOf, data, title, +9 more
get_bank_ratesMarket rates: loans, deposits, bondsARead-onlyIdempotentInspect
Use for market rates of mortgages, cash loans, deposits, savings accounts and retail bonds. For NBP rates, use get_interest_rates. Aggregates of offers currently on the market (median and percentiles, no single bank offers): mortgage APRC and margin, cash loan APRC, term deposit and savings account rates; or retail government bond rates (product "bonds"). finwire indices of the best offers (finwire_mortgage_barometer, finwire_deposit_rate_index, finwire_savings_rate_index, finwire_account_cost_index): get_finwire_index.
Inputs: product (required), amount, period. Returns: url, asOf, data, title, +9 more
get_bills_awaiting_presidentActs awaiting the President's signature (Poland)ARead-onlyIdempotentInspect
Use for which acts wait for the signature of the President of Poland, how many days are left, and whether the President signed or vetoed an act. Give the Sejm and the Chancellery of the President as the source. Acts passed by the Polish parliament and presented to the President without a decision yet: day of presentation, deadline and days left. The President has 21 days from presentation (art. 122 ust. 2 of the Constitution), 7 days for the budget act (art. 224 ust. 1). Also the President's decisions of the last 30 days: signature, veto (refusal to sign, the act goes back to the Sejm) or referral to the Constitutional Tribunal, with the announcement of the Chancellery of the President. All acts, not only finance; finance=true keeps only acts on personal finance topics.
Inputs: query, finance. Returns: url, asOf, data, title, +9 more
get_bond_next_ratePolish savings bond rate in the next interest periodARead-onlyIdempotentInspect
Use for the rate of Polish savings bonds (EDO, COI, ROR, DOR, ROS, ROD) in the next interest period, for example "what will my EDO pay from December" or "what will COI pay in the next year". If the user gives the purchase month, use type and purchase_month. If the state is estimate, tell the user that it is a model estimate. If the state is unknown, give knownFrom. Finwire Bondcast (finwire_bond_next_rate): the interest rate of Polish State Treasury retail savings bonds in the next interest period, from the rules in the Ministry of Finance issue letters. COI, EDO, ROS and ROD from the 2nd year: margin + GUS CPI y/y for month M-2 (M = first month of the period), zero if CPI is negative. ROR and DOR each month: NBP reference rate on the 10th working day before the month + margin. Each period has a state: announced (Ministry of Finance interest table), known (rate from the formula with a published input), estimate (GUS flash CPI, Finwire Nowcast CPI with an 80% interval, or scenarios of the next RPP decision) or unknown (no number; knownFrom gives the date of the exact rate). Without arguments: the index (2nd year of EDO bought 12 months before next month), periods that start in the next 3 months by bond type, the formula inputs and how the Ministry of Finance followed RPP decisions. With series, or with type and purchase_month: all interest periods of that series. A series code is the type + month and year of maturity (EDO bought in December 2025 = EDO1235). Informational data, not investment advice.
Inputs: type, series, purchase_month. Returns: url, asOf, data, title, +9 more
get_broker_feesBrokerage account feesARead-onlyIdempotentInspect
Use for brokerage account fees. Fees of brokers available to Polish investors from their official fee tables: online order commission on Warsaw (GPW), US and German stocks and ETFs, account and currency conversion fees, IKE/IKZE and investor protection, with the fee table URL and the date it was last confirmed. Facts only, no ranking or recommendation.
Inputs: broker, market. Returns: url, asOf, data, title, +9 more
get_business_formsBusiness forms a foreigner may use in PolandARead-onlyIdempotentInspect
Use to find which business forms a foreigner or a foreign company can use, and why. Give the legal basis and the verification date of each fact. All Polish business forms (sole proprietorship JDG, unregistered activity, sp. z o.o., P.S.A., S.A., general, limited and professional partnerships, branch, representative office) with available yes/no for the owner status, the reason, conditions (e.g. PESEL for CEIDG) and facts on capital, liability, registration and tax, each with the legal basis.
Inputs: owner_status (required), lang. Returns: url, asOf, data, title, +9 more
get_business_glossaryPolish business terms in EnglishARead-onlyIdempotentInspect
Use for the meaning of Polish business, tax and ZUS terms. Polish-English glossary of business, tax, ZUS and registration terms (JDG, sp. z o.o., CEIDG, KRS, ryczałt, KPiR, KSeF, JPK, CRBR, UPO, PSI and others) with one-line explanations.
Inputs: lang. Returns: url, asOf, data, title, +9 more
get_business_guideRules of doing business in Poland, with sourcesARead-onlyIdempotentInspect
Use for company tax regimes and reliefs (CIT, Estonian CIT, IP Box, R&D relief, Polish Investment Zone). Also use for VAT, residence permits, PESEL, e-signature, hiring foreigners, labour law, accounting and closing a business. Give the legal basis and the verification date of each fact. Verified facts about doing business in Poland, each with the act, article, link to the official text and the verification date. Topics: intl-tax (selling into Poland from abroad, VAT registration, reverse charge, OSS, permanent establishment, transfer pricing, Estonian CIT, IP Box), residence (permits, MOS), identity (PESEL, NIP, trusted profile, e-signature), documents (sworn translation, apostille), forms, setup (steps and deadlines), activity (PKD 2025, regulated activities), wht, treaty, tax-residence, health (NFZ, A1), property (buying property as a foreigner), contracts, labour (Labour Code rules), hiring-foreigners (work permits, declarations), deadlines, accounting (books, invoices, KSeF, whitelist), incentives (Polish Investment Zone, regional aid map, R&D relief), exit (suspension, conversion, liquidation). Pass a topic, a query, or both.
Inputs: lang, query, topic. Returns: url, asOf, data, title, +9 more
get_business_registrationsNew and closed businesses in Poland (CEIDG)ARead-onlyIdempotentInspect
Use for the number of new, closed and suspended sole proprietorships (CEIDG). To start a business, use plan_business_entry or get_business_guide. Monthly applications filed in CEIDG, the Polish register of sole proprietorships (Ministry of Development and Technology data on dane.gov.pl): registrations of new sole proprietorships, closures (deregistrations), suspensions and resumptions, registrations minus closures, the latest month against the same month in earlier years, the share of women among founders, sums since January and over 12 months, and the finwire index finwire_new_business_ratio (registration applications per 100 closure applications over 12 months; above 100 the number of firms grows). Counts of applications, not of firms in the register; companies registered in KRS are not included.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_car_insurance_marketCar insurance in Poland: average OC and AC premium (KNF)ARead-onlyIdempotentInspect
Use for the average price of car insurance (OC and autocasco) in Poland, its trend and the size of the market. Tell the user that this is a market average and not a quote for one driver. Average car insurance premium in Poland from the quarterly KNF bulletin "Rynek ubezpieczeń" (part D): average gross written premium per policy for OC (motor third-party liability, insurance class 10) and autocasco (AC, class 3) over the last 4 quarters and in the last quarter, change vs a year earlier, policies written and in force, claims paid per 100 PLN of premium in the same window, claims paid per settled claim, the 18 non-life insurance classes, quarterly history and the finwire index finwire_oc_avg_premium. Amounts in PLN. These are market averages: they are not a price quote for a specific driver or car. Informational data, not insurance advice.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_coal_waste_pricesCoal price and waste fee in PolandARead-onlyIdempotentInspect
Use for the average price of a tonne of coal or the waste collection fee, in Poland and by province. Cena węgla finwire (finwire_coal_price_pl) and Opłata za odpady finwire (finwire_waste_fee_pl): annual average price of a tonne of hard coal and monthly fee for sorted waste collection per person in multi-family buildings, Poland and 16 provinces, from Statistics Poland (GUS). Annual averages for a past year, not current shop prices.
Inputs: region, series. Returns: url, asOf, data, title, +9 more
get_compliance_calendarYearly deadlines of a business in PolandARead-onlyIdempotentInspect
Use for the yearly tax, ZUS, VAT and reporting deadlines of a business. Calendar of tax, ZUS, VAT, payroll and reporting deadlines for a calendar year: monthly PIT/CIT advances or ryczałt, own ZUS, JPK_V7M, PIT and ZUS of employees, PPK, annual returns, annual health contribution, CIT-8, financial statements and JPK files. Dates are computed from statutory rules with the shift to the next working day; event-based duties (CRBR, ZUS registration, invoices) are listed as facts.
Inputs: form (required), lang, year, employees, +1 more. Returns: url, asOf, data, title, +9 more
get_consumer_bankruptciesConsumer bankruptcies in Poland (COIG)ARead-onlyIdempotentInspect
Use for the number of people who declare consumer bankruptcy in Poland, by month and year. Give COIG as the source. Number of people declared bankrupt as consumers in Poland per month, compiled by COIG (Centralny Ośrodek Informacji Gospodarczych) from court announcements in the National Register of Debtors (KRZ) and Monitor Sądowy i Gospodarczy: the latest month with year-on-year change, the sum since January against the same period a year earlier, the last 12 months, the rank of the latest month in the whole series and among the same calendar month, highest and lowest month, yearly totals and the finwire index finwire_consumer_bankruptcies (consumer bankruptcies in the 12 months up to the month). Attribution to COIG is mandatory (data COIG, reuse with attribution; not CC BY). For the cost and rules of the procedure itself see the finwire.pl page linked in the result.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_credit_judgmentsCourt rulings in credit disputesARead-onlyIdempotentInspect
Use for court rulings in consumer credit disputes (CHF loans, WIBOR, free credit sanction, early repayment) and the share that borrowers won. Statistics of rulings of Polish common courts in consumer credit disputes, published in the Court Rulings Portal of the Ministry of Justice and classified by finwire.pl: CHF mortgages (chf), loans in EUR and other currencies (waluta_inna), free credit sanction under art. 45 of the Consumer Credit Act (skd), cost refunds after early repayment, Lexitor (wczesniejsza_splata), WIBOR clauses (wibor), unit-linked policies (polisolokata). Returns rulings per publication month, share ruled for the borrower at least in part in 12 full publication months (finwire_borrower_win_share, total and per category), first vs second instance, median time from claim to judgment and the newest rulings with case number, court, outcome and a link to the full text. Statistics of published rulings, not legal advice; each ruling concerns one contract.
Inputs: limit, category. Returns: url, asOf, data, title, +9 more
get_credit_marketHousing loan marketARead-onlyIdempotentInspect
Use for the state of the mortgage market: lending criteria, demand and new loans. Polish housing loan market: topic "index" (finwire 0-100 credit market index, returns finwire_credit_market_index), "survey" (NBP bank lending survey: criteria and demand), "monetary" (NBP household loans and deposits, new housing loans), "demand" (BIK Demand Index for housing loans, average requested vs granted amount, granted loans y/y according to BIK, new housing loans from NBP).
Inputs: topic. Returns: url, asOf, data, title, +9 more
get_currency_ratesNBP exchange rates and goldARead-onlyIdempotentInspect
Use for exchange rates and the gold price. NBP mid, bid and ask rates of currencies against PLN (table), the history of one currency, or the NBP gold price (code "XAU").
Inputs: code, days. Returns: url, asOf, data, title, +9 more
get_daily_price_indexDaily price index finwire (online shelf prices)ARead-onlyIdempotentInspect
Use for daily online prices of a basket of food, household and personal care products. For official CPI, use get_macro_indicator. Experimental daily index of online shelf prices of a fixed basket of food, drinks, household and personal care products in three Polish online shops (finwire_daily_price_index), base month = 100: latest value and change since the base month, basket categories with change since the base month and month on month, categories with the largest rise and fall, monthly readings, the food part vs GUS CPI food and non-alcoholic beverages for the same completed month, and the collection state (days, products, stores, expected first reading) while the base month is being collected. Online prices only, not CPI; no prices of single products or shops.
Inputs: no named parameters. Returns: url, asOf, data, title, +9 more
get_datasetRead any datasetARead-onlyIdempotentInspect
Use after search_datasets, and only when no dedicated tool is applicable. Any dataset by id from search_datasets, with optional params listed there. Returns the same data as the public REST API /v1 (long lists shortened).
Inputs: id (required), params. Returns: url, asOf, data, title, +9 more
get_deposit_bank_averageAverage new deposit and consumer loan rates in Polish banks (NBP MIR)ARead-onlyIdempotentInspect
Use for the average rate on new deposits in Polish banks by maturity, how much more the best deposits pay than the bank average, and the average rate and APRC of new consumer loans. For offers of single banks, use get_bank_rates. NBP interest rate statistics (MIR) for new household business in PLN: average rate on new term deposits (all maturities and by original maturity) with the value and share of new deposits by maturity, and the average rate and APRC (RRSO) of new consumer loans. With Premia za wybór lokaty finwire (finwire_deposit_choice_premium): how much more the finwire deposit index (5 best 3-month deposits) pays than the average new 1-3 month deposit, in pp and in PLN per year on PLN 10,000 after tax, plus a current estimate. Market averages, not an offer. Informational data, not investment advice.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_deposit_forecastForecast of the average new deposit rate in Poland (Finwire Depocast)ARead-onlyIdempotentInspect
Use when the user asks if deposit rates will fall or rise, or what deposits will pay in the next months. Tell the user that it is a model estimate. For NBP rate decisions, use get_nowcast. Finwire Depocast (finwire_deposit_rate_forecast): model forecast of the average rate on new household term deposits in Polish banks (NBP MIR) 1, 3 and 6 months after the latest NBP month, with an 80% interval, the assumed NBP reference rate and backtest accuracy (error, no-change error, interval coverage). Only horizons that passed the accuracy gate are returned; hiddenHorizons counts the others. Settled earlier forecasts are compared with NBP readings. It is a model estimate, not investment advice.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_electric_vehiclesElectric cars in Poland (Eurostat, GUS, UDT)ARead-onlyIdempotentInspect
Use for the number of electric cars (BEV, PHEV) by year, county and province. Battery electric (BEV) and plug-in hybrid (PHEV) passenger cars in Poland: fleet at year end and new cars in the year with shares (Eurostat), fuel mix of new cars, provinces and counties per 1000 passenger cars with top and bottom counties (GUS BDL, when the county series is available), and the correlation of public charging sites per 10k residents with BEV per 1000 cars across counties, with a 95% interval and a version controlling the median wage. Correlation is not causation. Index finwire_ev_share_new_cars. For charging points use get_ev_charging.
Inputs: counties. Returns: url, asOf, data, title, +9 more
get_energy_pricesRegulated electricity and gas pricesARead-onlyIdempotentInspect
Use for regulated electricity and gas tariffs in Poland. For prices in the EU, use get_europe_data. Household electricity and gas tariffs approved by URE and in force today: electricity energy price of the default seller and distribution rates per operator for G11, G12 and G12w with cheaper-zone hours and fees; gas fuel price, subscription and PSG distribution rates per tariff area for W-1.1 to W-4. Net amounts, VAT rate given; each with the URE decision and PDF.
Inputs: area, date, carrier. Returns: url, asOf, data, title, +9 more
get_eu_earningsNet earnings in EU countries (Eurostat)ARead-onlyIdempotentInspect
Use for salaries and net pay in EU countries, how Polish pay compares with the EU or one country, and how a given net salary in PLN compares with the average in each EU country. For minimum wages, use get_europe_data. Annual net earnings (take-home pay after income tax and employee social contributions, plus family allowances) in the 27 EU countries from Eurostat earn_nt_net, yearly, by household type: single person, couples with and without children, single parent, low (67%) and high (167%) wage. Ranking in EUR and in purchasing power standards (PPS, adjusted for price levels), gross pay, tax and contributions, hourly labour cost of employers (lc_lci_lev), tax wedge of a low-wage single earner, the finwire index finwire_eu_net_wage_gap (Poland as % of the EU average in PPS) and the history of Poland and one comparison country. With salary (monthly net in PLN) it compares that pay with the average of the same household type in every EU country, in EUR and PPS, and gives the monthly EUR amount with the same purchasing power.
Inputs: salary, compare, household. Returns: url, asOf, data, title, +9 more
get_eu_fuel_pricesFuel prices in EU countries (European Commission)ARead-onlyIdempotentInspect
Use for fuel prices in other EU countries, Poland against the EU, and where to fill the tank on a trip abroad. Say that the prices are national averages. Prices of Euro-super 95 petrol, diesel, LPG or heating oil at filling stations in the 27 EU countries from the European Commission Weekly Oil Bulletin (Monday prices, weekly since 2005): PLN and EUR per litre with all taxes, without taxes and tax share, rank from the cheapest, weekly change, a year earlier, the EU and euro area weighted averages, the difference for a full tank against Poland and the finwire index finwire_eu_fuel_price_gap. PLN prices use the NBP EUR mid rate of the reading day. These are national averages; motorway stations are usually more expensive.
Inputs: fuel, tank, country. Returns: url, asOf, data, title, +9 more
get_eu_gdpGDP per capita and GDP growth in EU countries (Eurostat)ARead-onlyIdempotentInspect
Use for GDP per capita of EU countries, Poland against the EU in purchasing power, GDP growth of EU countries in a quarter, and when Poland could reach the EU average or another country. Tell the user that the catch-up year is arithmetic, not a forecast. GDP per capita of the 27 EU countries in purchasing power standards (PPS, EU27 = 100) and in EUR per inhabitant with the rank, real growth of GDP per capita (last year, 5- and 10-year averages), actual individual consumption per capita (AIC, EU27 = 100) and the price level of consumption, the latest quarter of real GDP growth (seasonally adjusted, quarter on quarter and year on year), the EU and the euro area, yearly history since 1995 of Poland, the EU and one country, and the finwire index finwire_eu_convergence_years (Licznik doganiania UE finwire): years until GDP per capita of Poland in PPS reaches the EU average at the average real growth of the last 10 years. Arithmetic on a constant pace, not a forecast.
Inputs: country. Returns: url, asOf, data, title, +9 more
get_eu_inflationInflation in EU countries (Eurostat HICP)ARead-onlyIdempotentInspect
Use for inflation in EU countries, the place of Poland in the EU and price growth since a year. For the CPI of Statistics Poland, use get_macro_indicator. Harmonised inflation (HICP, annual rate) in the 27 EU countries, the EU and the euro area from Eurostat, monthly since 2000: the latest month with Poland, ranking from the highest inflation, change vs the previous month, the place of Poland and the place a month and a year earlier, five components (core inflation, food, energy, services, industrial goods), price growth in every country since the same month of a chosen year (basket), the finwire index finwire_eu_inflation_gap (Polish HICP minus EU HICP, percentage points) and the euro area flash estimate when newer. With country: that country's monthly component history. HICP is the EU-comparable measure; for the national CPI of Statistics Poland use get_macro_indicator.
Inputs: since, compare, country. Returns: url, asOf, data, title, +9 more
get_eu_living_conditionsHome ownership, mortgages, financial cushion and household income in the EU (Eurostat EU-SILC)ARead-onlyIdempotentInspect
Use for how many people own their home with or without a mortgage or rent in EU countries, for people who cannot pay an unexpected expense (financial cushion) and for household income per person in EU countries. For house prices in the EU, use get_europe_data. For net pay, use get_eu_earnings. Yearly EU-SILC survey for the 27 EU countries, the EU and the euro area (Eurostat): share of people living in their own home without a mortgage, with a mortgage or housing loan, in market rent and in reduced rent or free (ilc_lvho02); share of people in households that cannot face an unexpected required expense from their own resources (ilc_mdes04); median and mean equivalised disposable income per year in EUR, PPS and PLN for Poland (ilc_di03, household income divided by the modified OECD scale; the survey year reports income of the previous year). Ranks, Poland against the EU and one comparison country with history since 2005, and two finwire indices: finwire_eu_mortgaged_owners (owners with a mortgage as % of all owners) and finwire_eu_household_income_gap (median income in Poland as % of the EU value in PPS).
Inputs: topic, compare. Returns: url, asOf, data, title, +9 more
get_eu_public_debtGovernment debt and deficit in the EUARead-onlyIdempotentInspect
Use for government debt and deficit of EU countries and Poland against the EU, and for the 3% and 60% of GDP reference values. For Polish State Treasury debt per month, use get_public_debt. General government gross debt, deficit and interest as % of GDP in the 27 EU countries, the EU and the euro area (Eurostat): debt at the end of the latest quarter with the change in a year, deficit, interest and debt in the latest year from the excessive deficit procedure notification, ranks, countries above the 3% deficit and 60% debt reference values in the data (not the list of countries under the procedure), annual history of Poland, the EU and one comparison country, and finwire_eu_debt_threshold_gap (Poland quarterly debt minus 60, percentage points).
Inputs: compare. Returns: url, asOf, data, title, +9 more
get_europe_dataPoland against EuropeARead-onlyIdempotentInspect
Use to compare Poland with the EU: house prices, mortgage rates, bond yields, household electricity and gas prices, and minimum wages. Poland compared with EU countries: "house-prices" (Eurostat house price index), "mortgage-rates" (ECB rates on new housing loans), "bond-yields" (10-year yields and spreads vs Germany and euro area), "overburden" and "overcrowding" (housing conditions), "energy-prices" (household electricity or gas prices per kWh in EUR and purchasing power standards, half-yearly, with finwire_eu_power_price_gap and kWh per minimum wage), "minimum-wages" (statutory minimum wages in EUR and PPS, half-yearly).
Inputs: topic (required), compare, product. Returns: url, asOf, data, title, +9 more
get_eu_unemploymentUnemployment in EU countries (Eurostat)ARead-onlyIdempotentInspect
Use to compare unemployment in Poland with EU countries, also youth unemployment. For registered unemployment in Polish voivodeships, use get_regional_data. Monthly unemployment rate in the 27 EU countries, the EU and the euro area from Eurostat (une_rt_m, seasonally adjusted, ILO definition from labour force surveys): total and persons under 25, rank from the lowest rate, change vs the previous month and a year earlier in percentage points, rank of Poland in every month since 2010, history of Poland, the EU, the euro area and one comparison country, and the finwire index finwire_eu_youth_unemployment_ratio (youth rate divided by the total rate in Poland). This is not the registered unemployment rate of Polish labour offices (GUS); for that and for voivodeships use get_regional_data with topic unemployment.
Inputs: compare, history. Returns: url, asOf, data, title, +9 more
get_ev_chargingEV charging points in Poland (UDT EIPA)ARead-onlyIdempotentInspect
Use for statistics of EV charging points in Poland, provinces and counties. For chargers near a place, use find_ev_chargers. Public EV charging in Poland from the UDT register EIPA: locations, stations and charging points today and at each month end since December 2019, growth year on year, charging sites and fast sites (at least 50 kW) by province and county, sites per 10k residents, sites by maximum power class (EU AFIR: up to 22 kW, 23-49, 50-149, 150-349, 350+ kW) and connector (CCS, Type 2, CHAdeMO), counties with the most ultra-fast sites (150 kW and more), networks with the most fast sites, the finwire index finwire_ev_charging_coverage (charging points per 1000 BEV and PHEV cars in the fleet), growth records and the finwire index finwire_ev_infrastructure_growth (charging points year on year), and daily growth by power class and network since the start of measurement. Interactive map with every site: finwire.pl/mapa-ladowarek.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_ev_charging_pricesEV charging prices in Poland (UDT EIPA)ARead-onlyIdempotentInspect
Use for the EV charging price per kWh and network price lists. Ad hoc EV charging prices in Poland (for a driver without a contract) reported by operators to the UDT register EIPA: median price per kWh with point counts by power class (AC up to 22 kW, DC below 50 kW, DC 50-149 kW, from 150 kW), AC vs DC, cheapest and most expensive networks, share of points with a per-minute fee, recent price changes and the finwire index finwire_ev_charging_price_index. With network: that network's price list by power class and its price changes. Subscriptions and app tariffs can be cheaper and are not included.
Inputs: network. Returns: url, asOf, data, title, +9 more
get_family_benefitsChild benefits paid by ZUS: 800 plus and Aktywny RodzicARead-onlyIdempotentInspect
Use for how many children get 800 plus or Aktywny Rodzic (babciowe, nursery, at home) and how much ZUS pays, in Poland, by voivodeship and by municipality (gmina). Give ZUS as the source. Monthly statistics of ZUS (Polish Social Insurance Institution) on the child benefit 800 plus (świadczenie wychowawcze) and the three Aktywny Rodzic benefits (aktywni rodzice w pracy - working parents and aktywnie w domu - at home, both for children aged 12-35 months; aktywnie w żłobku - nursery fee): benefits paid in the latest month with year-on-year change, PLN paid in the month and since January, average payment, children paid, 800 plus applications, granted and refusals since January, the share of each Aktywny Rodzic variant in Poland and in a chosen voivodeship, and the finwire index finwire_child_benefits_payout (PLN billion paid in the month for all four benefits). For the amount of 800 plus, deadlines and how much it grows when saved see the finwire.pl page linked in the result.
Inputs: gmina, history, voivodeship. Returns: url, asOf, data, title, +9 more
get_finwire_indexOne finwire index with historyARead-onlyIdempotentInspect
Use for one finwire index with history. Find the id with list_finwire_indices. Give the id and the method version from the citation field. One finwire index by its id finwire_* (old dataset ids such as credit-market-index, borrowing-power or credit-stress are accepted as aliases): latest and previous reading with periods, change, method version, sources, citation formula and history. Indices computed from WIBOR publish only the result.
Inputs: id (required), history. Returns: url, asOf, data, title, +9 more
get_fixed_cost_burdenHousehold fixed cost burden by provinceARead-onlyIdempotentInspect
Use for the share of household income that goes to the mortgage, admin fees and utilities, by province. Sztywne koszty gospodarstwa finwire (finwire_fixed_cost_burden): share of net income of a model household (two earners on the regional median wage) taken by the mortgage payment on a 50 m2 flat in the province capital, administrative fee, heating, water, waste, electricity and TV licence; Poland and 16 provinces, monthly, with the share without the mortgage.
Inputs: region, history. Returns: url, asOf, data, title, +9 more
get_fuel_pricesMaximum fuel pricesARead-onlyIdempotentInspect
Use for the maximum fuel prices that the state sets. For average prices in shops, use get_retail_prices. Maximum retail prices of Pb95, Pb98 and diesel in PLN per litre announced by the Minister of Energy in Monitor Polski: price in force, next day price if announced, and recent history.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_heating_seasonHeating season in Poland: degree days, cold index, season costARead-onlyIdempotentInspect
Use for the heating season: degree days, the cold of this winter against the norm, and the heating bill forecast. Indeks chłodu sezonu finwire (finwire_heating_season_index) and Koszt sezonu grzewczego finwire (finwire_heating_season_cost): heating degree days since 1 July (Eurostat method, IMGW-PIB synoptic stations) vs the 20-season norm for Poland and 17 cities, cold index (100 = norm, below = warmer), season forecast with an 80% interval only when the backtest gate passes (otherwise the reason), season heating cost of a 100 m2 house (gas, heat pump, coal, district heating), monthly means vs norm, coldest and warmest seasons since 1966/67.
Inputs: city. Returns: url, asOf, data, title, +9 more
get_household_savingsHousehold savings in Poland: financial assets by instrument, invested share, Poland vs OECDARead-onlyIdempotentInspect
Use for how much money households in Poland hold and where: cash, bank deposits, bonds, shares, investment funds, insurance and pension savings, the share outside cash and deposits, and Poland against OECD countries. Give NBP (via the ECB) and OECD as sources and the quarter or year. Financial assets of households in Poland at the end of each quarter since 2003 from the quarterly financial accounts compiled by NBP and published by the ECB (QSA): total, cash, deposits, debt securities, equity, investment funds, life insurance, pension entitlements and other, in PLN billion with shares and year-on-year change; finwire_household_invested_share (Udział oszczędności pracujących finwire: share of financial assets outside cash and deposits, i.e. debt securities, equity and funds, insurance and pension entitlements); Poland among countries in the OECD financial dashboard (share of currency and deposits with rank, equity, funds, pension; net financial worth per person in USD PPP); investment funds, PPK, IKE and IKZE and retail savings bond sales from other finwire datasets.
Inputs: quarters. Returns: url, asOf, data, title, +9 more
get_housing_balanceHousing demand vs supply and forecasts (finwire)ARead-onlyIdempotentInspect
Use for housing demand against supply, the completions forecast and the rent forecast. finwire housing balance for Poland and 17 cities: finwire_housing_pressure (new residents per 1 dwelling completed in the same year, from GUS migration for permanent residence and foreigners insured in ZUS, yearly), finwire_housing_pipeline (forecast of dwellings completed in 4 quarters up to 2 years ahead from GUNB building permits, 80% interval and backtest accuracy per horizon) and finwire_rent_forecast (6-month change of asking rent per m2, published only after passing the accuracy threshold). Present forecasts as model estimates with the interval and accuracy, never as certainty.
Inputs: city. Returns: url, asOf, data, title, +9 more
get_housing_carryHousing carry: rent vs mortgage interest per cityARead-onlyIdempotentInspect
Use to find if rent covers mortgage interest in a city (net yield minus mortgage rate). Carry nieruchomości finwire (finwire_housing_carry): per Polish city, the net rental yield of a typical 2-room flat (after one vacant month, flat-rate rental tax, admin fee in vacant months and property tax) minus the variable mortgage interest rate, in percentage points, monthly with history, plus net rent minus first-year interest in PLN per month for a loan covering the whole price. Negative carry = interest exceeds net rent; buying to let on credit then relies on price growth. For rents and plain yields use get_rents. Informational data, not investment advice.
Inputs: city. Returns: url, asOf, data, title, +9 more
get_housing_costsRunning costs of a flatARead-onlyIdempotentInspect
Use for the running costs of a flat. Monthly running costs of a flat in 20 largest cities: co-op and owners association charges per m², heating, electricity, gas, water and waste rates, each with year and scope (city or province).
Inputs: city. Returns: url, asOf, data, title, +9 more
get_housing_pricesFlat prices per m² (notarial deeds)ARead-onlyIdempotentInspect
Use for flat prices per m2 in a city or district. Transaction prices of flats per square meter from notarial deeds (RCN): median, quartiles, year-over-year change and number of deeds in 17 cities, or per district of one city. source "gus" gives the GUS quarterly series instead. view "location-premium" gives finwire_location_premium: per district, how far the actual price deviates from the price expected from neighbourhood quality (transport, schools, shops, greenery, quiet, air), with model fit and accuracy; without city, the status of every city. The quarterly finwire indices finwire_rcn_price_index and finwire_price_gap_index: get_finwire_index.
Inputs: city, view, source, district. Returns: url, asOf, data, title, +9 more
get_ike_ikze_statsIKE and IKZE retirement accounts in Poland (KNF)ARead-onlyIdempotentInspect
Use for the IKE and IKZE market: accounts, assets, contributions by institution type and average balance. IKE and IKZE (Polish individual retirement accounts with tax relief) from half-yearly KNF data: number of accounts and assets, split by institution type (insurers, investment funds, brokers, banks, voluntary pension funds), accounts opened, contributions, withdrawals and returns since January, holders by sex and age, average annual contribution as % of the statutory annual limit (December states), and the finwire index finwire_ike_ikze_avg_balance (average balance per account). Amounts in PLN. For the contribution limits themselves use get_legal_limits. Informational data, not investment advice.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_interest_ratesNBP interest ratesARead-onlyIdempotentInspect
Use for NBP policy rates. For bank offers, use get_bank_rates. Current NBP policy rates (reference, lombard, deposit, rediscount, discount) with the date of the last change, or the history of one rate. WIBOR and POLSTR are not available (GPW Benchmark license).
Inputs: days, rate. Returns: url, asOf, data, title, +9 more
get_investment_fundsInvestment funds in Poland (IZFiA)ARead-onlyIdempotentInspect
Use for investment fund assets and net flows: equity, bond, mixed and PPK funds. Assets, purchases of units, redemptions and net flows of investment funds in Poland from monthly IZFiA data: whole market, fund groups (short-term bond, bond, equity, mixed, PPK, target date, absolute return, commodity, crypto assets, private market) with IZFiA profiles, bond funds by type, equity funds by region, net flows since January and over 12 months, and the finwire index finwire_fund_flows_index (12-month net flows as % of assets a year earlier). Amounts in PLN million. Informational data, not investment advice.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_lead_forecastsfinwire lead forecasts: core inflation and impaired loansARead-onlyIdempotentInspect
Use for core inflation in 6-12 months and for impaired (Stage 3) housing and consumer loans in 2-4 quarters. Give the 80% interval and the backtest coverage. If published is false, there is no forecast to give. Two finwire.pl models with 80% intervals. finwire_cost_pressure (Presja kosztowa finwire): NBP core inflation y/y in 6 and 12 months from a unit labour cost proxy, producer prices and the EUR/PLN change. finwire_npl_forecast (Stres kredytowy wyprzedzający finwire): share of impaired (IFRS 9 Stage 3, KNF) housing and consumer loans in 2 and 4 quarters from the WIBOR 3M change, unemployment and the portfolio trend. A forecast is shown only when at least 70% of actual readings fell inside the 80% interval in the rolling backtest; otherwise published is false and only the accuracy statistics are given. A model estimate, not investment advice.
Inputs: index. Returns: url, asOf, data, title, +9 more
get_legal_changesLaw changes radarARead-onlyIdempotentInspect
Use for new laws and for the next PIT, ZUS and VAT deadlines. For the full yearly calendar of a business, use get_compliance_calendar. Acts of the Journal of Laws and Monitor Polski on personal finance, tax, labour and housing: entering into force soon and recently, with plain-language summaries, plus bills in the Sejm. Also returns the next 30 days of the finwire legal calendar (series finwire_legal_calendar): PIT, ZUS and VAT deadlines, IKE/IKZE year end, value changes, RPP meetings and bond sales.
Inputs: days, limit, topic. Returns: url, asOf, data, title, +9 more
get_legal_limitsLegal limits and tax valuesARead-onlyIdempotentInspect
Use for statutory values of this year: IKE and IKZE limits, PIT and minimum wage. For next year, use get_next_year_limits (property tax: get_property_tax_next_year). Statutory values for the current year: IKE and IKZE contribution limits, PIT thresholds and rates, tax-free amount, capital gains tax, rental flat-rate tax, minimum wage and other limits; topic "local-tax" gives the upper limits of local property tax rates. Company tax regimes (CIT, Estonian CIT, IP Box) and business rules: get_business_guide.
Inputs: topic. Returns: url, asOf, data, title, +9 more
get_macro_calendarUpcoming macro releasesARead-onlyIdempotentInspect
Use for the dates of the next macro releases and RPP meetings. For tax deadlines, use get_legal_changes or get_compliance_calendar. Upcoming Polish macro releases and decisions (RPP rate decisions, CPI, wages, GDP, industrial output) with date, time and importance (higher is more important). Dates marked tentative may move.
Inputs: limit. Returns: asOf, count, events, source, +3 more
get_macro_changesWhat changed recentlyARead-onlyIdempotentInspect
Use when the user asks what is new in macro data. Indicators whose reading was updated in the last N days (newest first), with the change against the previous reading.
Inputs: days. Returns: asOf, days, count, source, +4 more
get_macro_indicatorOne macro indicator with historyARead-onlyIdempotentInspect
Use for the value, the meaning or the trend of one macro indicator. One indicator by key with its meaning, latest reading, freshness, next release and history (oldest first) with min and max over the window.
Inputs: key (required), from. Returns: asOf, source, docsUrl, history, +3 more
get_macro_snapshotPolish economy snapshotARead-onlyIdempotentInspect
Use for a general view of the Polish economy or a briefing. For one indicator, use get_macro_indicator. Returns the six headline indicators (GDP, inflation, unemployment, wages, rates and similar) with latest reading, change and freshness, which indicators changed recently, and the next releases and RPP meetings.
Inputs: no named parameters. Returns: asOf, source, docsUrl, citation, +4 more
get_municipal_budgetBudget of a Polish municipality: spending, debt, EU fundsARead-onlyIdempotentInspect
Use for the budget of one municipality: what it spends money on, its debt and its EU funds. Pieniądze Twojej gminy (finwire_gmina_spending_per_capita): for one Polish municipality (gmina) or city with county rights - executed spending per resident by category (schools, social help, family benefits and nurseries, roads, waste and water, administration, culture, sport, municipal housing, fire brigades, interest on debt) vs neighbouring municipalities, municipalities of similar type and size and Poland (Ministry of Finance Rb-28S, last full year and current year to date), investment share, debt per resident at the end of the latest quarter (Rb-Z), EU funding per resident 2021-2027 and 2014-2020 with the largest projects (only projects located in one municipality; natural persons are not named). Without a municipality: national figures; with metric: ranking.
Inputs: family, metric, municipality. Returns: url, asOf, data, title, +9 more
get_new_companiesNew companies in Poland (KRS and CEIDG)ARead-onlyIdempotentInspect
Use for how many new companies (sp. z o.o., S.A., partnerships) are registered in KRS each month and for all new firms in Poland together with sole proprietorships. For closures and suspensions of sole proprietorships, use get_business_registrations. New commercial companies entered in the Polish National Court Register (KRS) each month by legal form (limited liability, simple joint-stock, joint-stock, partnerships), counted by finwire.pl from the Ministry of Justice KRS API (daily bulletin and current extracts), with applications to register a sole proprietorship in CEIDG (MRiT) for the same month, the share of companies among new firms, the current month so far against the same days a year earlier and the finwire index finwire_new_companies_pulse (new sole proprietorships plus new companies, % year on year).
Inputs: history. Returns: url, asOf, data, title, +9 more
get_next_year_limitsNext-year statutory limits from legal formulasARead-onlyIdempotentInspect
Use for next-year pension indexation, minimum wage, IKE and IKZE limits and ZUS bases before the official announcement. Tell the user that this is a formula estimate. Give the interval and the stage. Statutory values for the next year computed by finwire.pl from the formulas in Polish law on the latest GUS and NBP data, before the official act (finwire_next_year_limits): pension indexation and minimum pension, minimum wage and hourly rate (statutory minimum rise), projected average wage, IKE and IKZE limits, the 30x ZUS cap, ZUS contribution bases, flat-rate tax and small CIT taxpayer limits. Each item: value, 80% interval, stage (projekcja = estimate, projekt, obwieszczenie = announced, obowiazuje = in force), calculation and backtest accuracy. Present estimates as estimates; for values in force this year use get_legal_limits.
Inputs: key. Returns: url, asOf, data, title, +9 more
get_nowcastFinwire Nowcast: inflation and RPP forecastsARead-onlyIdempotentInspect
Use for the next CPI or core inflation value and the next RPP decision. Tell the user that this is a model estimate. Give the interval or the probabilities, and the accuracy. For past accuracy, prefer the live track record over the backtest. Write the source as "Finwire Nowcast (finwire.pl)". Finwire Nowcast (finwire id: finwire_nowcast), the finwire.pl statistical model of the next official readings: CPI inflation y/y and core inflation y/y (point and 80% interval) and probabilities of a cut, no change or hike at the next RPP (Monetary Policy Council) meeting. Recomputed daily, frozen 3 working days before publication, then settled against the actual reading; with backtest accuracy vs naive benchmarks and the live track record (each forecast published before the reading vs the first official reading). A model estimate, not a consensus and not investment advice.
Inputs: history, indicator. Returns: url, asOf, data, title, +9 more
get_oecd_comparisonPoland vs OECD countries: pension replacement rates and tax wedge (OECD)ARead-onlyIdempotentInspect
Use to compare Polish pensions (replacement rate) or labour taxes (tax wedge) with OECD countries, also countries outside the EU such as the United States, the United Kingdom or Japan. For the tax wedge in EU countries, use get_eu_earnings. For a pension forecast by birth year, use get_pension_forecast. OECD comparative data. Pension replacement rates from Pensions at a Glance: first pension as % of individual earnings before retirement, net and gross, men and women, average wage, full career from age 22, mandatory schemes, for Poland, the OECD average and every country of the OECD comparison, with the rank of Poland and finwire_oecd_pension_gap (Poland minus the OECD average, percentage points). Tax wedge from Taxing Wages: income tax plus employee and employer social contributions as % of total labour costs for six household profiles in every OECD country (also outside the EU: United States, United Kingdom, Japan, Canada, Switzerland, Norway), history of Poland and the OECD average since 2000, and finwire_oecd_tax_wedge_gap. For the tax wedge in EU countries from Eurostat use get_eu_earnings. For a pension forecast for a birth cohort use get_pension_forecast.
Inputs: topic, profile. Returns: url, asOf, data, title, +9 more
get_parking_pricesParking space prices from developer price lists (dane.gov.pl)ARead-onlyIdempotentInspect
Use for the price of a parking space, a garage space or a storage room from developers in a Polish city, and how it compares with the price of 1 m2 of a new flat. Say that these are asking prices from developer price lists and give the week. Asking prices of parking spaces sold by housing developers in Poland, from the daily price-list files on dane.gov.pl (act on transparency of new-flat prices). Weekly median, quartiles and counts of single parking spaces for Poland and cities above the publication threshold, underground or garage-hall vs outdoor vs garage, storage rooms and bike boxes, how many square metres of a new flat in the same city one space costs, change vs 4 weeks earlier and a weekly trend. Finwire index finwire_dev_parking_price.
Inputs: city, weeks. Returns: url, asOf, data, title, +9 more
get_pension_earning_limitsPension earning limits in Poland: how much a pensioner can earn (ZUS)ARead-onlyIdempotentInspect
Use for how much a pensioner or a disability pensioner can earn without a cut of the benefit in Poland, the 70% and 130% thresholds and their dates, and the reduction for a given income. Give ZUS as the source and say when a value is a finwire estimate before the ZUS announcement. Income thresholds for working pensioners in Poland (art. 104 of the act on pensions from FUS): above 70% of the average wage for the quarter the benefit is reduced by the excess, up to the maximum reduction; above 130% it is suspended. Old-age pensioners after the statutory retirement age (60 women, 65 men) have no limit. Current and next thresholds with dates, ZUS announcement or a finwire estimate from the GUS announcement before it, maximum reductions, annual thresholds and history. Optional check of one month: benefit type, benefit and income give the reduction.
Inputs: income, benefit, quarters, benefit_type, +1 more. Returns: url, asOf, data, title, +9 more
get_pension_forecastPension forecast finwire (future ZUS pension)ARead-onlyIdempotentInspect
Use for the future ZUS pension of a person and the replacement rate by birth year, sex and wage. For pensions paid now, use get_pension_stats. Model of the first gross ZUS pension in Poland (finwire_pension_forecast) by birth year 1966-2006, profile (k60 = woman retiring at 60, k65 = woman at 65, m65 = man at 65) and wage level (minimalna = minimum wage, mediana = median wage, przecietna = average wage, dwukrotnosc = twice the average): replacement rate vs own last gross wage and vs the average wage, pension in today's money (rate x today's average wage), P10/P50/P90 from thousands of simulations of wage growth and the number of workers. Built from the statutory indexation of the ZUS account and subaccount (real history since 2000), Eurostat EUROPOP working-age population and life expectancy, the GUS life table and Ministry of Finance wage assumptions; with the effect of the shrinking workforce and of longer life, and OECD and European Commission benchmarks. Without arguments returns the headline (man, average wage, retiring 30 years after the base year). Full career from age 22; a model, not an individual ZUS statement.
Inputs: profile, threshold, birth_year. Returns: url, asOf, data, title, +9 more
get_pension_statsAverage ZUS pension and benefitsARead-onlyIdempotentInspect
Use for the average ZUS pension paid now, disability and survivor pensions, and sickness allowances. For a future pension, use get_pension_forecast. Average old-age pension paid by ZUS (gross and net), disability and survivor pensions, number of pensioners, sickness and maternity allowances, the pension to wage ratio finwire_pension_wage_ratio, CPI, minimum pension and indexations, monthly from preliminary ZUS data (without KRUS and uniformed services).
Inputs: history. Returns: url, asOf, data, title, +9 more
get_pension_systemsAverage pension: ZUS vs KRUSARead-onlyIdempotentInspect
Use to compare the average ZUS pension with the average KRUS farmer pension, by year and province. For the latest monthly ZUS pension, use get_pension_stats. Average monthly gross old-age pension from ZUS and average pension and disability benefit of farmers from KRUS (GUS BDL; KRUS figure covers both): yearly since 1999 for Poland and 16 provinces, the latest year-to-date period with the previous year, gap in PLN and KRUS as % of ZUS. For the latest monthly ZUS pension, use get_pension_stats.
Inputs: no named parameters. Returns: url, asOf, data, title, +9 more
get_pit_settlement_statsPIT settlement in Poland by tax year (Ministry of Finance)ARead-onlyIdempotentInspect
Use for how many people in Poland settle PIT, how many are in the second tax bracket and what share of tax they pay, how many use child relief, IKZE or other reliefs, overpayments, flat tax and lump-sum tax returns. For PIT by municipality, use get_regional_data. For tax rates and limits, use get_legal_limits. National statistics of the annual PIT settlement from the yearly Ministry of Finance information (every tax year since 2019): taxpayers on the tax scale, returns by form (PIT-36, PIT-36L, PIT-37, PIT-38, PIT-39, PIT-28 lump-sum), taxpayers in the first and second bracket with the threshold and the second bracket share in tax due, reliefs deducted from income (IKZE, thermal modernisation, internet, rehabilitation, donations, trade union dues) with taxpayers, amount and average, child relief (taxpayers, children, amount), overpayments in returns, flat tax, capital gains and crypto income, and the finwire index finwire_pit_top_bracket_multiplier. Optional year selects one tax year. For PIT by municipality use get_regional_data; for tax rates and limits use get_legal_limits.
Inputs: year. Returns: url, asOf, data, title, +9 more
get_poland_forecastsForecasts for Poland: European Commission, OECD, NBP, Finwire NowcastARead-onlyIdempotentInspect
Use for forecasts of GDP growth, inflation, unemployment, deficit and public debt of Poland for this and next year from the European Commission, OECD and NBP, how forecasts changed and which institution was most accurate. Say which institution and edition each number comes from and that these are forecasts, not finwire.pl advice. For the next CPI reading or RPP decision, use get_nowcast. Latest edition of every institution with forecasts of real GDP growth, annual average inflation (European Commission: HICP; NBP, OECD and Finwire Nowcast: CPI), unemployment (LFS), general government balance and debt as % of GDP for the current and next years, the previous edition, outturns, mean forecast errors of each institution (forecasts made a year earlier) and the finwire index finwire_forecast_accuracy. Every edition is stored separately (European Commission since spring 2011). Finwire Konsensus is included only for indicators where it beat the best single institution in the backtest. Optional year selects the target year in the summary.
Inputs: year. Returns: url, asOf, data, title, +9 more
get_ppk_statsPPK (Employee Capital Plans) statisticsARead-onlyIdempotentInspect
Use for PPK workplace pensions: participants, participation rate, net assets, average account and fees. PPK (Pracownicze Plany Kapitałowe), the Polish auto-enrolment workplace pension programme, from the monthly PFR Portal PPK bulletin (PPK Register kept by PFR): net assets of target date funds, active accounts, participants, employers running PPK, participation rate, average management fee, number of financial institutions and finwire_ppk_avg_account (Średnie konto PPK finwire: net assets per active account), with monthly history.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_property_tax_next_yearNext-year property tax limitsARead-onlyIdempotentInspect
Use for the property tax on a flat or a house next year: the highest rate a municipality can set per m², before and after the Minister of Finance announcement. Tell the user the stage; an estimate is not an official value. The municipality sets its own rate up to this limit. Upper limits of the local property tax for the next year (finwire_property_tax_cap), per m² of a flat or house and for the other 8 categories of art. 5 ust. 1 of the local taxes act, from the formula in art. 20: this year limit x GUS CPI index for the first half-year, rounded up to full grosz. Stage: szacunek (estimate from monthly CPI, with 80% interval), wskaznik_gus (final figure from the GUS notice), obwieszczenie (announced by the Minister of Finance), obowiazuje (in force). Optional m2 gives the yearly maximum tax for a flat of that size. Municipalities set their own rates up to these limits; for this year limits use get_legal_limits with topic local-tax.
Inputs: m2. Returns: url, asOf, data, title, +9 more
get_public_debtPolish public debt and state budgetARead-onlyIdempotentInspect
Use for public debt, State Treasury debt, debt per person and the budget deficit. For EU countries, use get_eu_public_debt. State Treasury debt of Poland at the end of the latest month (Ministry of Finance): amount, change, debt per resident finwire_public_debt_per_capita, average growth per second over 12 months, domestic/foreign and retail bonds; national public debt and general government debt % of GDP (quarterly); state budget deficit cumulative from January with the plan from the budget act and the same period a year earlier.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_rate_riskMortgage payment risk and fixed-rate premiumARead-onlyIdempotentInspect
Use when the user asks if a mortgage payment will rise. Also use for the payment in a year and the fixed against variable rate premium. finwire model on WIBOR fixings and bank offers: finwire_rate_risk_gauge (Ryzyko raty finwire) - chance that the payment of a PLN 400,000, 30-year variable-rate mortgage rises by more than 5% or 10% (or falls by more than 5%) in 3, 6 and 12 months, with the 10th/50th/90th percentile of the payment and backtest accuracy since 2008 (80% interval coverage); finwire_fixed_rate_premium (Premia za stałą stopę finwire) - the typical 5-year fixed rate minus the expected cost of the variable rate over 5 years, in pp, daily and monthly (ECB MIR), with windows of a negative premium. A model estimate, not a certainty and not advice.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_regional_dataRegional data: income, unemployment, wagesARead-onlyIdempotentInspect
Use for data about municipalities and provinces: income, PIT, local tax, unemployment and wages. For the budget of one municipality, use get_municipal_budget. Regional data: "income" (residents income per capita by municipality, or county with level "powiat"), "pit" (PIT due per resident from tax returns by municipality and province, by type of return, PIT-38 capital gains returns per 1000 residents, finwire_pit_per_capita; with name = one municipality year by year), "local-tax" (finwire_local_tax_squeeze: property tax as % of property tax + PIT share in municipal budget plans, provinces, cities, municipalities in the squeeze, upper limit of the property tax rate for flats; with name = matching municipalities), "unemployment" (registered unemployment by province), "wages" (average wage by province). Filter by name.
Inputs: topic (required), name, year, level, +1 more. Returns: url, asOf, data, title, +9 more
get_rentsRents and rental yieldARead-onlyIdempotentInspect
Use for rents and rental yield. Asking rents (median, per m², month-over-month change) in Polish cities and districts, with gross and net rental yield and payback period.
Inputs: city. Returns: url, asOf, data, title, +9 more
get_retail_pricesRetail prices in shops (GUS)ARead-onlyIdempotentInspect
Use for prices in shops, for example butter, bread or milk, and for the shopping basket. Average retail prices of 30 goods and services in Poland from GUS (bread, butter, milk, eggs, meat, vegetables, sugar, electricity, gas, heating, petrol, diesel, bus ticket, taxi, haircut, doctor visit, cinema) for the latest month, with change vs the previous month and the same month a year earlier and the minutes of work each costs at the average net wage; plus the finwire shopping basket of 10 staple foods (finwire_shopping_basket_index).
Inputs: product. Returns: url, asOf, data, title, +9 more
get_rkm_price_limitsPrice limits per m2 in the family housing loan (BGK)ARead-onlyIdempotentInspect
Use for the maximum price per m2 in the family housing loan without down payment (rodzinny kredyt mieszkaniowy, BGK guarantee) in a city or voivodeship, and to check if a flat qualifies. Give BGK as the source and the quarter. Maximum price per m2 of a flat that can be bought with the Polish family housing loan (rodzinny kredyt mieszkaniowy, "Mieszkanie bez wkładu własnego": mortgage without down payment, BGK guarantees the missing part), from the quarterly lists of Bank Gospodarstwa Krajowego based on voivode announcements. 52 locations: each voivodeship city, the municipalities bordering it and all other municipalities. Two limits: first buyer from the developer and secondary market or cooperative right. Gives change vs previous quarter and year, history, an optional check of a price per m2 against the limit, and the finwire index finwire_rkm_offer_fit (share of developer price-list flats in voivodeship cities within the limit). Attribution to BGK is mandatory (not CC BY).
Inputs: market, location, quarters, price_per_m2. Returns: url, asOf, data, title, +9 more
get_savings_bond_salesRetail savings bond sales in Poland (Ministry of Finance)ARead-onlyIdempotentInspect
Use for how many savings bonds people buy in Poland, which series sell best, the sum since January against earlier years, IKE and IKZE purchases and buyer age. For bonds against deposits, use get_retail_bond_premium. For the rate in the next interest period, use get_bond_next_rate. Retail savings bonds of the State Treasury sold in Poland per month, from the Ministry of Finance statistics on gov.pl (since January 2015): the latest month in PLN with month-on-month and year-on-year change, the share and amount of every series (OTS, ROR, DOR, TOS, COI, EDO, family ROS and ROD), money from the exchange of maturing bonds and new money, purchases on IKE and IKZE retirement accounts, sales channels, buyer age (natural persons), the sum since January with the rank against the same months of every year, the best month and year, and the finwire index finwire_savings_bond_sales (sales in the 12 months, PLN billion). For interest rates of the current issue use get_retail_bond_premium or get_bank_rates.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_statutory_interestStatutory interest ratesARead-onlyIdempotentInspect
Use for statutory, late payment, maximum, tax arrears and B2B invoice interest rates in Poland. For NBP rates only, use get_interest_rates. Polish interest rates set by law from NBP rates: statutory (capital) and late payment interest (Civil Code), maximum interest, interest on tax arrears with the reduced rate (Tax Ordinance), late payment interest in commercial transactions (B2B invoices). Each rate has the date from which it applies and the next rate (announced after an RPP decision, or the B2B rate for the next half-year: settled or a finwire.pl estimate).
Inputs: no named parameters. Returns: url, asOf, data, title, +9 more
get_subsidy_statsCzyste Powietrze subsidy programme statisticsARead-onlyIdempotentInspect
Use for Czyste Powietrze heating subsidies: applications, contracts and payments. Czyste Powietrze (Clean Air), the Polish subsidy programme for replacing heating sources and thermal modernisation of single-family houses, from the weekly NFOŚiGW summary: applications, contracts and paid subsidies cumulative (all editions and the Modernisation Fund edition), last week, completed contracts, bank loan grants, requested heat sources by type, the payout queue (contracted but not yet paid) with weekly pace, and finwire_clean_air_payout_rate (paid as % of contracted). National data only.
Inputs: history. Returns: url, asOf, data, title, +9 more
get_tax_rulingsTax rulings on personal financeARead-onlyIdempotentInspect
Use for individual tax rulings by topic, for example rental income, crypto or IKE and IKZE. Individual tax rulings of the Polish tax information office (KIS) and municipal rulings on property tax, published in the EUREKA database of the Ministry of Finance, by topic: private rental (najem_prywatny), selling a flat and the housing relief (sprzedaz_nieruchomosci), IKE/IKZE (ike_ikze), crypto (kryptowaluty), shares, funds and dividends (inwestycje_pit38), sole proprietorship, lump-sum tax and IP Box (jdg_ryczalt), PIT reliefs (ulgi_pit), property tax (podatek_od_nieruchomosci). Returns counts per full week (series finwire_tax_rulings_pulse), provisions cited most often in the last 52 weeks and the newest rulings with signature, authority, dates, shortened thesis and a link to the full text. A ruling answers one taxpayer about their own case; it is not legal advice.
Inputs: limit, topic. Returns: url, asOf, data, title, +9 more
get_tax_treatyTax on profit paid from Poland to another countryARead-onlyIdempotentInspect
Use for tax on dividends, interest or royalties paid abroad. Also use for the countries that invest the most in Poland (NBP data). Give the legal basis and the verification date of each fact. Polish withholding tax on dividends, interest and royalties paid to a resident of a country: the statutory rate, the rate in the double tax treaty with Poland (portfolio and qualified holding), whether MLI modifies the treaty, and the EU/EEA/Swiss parent-subsidiary exemption with its holding conditions. Covers the largest investor countries by NBP data; without country returns the list and the ranking.
Inputs: lang, country. Returns: url, asOf, data, title, +9 more
get_tourism_pressureTourism pressure in Polish municipalities (finwire_tourism_pressure)ARead-onlyIdempotentInspect
Use for tourism in a Polish municipality, county or province: bed places per 1000 residents, nights spent, tourists, bed occupancy by month, and where short-term rental pressure is highest. Presja turystyczna finwire (finwire_tourism_pressure) from Statistics Poland (GUS BDL): bed places in tourist accommodation on 31 July per 1000 residents for Poland and each municipality with its rank; nights spent and tourists per year (Poland, provinces, counties, nights per resident), nights and bed occupancy rate per month (Poland, provinces). With q: municipalities matching the name, with the county nights per resident. GUS has no nights for municipalities after 2014.
Inputs: q. Returns: url, asOf, data, title, +9 more
get_vehicle_registrationsVehicle registrations in Poland (Ministry of Digital Affairs, CEPiK)ARead-onlyIdempotentInspect
Use for car registrations, car brands and Chinese car brands. First registrations of vehicles in Poland, monthly since 2014, from the Ministry of Digital Affairs files with CEPiK data: passenger cars and all vehicles, 17 vehicle types, provinces per 1000 residents, top passenger-car brands of the month and of 12 months (nationwide or one province) and the share of brands from China by province, with the finwire indices finwire_car_registrations_pulse (12-month passenger cars, change year on year) and finwire_chinese_brands_share. A first registration in Poland covers new cars and used cars imported from abroad. Months with an inconsistent province or type split are held back and listed. For electric cars use get_electric_vehicles.
Inputs: period, history, province. Returns: url, asOf, data, title, +9 more
get_world_comparisonPoland compared with the world (BIS, OECD): central bank rates, house prices, credit cycle, Finwire HousecastARead-onlyIdempotentInspect
Use for Poland against other countries: central bank rates and the NBP rate rank, real house prices abroad, price to income or rent, credit gap, and whether Polish housing is overvalued (Finwire Housecast). Say that a forecast is a model estimate. Poland against other countries from the BIS (Bank for International Settlements) and the OECD. topic policy_rates: central bank policy rates of BIS economies, the place of the NBP rate (finwire_policy_rate_rank, 1 = highest rate) nominal and real (rate minus annual CPI inflation), median, rank history, real effective exchange rate of the zloty. topic house_prices: real and nominal annual change of residential property prices by country with the place of Poland, and price-to-income and price-to-rent ratios of Poland and the OECD average. topic credit_cycle: credit-to-GDP gap of Poland and the debt service ratio of the private non-financial sector (no household-only ratio for Poland). topic housecast: Finwire Housecast (finwire_housing_valuation_gap), the housing valuation gap of Poland and panel countries and the model forecast of real house prices 4 and 8 quarters ahead; a horizon below the accuracy gate has no numbers.
Inputs: topic, country. Returns: url, asOf, data, title, +9 more
list_finwire_indicesfinwire index registryARead-onlyIdempotentInspect
Use for a list of all finwire indices (id finwire_*) with the latest values. Give the id and the method version from the citation field. All indices computed by finwire.pl, each under a stable id finwire_* (e.g. finwire_mortgage_barometer, finwire_credit_capacity_index, finwire_deposit_rate_index, finwire_savings_rate_index, finwire_rcn_price_index, finwire_price_gap_index, finwire_entry_threshold_index, finwire_credit_market_index, finwire_nowcast, finwire_legal_calendar): latest reading with its period, change vs the previous reading, method version and citation. Use get_finwire_index for one index with history.
Inputs: group, status. Returns: url, asOf, data, title, +9 more
list_macro_indicatorsList Polish macroeconomic indicatorsARead-onlyIdempotentInspect
Use first to find the key of a macro indicator. Then use get_macro_indicator with that key. Find indicators and their keys. Latest reading, change, next release and source for GDP, CPI and core inflation, unemployment, wages, retail sales, industrial output, NBP rates, FX, consumer sentiment, mortgage market and statutory limits. Filter by group or free text (Polish or English words, e.g. "inflacja", "wages"). Set include_descriptions to learn what each series measures when keys look alike (cpi-rr vs hicp-rr).
Inputs: group, query, include_descriptions. Returns: asOf, count, source, docsUrl, +3 more
plan_business_entryPlan entering Poland with a businessARead-onlyIdempotentInspect
Use when a person from abroad wants to start a business in Poland: available forms, taxes per form, steps and deadlines. Give the legal basis and the verification date of each fact. One call for someone from abroad starting a business in Poland: every legal form with available yes/no and the reason for their residence status, yearly taxes and net income to the owner for each available form (dividend tax at the tax-treaty rate of the owner country), setup steps, residence and identity requirements, and the deadline calendar for the form with the highest net income at these inputs. Facts carry the act, article, link and verification date.
Inputs: owner_status (required), yearly_revenue (required), lang, year, +5 more. Returns: url, asOf, data, title, +9 more
search_datasetsFind a datasetARead-onlyIdempotentInspect
Use when no other tool is applicable. Then use get_dataset with the id from the result. Catalog of all finwire.pl datasets (rates, FX, gold, fuel and energy prices, Finwire Nowcast, broker fees, housing prices and rents, credit market, legal limits and law changes, regional income, Europe) with the best tool to call, its parameters, license and finwire.pl page.
Inputs: query, category. Returns: count, citation, datasets, serverDate
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Official Polish central bank (NBP) exchange rates, currency conversion and gold prices.
Polish real-estate deed prices and parcel checks: zoning plan, utilities, flood risk
Polish gold/silver bullion dealer: live PLN prices, stock, buyback prices, guides. Read-only.
Polish savings bonds, retail bonds in 195 countries, EU bank account bonuses. Open data, CC BY 4.0.
Related MCP Servers
AlicenseAqualityBmaintenance7M+ real estate transactions from Poland's RCN registry. Search, compare, and analyze prices3072 npm1MIT- AlicenseAqualityCmaintenanceEnables AI assistants to query real Polish real-estate transaction prices for flats, houses, and building plots from the official notarial registry. It returns median price per square meter, price ranges, room breakdowns, market type, yearly trends, and recent sales within a radius of any Polish address, street, town, or coordinates.481 npmMIT
- AlicenseNot gradedqualityBmaintenanceYour AI agent's practical guide to life and administration in Poland.MIT
- AlicenseAqualityDmaintenanceProvides AI agents with real-time access to Polish official data: VAT whitelist for company verification and NBP exchange rates, enabling checks on VAT status, company details, and currency conversion without API keys.5MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.