Takaisin korkoihin
AVOIN RAJAPINTA · V1

Euribor-korot.
Sinun käyttöösi.

Tuo korot, ennusteet, talousuutiset ja EKP:n kokouskalenteri omaan sovellukseesi. Valitse haluamasi tieto ja kokeile hakua suoraan tällä sivulla.

Maksuton käyttää Ei API-avainta JSON · CORS
Kokeile ensimmäistä hakua

Mitä haluat hakea?

6 hakua · vain luku
GETViimeisimmät korot/api/v1/current

Hae viimeisin julkaistu Euribor-korkopäivä ja sen korot.

Viimeisin korkopäivä voi olla eilinen tai aiempi pankkipäivä. Suomen Pankin tiedot julkaistaan 24 tunnin viiveellä.

https://korkojenkorot.fi/api/v1/current
GET · vain luku

Kokeile hakua nähdäksesi rajapinnan oikean vastauksen.

Esimerkki komentorivillecurl 'https://korkojenkorot.fi/api/v1/current'
Vastauksen kentät
observation
Viimeisin havainto: date ja rates. Esimerkiksi rates["12"] on 12 kuukauden Euribor prosentteina.
latestDate
Aineiston viimeisin korkopäivä, myös historiaa rajattaessa.
status / fallback
published / false = lähde vastasi. snapshot / true = käytössä on tallennettu lähdeaineisto.
stale
true, jos aineiston viimeisin korkopäivä on yli viisi päivää vanha.
availableRange
Aineiston ensimmäinen ja viimeisin korkopäivä. Päivittäinen historia alkaa 4.1.1999.
retrievedAt
Palvelimen haun aika UTC-muodossa. Välimuistivastauksessa alkuperäinen hakuaika säilyy.
GETKorot ja korkohistoria/api/v1/rates

Hae päivittäiset havainnot vanhimmasta uusimpaan. Tyhjillä päivämäärillä saat koko saatavilla olevan historian.

Alku- ja loppupäivä sisältyvät hakuun. Viikonloppuja ja puuttuvia havaintoja ei täytetä. Tyhjälle aikavälille palautetaan tyhjä lista.

https://korkojenkorot.fi/api/v1/rates
GET · vain luku

Kokeile hakua nähdäksesi rajapinnan oikean vastauksen.

Esimerkki komentorivillecurl 'https://korkojenkorot.fi/api/v1/rates'
Vastauksen kentät
observations
Havaintolista: date ja rates. Esimerkiksi rates["12"] on 12 kuukauden Euribor prosentteina.
count
Palautettujen päivittäisten havaintojen määrä.
latestDate
Aineiston viimeisin korkopäivä, myös historiaa rajattaessa.
status / fallback
published / false = lähde vastasi. snapshot / true = käytössä on tallennettu lähdeaineisto.
stale
true, jos aineiston viimeisin korkopäivä on yli viisi päivää vanha.
availableRange
Aineiston ensimmäinen ja viimeisin korkopäivä. Päivittäinen historia alkaa 4.1.1999.
retrievedAt
Palvelimen haun aika UTC-muodossa. Välimuistivastauksessa alkuperäinen hakuaika säilyy.
GETKuukausittainen korkoennuste/api/v1/forecast

Hae Euribor-ennuste ja historiasta kalibroitu vaihteluväli seuraaville 1–12 kuukaudelle.

Ennuste ei ole julkaistu korko. Maturiteetti ja ennustehorisontti ovat eri asioita. Tarkista status, fallback ja originDate. Vanhentunut korkohistoria palauttaa 503.

https://korkojenkorot.fi/api/v1/forecast?months=12
GET · vain luku

Kokeile hakua nähdäksesi rajapinnan oikean vastauksen.

Esimerkki komentorivillecurl 'https://korkojenkorot.fi/api/v1/forecast?months=12'
Vastauksen kentät
forecasts
Maturiteetti tenor, nykyinen current ja kuukausien points: date, months, value, lower, upper. Korot prosentteina vuodessa.
status / fallback / sourceFallback
ready: malli ja lähde käytettävissä. degraded: varamalli tai tallennettu lähde. unavailable: ennustetta ei julkaista (503). fallback kertoo varamallista; sourceFallback lähteen varatiedosta.
originDate / generatedAt
Viimeisin ennusteessa käytetty korkopäivä / laskennan aika UTC-muodossa.
mae / baselineMae / coverage
Kuukausien pisteissä mallin ja muuttumattoman koron testivirhe sekä vaihteluvälin mitattu kattavuus 0–1.
inputs / sources
Ennusteen tallennetut taloushavainnot ja malliraportin lähdeosoitteet sekä aineistojen SHA-256-tiivisteet.
skill / skill95BlockInterval
Virheen suhteellinen pieneneminen muuttumattomaan korkoon verrattuna ja 95 % lohkoarvio hyödylle. Negatiivinen arvo tarkoittaa suurempaa virhettä; nollan sisältävä väli ei osoita varmaa etua.
trainedAt / validUntil / trainingEnd
Mallin koulutusaika, voimassaoloaika ja koulutuksen viimeinen korkopäivä. Koulutuspäivä ei ole sama kuin ennusteen korkopäivä.
intervalTarget / limitations
Vaihteluvälin tavoite (0,8) ja menetelmän rajoitukset. Historiatesti ei takaa tulevaa tarkkuutta.
GETMallin tarkkuus ja menetelmä/api/v1/model

