Darmowe, publiczne API z polskimi danymi finansowymi: stopy NBP, inflacja GUS, ceny transakcyjne mieszkań z aktów notarialnych, czynsze, rentowności obligacji, kalendarz makro oraz autorskie wskaźniki finwire. REST, format JSON, bez klucza i bez rejestracji. Te same dane, które zasilają kalkulatory i Decyzjomaty na finwire.pl.
Wyślij zapytanie GET na adres bazowy https://public-api.finwire.pl. Nie potrzebujesz klucza ani nagłówka autoryzacji. Każdy endpoint zwraca JSON z aktualnymi danymi oraz informacją o źródle i dacie odczytu. Pełną strukturę odpowiedzi opisuje interaktywna referencja.
curl -s https://public-api.finwire.pl/v1/snapshot Przykład pobiera pełny snapshot rynku. Aby pobrać pojedynczą serię, zamień ścieżkę, np. /v1/series/interest-rate (stopy NBP) lub /v1/index/credit-stress (mapa stresu kredytowego).
API udostępnia 18 zbiorów danych w pięciu obszarach. Stopy i ceny pochodzą z oficjalnych źródeł (NBP, GPW Benchmark, GUS, MF), a wskaźniki finwire to autorskie metryki liczone na tych danych.
/v1/series/interest-rateNBP/v1/bondsdetaliczne (OTS, DOS, COI, EDO, ROR, ROD) - MF/v1/series/bond-yieldsPolska, Niemcy, strefa euro, UE + spready - Eurostat/v1/legal-limitsIKE, IKZE i powiązane (aktualizacja roczna)/v1/legal-limits/local-taxgórne granice stawek na kolejne lata - MF/v1/series/cpiGUS (miesięczna i roczna)/v1/series/fxtabela NBP + historia per waluta/v1/series/housingGUS, 17 miast, ostatnie kwartały/v1/wagesGUS: mediana, percentyle, średnie wojewódzkie/v1/wages/occupationsGUS: średnia, mediana, decyle, luka płacowa/v1/series/unemploymentGUS: kraj, województwa, powiaty, historia od 2011/v1/housing/transactionsRCN (akty notarialne): mediana, kwartyle, 17 miast/v1/housing/transactions/{city}RCN: mediana m² z 12 miesięcy per dzielnica/v1/rentczynsze ofertowe w miastach i dzielnicach - znajdznajem.pl/v1/rent/yieldbrutto, netto i okres zwrotu per miasto/v1/housing/supplyGUS: mieszkania na 1000 osób, oddane, pozwolenia, migracje/v1/calendardecyzje RPP, odczyty CPI, płac, PKB (GUS, NBP)/v1/index/credit-stressrata jako % pensji netto w 16 województwach/v1/index/entry-thresholdile brutto trzeba zarabiać na kredyt na mieszkanie w 17 miastach/v1/index/{slug}wskaźnik miesięczny/v1/index/{slug}metraż możliwy do sfinansowania/v1/index/{slug}realna wartość pieniądza vs inflacja/v1/index/{slug}lokaty po inflacji/v1/index/{slug}wskaźnik kosztu hipoteki/v1/market/deposit-ratesmediana i percentyle oprocentowania/v1/market/savings-ratesmediana i percentyle/v1/market/mortgage-ratesmediana RRSO, marża, oprocentowanie nominalne/v1/market/cash-loan-ratesmediana RRSO i oprocentowanie nominalne/v1/snapshotstopy, inflacja, kursy, stres kredytowy, barometry Wszystkie endpointy są wersjonowane prefiksem /v1 i obsługują metodę GET. Adres bazowy: https://public-api.finwire.pl.
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /v1/snapshot | Pełny stan rynku jednym zapytaniem |
| GET | /v1/series/interest-rate | Tabela bieżących stóp NBP |
| GET | /v1/series/interest-rate/{indicator} | Historia stopy NBP (np. stopa-referencyjna) |
| GET | /v1/series/cpi | Inflacja CPI (type=monthly lub yearly) |
| GET | /v1/series/fx | Tabela bieżących kursów walut NBP |
| GET | /v1/series/fx/{code} | Historia kursu waluty (np. EUR, USD, CHF) |
| GET | /v1/series/bond-yields | Rentowności 10-letnich obligacji: PL, DE, strefa euro, UE + spready |
| GET | /v1/series/bond-yields/{geo} | Miesięczna historia rentowności (PL, DE, EA, EU27_2020) |
| GET | /v1/series/housing | Ceny mieszkań GUS w 17 miastach |
| GET | /v1/series/housing/{city} | Ceny w mieście z ostatnich kwartałów (np. warszawa, krakow) |
| GET | /v1/housing/transactions | Ceny transakcyjne RCN: mediana i kwartyle m² w 17 miastach |
| GET | /v1/housing/transactions/{city} | Ceny transakcyjne RCN w dzielnicach miasta |
| GET | /v1/rent | Czynsze ofertowe w miastach |
| GET | /v1/rent/{city} | Czynsze w mieście z podziałem na dzielnice |
| GET | /v1/rent/yield | Rentowność najmu brutto i netto |
| GET | /v1/calendar | Najbliższe decyzje RPP i odczyty GUS |
| GET | /v1/series/unemployment | Bezrobocie: Polska i 16 województw |
| GET | /v1/series/unemployment/counties | Powiaty z najniższym i najwyższym bezrobociem |
| GET | /v1/series/unemployment/history | Historia bezrobocia od 2011 (kraj lub województwo) |
| GET | /v1/wages/occupations | Wynagrodzenia według zawodów (GUS) |
| GET | /v1/wages/occupations/{code} | Jedna grupa zawodów z historią edycji |
| GET | /v1/legal-limits/local-tax | Górne granice stawek podatku od nieruchomości |
| GET | /v1/housing/supply | Podaż mieszkań: Polska, województwa, 17 miast |
| GET | /v1/housing/supply/{city} | Podaż mieszkań w mieście na tle województwa |
| GET | /v1/index/entry-threshold | Próg wejścia: brutto potrzebne na kredyt w 17 miastach |
| GET | /v1/index/entry-threshold/history | Historia progu wejścia (singiel lub para) |
| GET | /v1/index | Lista wszystkich wskaźników finwire |
| GET | /v1/index/credit-stress | Mapa stresu: rata jako % pensji w 16 województwach |
| GET | /v1/index/{slug} | Pojedynczy wskaźnik finwire |
| GET | /v1/bonds | Oprocentowanie detalicznych obligacji skarbowych (MF) |
| GET | /v1/wages | Wynagrodzenia GUS: mediana, percentyle, średnie wojewódzkie |
| GET | /v1/legal-limits | Limity IKE, IKZE i wartości powiązane |
| GET | /v1/market/deposit-rates | Agregaty oprocentowania lokat terminowych |
| GET | /v1/market/savings-rates | Agregaty oprocentowania kont oszczędnościowych |
| GET | /v1/market/mortgage-rates | Agregaty kredytów hipotecznych (RRSO, marża) |
| GET | /v1/market/cash-loan-rates | Agregaty kredytów gotówkowych |
Trzy dodatkowe zasoby uzupełniają tę listę: /openapi.json (specyfikacja OpenAPI), /reference (Swagger UI) oraz /llms.txt (wersja dla modeli językowych).
Specyfikacja OpenAPI oraz wygenerowane z niej typy TypeScript są dostępne w publicznym repozytorium github.com/finwire-pl/api, aktualizowanym przy każdym wydaniu API. Możesz wygenerować własnego klienta z pliku https://public-api.finwire.pl/openapi.json w dowolnym języku.
Jeśli prowadzisz portal lub blog i chcesz osadzić gotowe narzędzie bez pisania kodu, skorzystaj ze strefy dla wydawców. Znajdziesz tam osadzalne kalkulatory oraz interaktywną mapę stresu kredytowego - jeden snippet, dane odświeżane automatycznie, z linkiem zwrotnym.
Dane są dostępne na licencji Creative Commons Uznanie autorstwa 4.0 (CC BY 4.0). Możesz je wykorzystywać, także komercyjnie, pod warunkiem wskazania autorstwa: Źródło: finwire.pl z linkiem do strony danych. Dane finansowe mają charakter informacyjny, finwire.pl nie jest licencjonowanym doradcą inwestycyjnym.