Zaloguj się
finwire Public API

API i dane finansowe dla developerów

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. Serwer MCP podłącza je do Claude, ChatGPT, Cursora i VS Code.

Dokumentacja APIReferencja (Swagger) GitHub
  • Bez klucza API
  • REST / JSON
  • CORS otwarty
  • OpenAPI 3
  • Licencja CC BY 4.0
  • Serwer MCP

Jak zacząć korzystać z API?

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).

Serwer MCP: dane finwire w Claude, ChatGPT i Cursorze

Dodaj serwer MCP https://public-api.finwire.pl/mcp jako konektor albo serwer HTTP w swoim asystencie, bez klucza i bez konta. Serwer ma 75 narzędzi do pytań o gospodarkę, ceny, mieszkania, kredyty, prawo i biznes w Polsce; odpowiedź podaje okres danych, źródło i link do finwire.pl.

Serwer MCP finwire: jak podłączyć i co potrafi

Jakie dane udostępnia finwire?

API udostępnia 99 zbiorów danych w 7 obszarach. Stopy i ceny pochodzą z oficjalnych źródeł (NBP, GUS, MF, Eurostat, akty prawne), a wskaźniki finwire to autorskie metryki liczone na tych danych.

Stopy i wskaźniki referencyjne

  • Stopy procentowe/v1/series/interest-rateNBP
  • Obligacje skarbowe/v1/bondsdetaliczne (OTS, DOS, COI, EDO, ROR, ROD) - MF
  • Rentowności obligacji 10-letnich/v1/series/bond-yieldsPolska, Niemcy, strefa euro, UE + spready - Eurostat
  • Limity prawne/v1/legal-limitsIKE, IKZE i powiązane (aktualizacja roczna)
  • Limity na przyszły rok (finwire_next_year_limits)/v1/legal-limits/next-yearwaloryzacja emerytur, płaca minimalna, prognozowane wynagrodzenie, IKE i IKZE, 30-krotność, podstawy ZUS i limity w euro z wzorów w ustawach, z przedziałem 80%, etapem aktu i backtestem
  • Podatek od nieruchomości/v1/legal-limits/local-taxgórne granice stawek na kolejne lata - MF
  • Radar zmian w prawie/v1/legal-changesakty z Dziennika Ustaw i Monitora Polskiego, projekty w Sejmie
  • Kalendarz zmian (finwire_legal_calendar)/v1/legal-calendarterminy PIT, ZUS i VAT, limity IKE/IKZE, wejście w życie aktów, posiedzenia RPP, sprzedaż obligacji; także ICS
  • Lista ostrzeżeń KNF (finwire_knf_warnings_monitor)/v1/knf-warningswpisy dosłownie z listy ostrzeżeń publicznych KNF, wyszukiwarka po nazwie, stronie, KRS, NIP i REGON, nowe wpisy w tygodniach
  • Lista gwarancji BFG (finwire_bfg_guarantee_monitor)/v1/bfg-guaranteebanki i SKOK-i z gwarancją Bankowego Funduszu Gwarancyjnego, historia listy od 2019, wyszukiwarka po nazwie i stronie, limit w zł po kursie NBP
  • Wyroki w sprawach kredytowych (finwire_borrower_win_share)/v1/credit-judgmentswyroki sądów powszechnych z Portalu Orzeczeń (przez SAOS): frankowe, WIBOR, sankcja kredytu darmowego, wcześniejsza spłata, polisolokaty; liczby w miesiącach, udział wyroków dla kredytobiorcy, instancje, najnowsze wyroki z linkiem
  • Interpretacje podatkowe (finwire_tax_rulings_pulse)/v1/tax-rulingsinterpretacje indywidualne KIS i gmin z bazy EUREKA Ministerstwa Finansów według tematów finansów osobistych, liczby w tygodniach, najczęstsze przepisy, linki do pełnej treści
  • Biznes w Polsce/v1/business-poland/plannetto z każdej formy pracy, JDG czy sp. z o.o., koszt pracodawcy, formy dostępne dla cudzoziemca, podatek u źródła wg umów, kalendarz terminów i zasady z podstawą prawną (ustawy w ELI)

