Darmowe, publiczne API z polskimi danymi finansowymi: stopy NBP, WIBOR i POLSTR, inflacja GUS, ceny mieszkań NBP BaRN, obligacje skarbowe 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, WIBOR, POLSTR) 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, WIBOR i POLSTR (GPW Benchmark)/v1/bondsdetaliczne (OTS, DOS, COI, EDO, ROR, ROD) - MF/v1/legal-limitsIKE, IKZE i powiązane (aktualizacja roczna)/v1/series/cpiGUS (miesięczna i roczna)/v1/series/fxtabela NBP + historia per waluta/v1/series/housingNBP BaRN, per miasto/v1/wagesGUS: mediana, percentyle, średnie wojewódzkie/v1/index/credit-stressrata jako % pensji netto w 16 województwach/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, WIBOR, POLSTR |
| GET | /v1/series/interest-rate/{indicator} | Historia wskaźnika (np. wibor-3m, nbp_rate, polstr-3m) |
| 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/housing | Lista miast z cenami mieszkań NBP BaRN |
| GET | /v1/series/housing/{city} | Historia cen w mieście (np. warszawa, krakow) |
| 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 |
Dodatkowo: /openapi.json (specyfikacja OpenAPI), /reference (Swagger UI), /llms.txt (wersja dla modeli językowych).
Specyfikacja OpenAPI oraz wygenerowane typy TypeScript i klient są dostępne w repozytoriach GitHub w organizacji finwire-pl. 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.