Hae mallivalinta, etenevän testin tarkkuus, vuosikohtaiset tulokset, vertailuhyödyn epävarmuus ja uusien ennusteiden seuranta.

Kaikki virheet ovat prosenttiyksikköjä. Vaihteluvälin 80 % tavoite ei takaa tulevaa kattavuutta.

https://korkojenkorot.fi/api/v1/model
GET · vain luku

Kokeile hakua nähdäksesi rajapinnan oikean vastauksen.

Esimerkki komentorivillecurl 'https://korkojenkorot.fi/api/v1/model'
Vastauksen kentät
horizons
12 horisonttia. Jokaisen tenors sisältää mallivalinnan, valinta- ja testimittarit, baseline-vertailun, kattavuuden sekä arvioinnin päivämäärät.
inputs / sources
Ennusteen tallennetut taloushavainnot ja malliraportin lähdeosoitteet sekä aineistojen SHA-256-tiivisteet.
skill / skill95BlockInterval
Virheen suhteellinen pieneneminen muuttumattomaan korkoon verrattuna ja 95 % lohkoarvio hyödylle. Negatiivinen arvo tarkoittaa suurempaa virhettä; nollan sisältävä väli ei osoita varmaa etua.
prospective
Muuttumattomina tallennettujen viikkoennusteiden määrä ja niiden toteutunut tarkkuus. Tyhjä horizons tarkoittaa, ettei yhtään kohdekorkoa ole vielä julkaistu.
trainedAt / validUntil / trainingEnd
Mallin koulutusaika, voimassaoloaika ja koulutuksen viimeinen korkopäivä. Koulutuspäivä ei ole sama kuin ennusteen korkopäivä.
intervalTarget / limitations
Vaihteluvälin tavoite (0,8) ja menetelmän rajoitukset. Historiatesti ei takaa tulevaa tarkkuutta.
GETKorko- ja talousuutiset/api/v1/news

Hae suomenkielisiä uutisia Euriborista, koroista ja taloudesta. Rajaa aihetta, julkaisijaa tai ajankohtaa ja selaa tuloksia sivuittain.

Otsikot ja linkit uusimmasta vanhimpaan. Lähteiden kattavuus vaihtelee; kaikkien lähteiden häiriö palauttaa 503. Artikkelien koko teksti ei sisälly vastaukseen.

https://korkojenkorot.fi/api/v1/news?limit=50&offset=0
GET · vain luku

Kokeile hakua nähdäksesi rajapinnan oikean vastauksen.

Esimerkki komentorivillecurl 'https://korkojenkorot.fi/api/v1/news?limit=50&offset=0'
Vastauksen kentät
articles / topics
Uutisissa url, title, publisher, timestamp, dateKind, providers, paywalled ja topics sekä mahdollinen imageUrl. Vastauksen topics listaa sallitut aiheet.
dateKind
published: julkaisuaika. seen: lähteen havaintoaika, joka ei ole julkaisuaika.
status / sources
available: lähteet vastasivat. partial: osa hauista epäonnistui. unavailable (503): kaikki lähteet epäonnistuivat. sources kertoo lähdekohtaisen tilan ja kattavuusrajat.
count / total / nextCursor
count kertoo sivun koon. total on null. Käytä nextCursor-arvoa cursor-parametrina seuraavalla sivulla ja nollaa offset. null tarkoittaa arkiston loppua.
before / dateKind
before rajaa uutiset UTC-ajankohtaa vanhemmiksi kaikista tallennetuista lähteistä. Arkistolla ei ole 89 päivän aikarajaa. dateKind: seen tarkoittaa havaintoaikaa, published julkaisuaikaa.
retrievedAt / redistribution
Hakuaika ja lähteiden oikeuksia koskeva huomautus. Rajapinta ei anna oikeutta uutisten tai kuvien uudelleenjulkaisuun.
GETEKP:n kokoukset ja korko-odotukset/api/v1/ecb