Makroekonomia i ceny

  • Inflacja CPI/v1/series/cpiGUS (miesięczna i roczna)
  • Kursy walut/v1/series/fxtabela NBP + historia per waluta
  • Ceny mieszkań/v1/series/housingGUS, 17 miast, ostatnie kwartały
  • Wynagrodzenia/v1/wagesGUS: mediana, percentyle, średnie wojewódzkie
  • Wynagrodzenia według zawodów/v1/wages/occupationsGUS: średnia, mediana, decyle, luka płacowa
  • Bezrobocie/v1/series/unemploymentGUS: kraj, województwa, powiaty, historia od 2011
  • Wskaźniki makroekonomiczne/v1/macro/indicatorsGUS, NBP, Eurostat: ok. 40 serii z historią
  • Nastroje konsumentów/v1/macro/consumer-sentimentGUS: bieżący i wyprzedzający wskaźnik ufności
  • Przeciętne wynagrodzenie/v1/wages/enterpriseGUS: sektor przedsiębiorstw, kraj i województwa
  • Dochody gmin i powiatów/v1/income/municipalitiesMF i GUS: dochód mieszkańców na osobę
  • Podatek PIT w gminach i PIT na mieszkańca finwire/v1/pit/summaryMF: rozliczenia PIT w układzie terytorialnym (dane.gov.pl), GUS
  • Nożyce fiskalne gmin finwire/v1/local-tax-squeezeMF: podatek od nieruchomości i udział w PIT z planów budżetów gmin (Rb-27S), GUS
  • Nożyce fiskalne: każda gmina/v1/local-tax-squeeze/municipalitiesMF Rb-27S, GUS: zależność od podatku od nieruchomości per gmina
  • Budżety gmin: wydatki, dług, fundusze UE (finwire_gmina_spending_per_capita)/v1/jst-budget/municipalitiesMF: sprawozdania Rb-28S i Rb-Z, listy projektów z Funduszy Europejskich (dane.gov.pl), GUS; każda gmina, ranking i porównanie z sąsiadami
  • Cena złota/v1/series/goldNBP: cena 1 g i historia
  • Ceny maksymalne paliw/v1/fuel-pricesobwieszczenia Ministra Energii (Monitor Polski)
  • Ceny w sklepach i Koszyk zakupowy finwire/v1/prices/retailGUS, przeciętne ceny detaliczne towarów i usług (DBW)
  • Przeciętna emerytura i świadczenia ZUS/v1/pensionsZUS: miesięczna informacja o świadczeniach (dane wstępne), GUS
  • Prognoza emerytur finwire/v1/pension-forecastmodel finwire.pl z wskaźników waloryzacji ZUS, prognozy ludności EUROPOP2023 i rachunków narodowych Eurostatu, tablicy GUS i założeń Ministerstwa Finansów
  • Dzienny indeks cen finwire (eksperymentalny)/v1/daily-price-indexfinwire.pl z cen półkowych Frisco.pl, Rossmann.pl i sklep.stokrotka.pl, wagi i inflacja żywności GUS; bez cen produktów
  • Przeciętny Polak finwire/v1/average-poleEurostat, GUS, BIK, NBP, ZUS, Ministerstwo Cyfryzacji: mediany i średnie z okresem
  • Nowe i zamknięte firmy w CEIDG/v1/business-registrationsMRiT: wnioski złożone w CEIDG (dane.gov.pl)
  • Rejestracje pojazdów i marki samochodów/v1/vehicle-registrationsMinisterstwo Cyfryzacji: pierwsze rejestracje i marki osobowych (dane CEPiK, dane.gov.pl)
  • Samochody elektryczne w Polsce/v1/electric-vehiclesEurostat: nowe auta i park wg rodzaju energii; GUS BDL; UDT EIPA
  • Punkty ładowania samochodów elektrycznych/v1/ev-chargingUDT: Ewidencja Infrastruktury Paliw Alternatywnych (EIPA)
  • Wyszukiwarka ładowarek: moc, wolne teraz, cena za kWh/v1/ev-charging/chargersUDT: Ewidencja Infrastruktury Paliw Alternatywnych (EIPA), konto czytelnika
  • Ceny ładowania i Indeks cen ładowania finwire/v1/ev-charging/pricesUDT: Ewidencja Infrastruktury Paliw Alternatywnych (EIPA), konto czytelnika
  • Sieci ładowania: cenniki i Sprawność ładowarek finwire/v1/ev-charging/networksUDT: Ewidencja Infrastruktury Paliw Alternatywnych (EIPA), konto czytelnika
  • Obłożenie ładowarek finwire/v1/ev-charging/occupancyUDT: Ewidencja Infrastruktury Paliw Alternatywnych (EIPA), konto czytelnika
  • Przyrost ładowarek finwire: miesięcznie od 2019 r., dziennie wg mocy, regionu i sieci/v1/ev-charging/growthUDT: Ewidencja Infrastruktury Paliw Alternatywnych (EIPA), statystyka i konto czytelnika
  • Zasięg ultraszybkich ładowarek finwire/v1/ev-charging/coverageUDT: EIPA; GUS BDL; GUGiK PRG
  • Stacje CNG, LNG i wodoru z cenami/v1/ev-charging/gasUDT: Ewidencja Infrastruktury Paliw Alternatywnych (EIPA), konto czytelnika
  • Fundusze inwestycyjne: aktywa i saldo wpłat/v1/investment-fundsIZFiA: nabycia i umorzenia w funduszach inwestycyjnych
  • IKE i IKZE: konta, wartość środków i wpłaty/v1/ike-ikzeKNF: informacje o rynku IKE i IKZE (półrocznie)
  • Średnia składka OC i autocasco, Średnia składka OC finwire/v1/car-insuranceKNF: Biuletyn kwartalny. Rynek ubezpieczeń (część D)
  • Czyste Powietrze: wnioski, umowy i wypłaty/v1/subsidies/clean-airNFOŚiGW: Czyste Powietrze w liczbach
  • Premia obligacji skarbowych finwire/v1/retail-bond-premiumMF: listy emisyjne i zadłużenie SP; NBP: MIR i MIF; indeksy lokat i kont finwire
  • Cena węgla i opłata za odpady: Polska i 16 województw/v1/coal-waste-pricesGUS: Bank Danych Lokalnych, średnie roczne
  • Sezon grzewczy finwire: stopniodni, indeks chłodu, koszt sezonu/v1/heating-seasonIMGW-PIB (dane przetworzone), Eurostat, URE, GUS; Polska i 17 miast
  • Sztywne koszty gospodarstwa finwire/v1/fixed-cost-burdenGUS: wynagrodzenia, BDL, ceny transakcyjne; NBP: MIR; KRRiT; Polska i 16 województw
  • PPK w liczbach i Średnie konto PPK finwire/v1/ppkPFR Portal PPK: biuletyn miesięczny Pracowniczych Planów Kapitałowych
  • Dług publiczny i budżet państwa/v1/public-debtMinisterstwo Finansów: zadłużenie Skarbu Państwa, dług publiczny, szacunek wykonania budżetu; GUS, Eurostat
  • Ceny prądu i gazu w taryfach URE/v1/energy/regulated-pricesdecyzje Prezesa URE: G11, G12, G12w i W-1.1-W-4, stawki netto
  • Ceny prądu i gazu w UE/v1/europe/energy-pricesEurostat: 27 krajów UE w EUR i PPS, Polska w zł, Luka cen prądu Polska-UE finwire
  • PKB na mieszkańca w UE/v1/europe/gdp-per-capitaEurostat: 27 krajów UE w PPS i euro, spożycie, poziom cen, wzrost PKB w kwartale, Licznik doganiania UE finwire
  • Płaca minimalna w UE/v1/europe/minimum-wagesEurostat: ranking w EUR i PPS, stan na 1 stycznia i 1 lipca
  • Ceny paliw w UE/v1/europe/fuel-pricesKomisja Europejska (Weekly Oil Bulletin): 27 krajów UE tygodniowo w euro i zł, Luka cen paliw Polska-UE finwire
  • Inflacja w krajach UE (finwire_eu_inflation_gap)/v1/europe/inflationEurostat HICP: ranking 27 krajów, składowe, koszyk od wybranego roku, Luka inflacji Polska-UE finwire
  • Bezrobocie w krajach UE i Mnożnik bezrobocia młodych finwire/v1/europe/unemploymentEurostat: stopa bezrobocia miesięcznie, ogółem i do 25 lat, 27 krajów UE od 2010 r.
  • Zarobki netto w UE i Pensja w Polsce wobec średniej UE finwire/v1/europe/net-earningsEurostat: netto 7 typów gospodarstw w EUR i PPS, koszt godziny pracy, klin podatkowy, porównanie pensji w zł
  • Dług i deficyt w UE (finwire_eu_debt_threshold_gap)/v1/europe/public-debtEurostat: dług, deficyt i odsetki 27 krajów UE w % PKB, rocznie i kwartalnie, kraje ponad progami 3% i 60% PKB
  • Własne mieszkanie, poduszka finansowa i dochód gospodarstw w UE/v1/europe/living-conditionsEurostat, badanie EU-SILC: własne mieszkanie z kredytem i bez, najem, brak poduszki na nieoczekiwany wydatek, mediana dochodu na osobę w euro i PPS, 27 krajów UE od 2005 r.
  • Upadłości konsumenckie i Licznik upadłości konsumenckich finwire/v1/consumer-bankruptciesCOIG: upadłości konsumenckie na podstawie ogłoszeń w KRZ i MSiG (wykorzystanie z podaniem źródła)
  • Sprzedaż obligacji oszczędnościowych i Licznik obligacji oszczędnościowych finwire/v1/savings-bond-salesMinisterstwo Finansów: dane statystyczne sprzedaży obligacji oszczędnościowych (gov.pl, wykorzystanie z podaniem źródła)

Nieruchomości (bez pojedynczych aktów i ogłoszeń)

  • Ceny transakcyjne mieszkań/v1/housing/transactionsRCN (akty notarialne): mediana, kwartyle, 17 miast
  • Ceny w dzielnicach/v1/housing/transactions/{city}RCN: mediana m² z 12 miesięcy per dzielnica
  • Premia za okolicę finwire/v1/housing/location-premium/{city}RCN i ocena okolicy: cena dzielnicy wobec ceny oczekiwanej z jakości okolicy
  • Ceny mieszkań NBP od 2006/v1/housing/nbp/{city}NBP BaRN: ceny ofertowe i transakcyjne, rynek pierwotny i wtórny, 17 miast
  • Luka ofertowa według NBP/v1/housing/nbp-gapNBP BaRN: różnica cen ofertowych i transakcyjnych
  • Czynsze/v1/rentczynsze ofertowe w miastach i dzielnicach - znajdznajem.pl
  • Rentowność najmu/v1/rent/yieldbrutto, netto i okres zwrotu per miasto
  • Carry nieruchomości finwire/v1/housing/carrynajem netto minus oprocentowanie kredytu per miasto, miesięcznie
  • Podaż mieszkań/v1/housing/supplyGUS: mieszkania na 1000 osób, oddane, pozwolenia, migracje
  • Bilans mieszkaniowy finwire: presja demograficzna, prognoza podaży i czynszów/v1/housing/balanceGUS BDL, ZUS, GUNB RWDZ, ogłoszenia najmu, RCN, NBP; opracowanie finwire.pl
  • Koszty utrzymania mieszkania/v1/housing/upkeepczynsz administracyjny, ogrzewanie, media w 20 miastach
  • Mieszkania w Europie/v1/housing/europeEurostat: indeks cen, przeciążenie kosztami, przeludnienie