Hae tulevat rahapolitiikan päätöspäivät, päätösajat ja kokouskohtaiset talletuskorko-odotukset sekä kyselyn lähde ja viimeisin tarkistettu päätös.

Odotukset ovat päivätyn analyytikkokyselyn mediaaneja ja kvartiileja. Ne eivät ole todennäköisyyksiä tai EKP:n lupauksia. Vanhentunut odotus on null.

https://korkojenkorot.fi/api/v1/ecb
GET · vain luku

Kokeile hakua nähdäksesi rajapinnan oikean vastauksen.

Esimerkki komentorivillecurl 'https://korkojenkorot.fi/api/v1/ecb'
Vastauksen kentät
meetings
Päätöspäivä date, päivien määrä daysUntil Suomen ajassa, päätöshetki decisionAt UTC-aikana ja expectation.
expectation
Talletuskoron mediaani median ja 25.–75. prosenttipiste lower / upper prosentteina. change on ero tarkistettuun päätökseen prosenttiyksikköinä. Puuttuva tai vanhentunut odotus on null.
calendarStatus / fallback
published / false: kalenteri saatiin EKP:ltä. snapshot / true: tallennettu kalenteri. Tarkista calendarCheckedAt ja calendarUrl.
survey / expectationsExpired
Kyselyn lähde, julkaisu- ja keruupäivät, vastaajamäärä sekä odotusten vanhentuminen. Kalenterin päivitys ei päivitä kyselyn odotuksia.
lastDecision
Viimeisin käsin tarkistettu talletuskorkopäätös ja lähde. Tarkista date: tämä ei ole automaattisesti päivittyvä ohjauskorko.

Hyvä tietää

Korot ovat prosentteja

Esimerkiksi "12": 3.177 tarkoittaa 3,177 prosentin vuotuista 12 kuukauden Euribor-korkoa. Pankin marginaali ja kulut eivät sisälly lukuihin. Negatiiviset korot säilytetään sellaisinaan.

Tarkista korkopäivä

Korot määritetään pankkipäivinä, ja Suomen Pankki julkaisee tiedot 24 tunnin viiveellä. Tarkista aina latestDate, fallback ja stale. Lähteen häiriötilanteessa saat tallennetun aineiston.

Kuinka usein tietoja kannattaa hakea?

Korot päivittyvät pankkipäivittäin. Hae tiedot enintään kerran 15 minuutissa ja käytä omaa välimuistia. Rajapinnan raja on noin 120 pyyntöä minuutissa IP-osoitetta ja Cloudflaren palvelinsijaintia kohden. Palvelulla ei ole saatavuustakuuta.

Tarkat parametrit kehittäjälle
tenor
1, 3, 6 tai 12 kuukautta. Valinnainen /current-, /rates- ja /forecast-hauissa; oletus on kaikki neljä maturiteettia.
start / end
YYYY-MM-DD, vain /rates. Molemmat rajat sisältyvät hakuun. Voit antaa yhden rajan tai jättää molemmat tyhjiksi. Alku ei saa olla loppua myöhempi.
months
1–12, vain /forecast. Oletus 12. Ennustehorisontti kuukausina; maturiteetti valitaan tenor-parametrilla. /model ja /ecb eivät hyväksy parametreja.
q / topic / provider / publisher
Vain /news. q: kaikki välilyönnein erotetut sanat otsikossa tai julkaisijan nimessä (enintään 200 merkkiä). topic: yksi vastauksen topics-listan id. provider: ampparit, gdelt tai firecrawl. publisher: tarkka nimi (enintään 120 merkkiä).
days / limit / cursor / before
Vain /news. days: viimeiset 1–36500 vuorokautta, oletus kaikki saatavilla olevat. limit: 1–250, oletus 50. cursor: vastauksen nextCursor seuraavaa sivua varten. before: UTC-aikaleima, jota vanhempia uutisia haetaan. Arkisto sisältää pysyvästi tallennetut uutiset kaikista lähteistä.

Tuntemattomat ja toistetut parametrit hylätään. Vastauksen rates-avaimet ovat maturiteetteja kuukausina.

Mitä virheilmoitukset tarkoittavat?

400: tarkista maturiteetti, päivämäärät ja parametrit. 503: korkohistoria on liian vanha tai puutteellinen ennusteelle, tai kaikki uutislähteet ovat poissa käytöstä. 429: odota 60 sekuntia ennen seuraavaa hakua. Korkolähteen häiriö palauttaa merkityn varatiedon; fallback: true ei tarkoita tuoretta korkopäivää.