Kalendarz makro

  • Kalendarz ekonomiczny/v1/calendardecyzje RPP, odczyty CPI, płac, PKB (GUS, NBP)

Wskaźniki finwire

  • Indeksy finwire (rejestr finwire_*)/v1/finwire-index/{id}wszystkie indeksy finwire.pl: odczyt, zmiana, historia i formuła cytowania; stare id jako aliasy
  • Finwire Nowcast/v1/macro/nowcastprognoza inflacji CPI, inflacji bazowej i decyzji RPP z rozliczeniem trafności
  • Presja kosztowa finwire i Stres kredytowy wyprzedzający finwire/v1/macro/lead-forecastsprognoza inflacji bazowej za 6 i 12 miesięcy oraz udziału kredytów z utratą wartości za 2 i 4 kwartały, z przedziałem 80% i trafnością z backtestu
  • Mapa stresu kredytowego/v1/index/credit-stressrata jako % pensji netto w 16 województwach
  • Wskaźnik rynku kredytów/v1/index/credit-marketindeks 0-100 warunków na rynku kredytów mieszkaniowych
  • Próg wejścia/v1/index/entry-thresholdile brutto trzeba zarabiać na kredyt na mieszkanie w 17 miastach
  • Barometr zdolności kredytowej/v1/index/{slug}wskaźnik miesięczny
  • Dostępność mieszkaniowa/v1/index/{slug}metraż możliwy do sfinansowania
  • Siła nabywcza/v1/index/{slug}realna wartość pieniądza vs inflacja
  • Realne oprocentowanie lokat/v1/index/{slug}lokaty po inflacji
  • Koszt kredytu/v1/index/{slug}wskaźnik kosztu hipoteki

Agregaty rynkowe (bez ofert)

  • Lokaty terminowe/v1/market/deposit-ratesmediana i percentyle oprocentowania
  • Konta oszczędnościowe/v1/market/savings-ratesmediana i percentyle
  • Kredyty hipoteczne/v1/market/mortgage-ratesmediana RRSO, marża, oprocentowanie nominalne
  • Kredyty gotówkowe/v1/market/cash-loan-ratesmediana RRSO i oprocentowanie nominalne
  • Opłaty kont maklerskich/v1/brokersprowizje GPW, USA i Niemcy, opłaty i promocje z oficjalnych tabel opłat
  • Ankieta NBP o kredytach/v1/credit-market/surveykryteria i popyt na kredyty (NBP, kwartalnie)
  • Kredyty i depozyty gospodarstw/v1/credit-market/monetaryNBP: stany kredytów i depozytów, nowe kredyty
  • Popyt na kredyty mieszkaniowe/v1/credit-market/demandBIK Indeks Popytu, średnia kwota wniosku i kredytu, udzielone kredyty (BIK), nowe umowy (NBP)
  • Oprocentowanie kredytów w UE/v1/credit-market/ecb-ratesEBC MIR: nowe kredyty mieszkaniowe w krajach UE
  • Ryzyko raty i premia za stałą stopę/v1/credit-market/rate-riskindeksy finwire: szansa wzrostu raty, przedział raty na 3-12 miesięcy z trafnością, premia za stałą stopę (oferty banków, EBC MIR)

Wszystko jednym zapytaniem

  • Snapshot rynku/v1/snapshotstopy, inflacja, kursy, stres kredytowy, barometry

Pełna lista endpointów

Wszystkie endpointy są wersjonowane prefiksem /v1 i obsługują metodę GET. Adres bazowy: https://public-api.finwire.pl.

MetodaŚcieżkaOpis
GET/v1/snapshotPełny stan rynku jednym zapytaniem
GET/v1/series/interest-rateTabela bieżących stóp NBP
GET/v1/series/interest-rate/{indicator}Historia stopy NBP (np. stopa-referencyjna)
GET/v1/series/cpiInflacja CPI (type=monthly lub yearly)
GET/v1/series/fxTabela bieżących kursów walut NBP
GET/v1/series/fx/{code}Historia kursu waluty (np. EUR, USD, CHF)
GET/v1/series/bond-yieldsRentownoś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/housingCeny mieszkań GUS w 17 miastach
GET/v1/series/housing/{city}Ceny w mieście z ostatnich kwartałów (np. warszawa, krakow)
GET/v1/housing/transactionsCeny transakcyjne RCN: mediana i kwartyle m² w 17 miastach
GET/v1/housing/transactions/{city}Ceny transakcyjne RCN w dzielnicach miasta
GET/v1/rentCzynsze ofertowe w miastach
GET/v1/rent/{city}Czynsze w mieście z podziałem na dzielnice
GET/v1/rent/yieldRentowność najmu brutto i netto
GET/v1/housing/carryCarry nieruchomości finwire: najem netto minus oprocentowanie kredytu w miastach
GET/v1/calendarNajbliższe decyzje RPP i odczyty GUS
GET/v1/series/unemploymentBezrobocie: Polska i 16 województw
GET/v1/series/unemployment/countiesPowiaty z najniższym i najwyższym bezrobociem
GET/v1/series/unemployment/historyHistoria bezrobocia od 2011 (kraj lub województwo)
GET/v1/wages/occupationsWynagrodzenia według zawodów (GUS)
GET/v1/wages/occupations/{code}Jedna grupa zawodów z historią edycji
GET/v1/legal-limits/local-taxGórne granice stawek podatku od nieruchomości
GET/v1/housing/supplyPodaż mieszkań: Polska, województwa, 17 miast
GET/v1/housing/supply/{city}Podaż mieszkań w mieście na tle województwa
GET/v1/index/entry-thresholdPróg wejścia: brutto potrzebne na kredyt w 17 miastach
GET/v1/index/entry-threshold/historyHistoria progu wejścia (singiel lub para)
GET/v1/indexLista wszystkich wskaźników finwire
GET/v1/index/credit-stressMapa stresu: rata jako % pensji w 16 województwach
GET/v1/index/{slug}Pojedynczy wskaźnik finwire
GET/v1/bondsOprocentowanie detalicznych obligacji skarbowych (MF)
GET/v1/wagesWynagrodzenia GUS: mediana, percentyle, średnie wojewódzkie
GET/v1/legal-limitsLimity IKE, IKZE i wartości powiązane
GET/v1/market/deposit-ratesAgregaty oprocentowania lokat terminowych
GET/v1/market/savings-ratesAgregaty oprocentowania kont oszczędnościowych
GET/v1/market/mortgage-ratesAgregaty kredytów hipotecznych (RRSO, marża)
GET/v1/market/cash-loan-ratesAgregaty 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).

Open source i typy TypeScript

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.

github.com/finwire-pl/api README, OpenAPI i typy TypeScript/openapi.json Specyfikacja do generowania klientów/reference Interaktywna dokumentacja Swagger

Wolisz gotowy widget niż API?

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, zawsze z najnowszymi danymi, z linkiem zwrotnym.

Widgety dla wydawcówMapa stresu kredytowegoMetodologia danych

Licencja i zasady cytowania

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.

Najczęstsze pytania

Czy API finwire jest darmowe?
API finwire jest w pełni darmowe i nie wymaga klucza ani rejestracji. Wystarczy zapytanie GET pod https://public-api.finwire.pl. Wskaźniki finwire można wykorzystać także komercyjnie na licencji CC BY 4.0, podając źródło: finwire.pl. Licencja każdego zbioru jest podana w jego opisie.
Skąd pochodzą dane w API?
Dane pochodzą z oficjalnych źródeł: stopy referencyjne z NBP, inflacja i wynagrodzenia z GUS, ceny mieszkań z GUS i Rejestru Cen Nieruchomości (akty notarialne), rentowności obligacji z Eurostatu, czynsze z znajdznajem.pl, obligacje z Ministerstwa Finansów. finwire pobiera je do jednego źródła prawdy i odświeża automatycznie. API nie udostępnia stawek WIBOR ani POLSTR: ich dalsza dystrybucja wymaga licencji GPW Benchmark.
Czy potrzebuję klucza API albo logowania?
Wszystkie endpointy są publiczne, tylko do odczytu (GET), z otwartym CORS, więc działają również bezpośrednio z przeglądarki. Nie ma tokenów ani rejestracji.
Czy mogę podłączyć dane finwire do ChatGPT, Claude albo Cursora?
Tak. Serwer MCP pod adresem https://public-api.finwire.pl/mcp działa bez klucza i bez logowania. Dodajesz go jako konektor w Claude lub ChatGPT albo jako serwer HTTP w Cursorze i VS Code. Asystent dostaje wtedy aktualne stopy NBP, kursy walut, ceny mieszkań z aktów notarialnych, czynsze, limity IKE i IKZE oraz zmiany w prawie, a każda odpowiedź zawiera źródło, licencję i link do strony finwire.pl.
Jak poprawnie cytować dane finwire?
Podaj "Źródło: finwire.pl" z linkiem do strony danych. Licencja CC BY 4.0 wymaga wskazania autorstwa. Wskaźniki własne, takie jak mapa stresu kredytowego czy barometry, cytuj z nazwą i datą odczytu.
Gdzie jest specyfikacja i kod źródłowy?
Pełna specyfikacja OpenAPI jest pod /openapi.json, interaktywna dokumentacja pod /reference, a plik OpenAPI i wygenerowane typy TypeScript w publicznym repozytorium github.com/finwire-pl/api.