API
TargetWatch API tarjoaa rakenteista dataa pohjoismaisista osakkeista. Voit hakea tavoitehintoja, analyysitaloja ja sisäpiirikauppoja JSON-muodossa HTTPS:n kautta.
Hanki avain
Luo ja hallitse avaimiasi suoraan tässä:
Tunnistautuminen
Lähetä avain Bearer-tunnuksena Authorization-otsikossa:
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/stocks"
Pyynnöt ilman kelvollista avainta saavat 401.
Tasot ja pyyntörajat
ILMAINEN
0 $
10 PYYNTÖÄ PÄIVÄSSÄ
- Kaikki osakkeet, joista meillä on dataa
- Ajantasainen konsensus mille tahansa osakkeelle
- Analyytikkotalot
KAIKKI SISÄLLÄ
API PLUS
1 $/kk
1 000 PYYNTÖÄ TUNNISSA
- Kaikki Ilmainen-tason ominaisuudet
- Täysi kurssitavoitehistoria
- Kurssitavoitevirta
- Sisäpiirikaupat
Päivitä API Plussaan hintaan 1 $/kk yllä olevassa avainosiossa.
Jokainen vastaus sisältää tasosi ja pyyntörajan tilan:
X-API-Tier:freetaiproX-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset
Kun raja ylittyy, saat 429 ja Retry-After-otsikon.
API Plus -tilauksen ostaminen
- Kirjaudu sisään (tai luo tili) oikean yläkulman painikkeesta.
- Avaa avainosio tällä sivulla ja valitse API Plus hinnastotaulukosta.
- Maksa kortilla - tilaus maksaa 1 $/kk ja avaimesi päivittyy heti 1 000 kutsuun tunnissa.
Hallinnoi tai peru tilaus milloin tahansa sivulla Oma sivu.
Maksut käsittelee Stripe.
Ilmaiset rajapinnat
Analyysitalot-rajapinta
FREE/api/v2/analysts
Seuraamamme analyytikkotalot. Saatavilla kaikilla tilauksilla.
KENTÄT:
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/analysts"
[
{ "slug": "abg-sundal-collier", "house": "ABG Sundal Collier" },
{ "slug": "aktiespararna", "house": "Aktiespararna" },
...
]
Osakkeet-rajapinta
FREE/api/v2/stocks
Kaikki seurattavat osakkeet. Saatavilla kaikilla tasoilla.
KENTÄT:
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/stocks"
[
{
"ticker": "8TRA",
"stock": "Traton",
"market": "Stockholmsbörsen",
"list": "Large Cap",
"sector": "Industrials",
"industry": "Farm & Heavy Construction Machinery",
"country": "sweden",
"listingStatus": "active",
"delistedDate": null,
"currency": "SEK"
},
...
]
Osakkeen tavoitehinnat -rajapinta
FREE/api/v2/stocks/{ticker}/targets
Yhden osakkeen ajantasainen mediaanitavoite: viimeisin kurssi, mediaanitavoite, nousuvara ja taustalla olevat analyysitalot. Saatavilla kaikilla tasoilla.
KENTÄT:
PARAMETRIT:
| Nimi | Tyyppi | Pakollinen | Merkitys | Esimerkki |
|---|---|---|---|---|
| ticker | string | Pakollinen | Osaketunnus, jolla osake valitaan. | VOLV-B |
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/stocks/VOLV-B/targets"
Esimerkkivastaus, ei reaaliaikaista markkinatietoa
{
"ticker": "VOLV-B",
"stock": "Volvo",
"currency": "SEK",
"date": "2026-10-26",
"listingStatus": "active",
"delistedDate": null,
"priceStale": false,
"latestPrice": 300,
"latestPriceDate": "2026-10-26",
"upsidePct": 10,
"houses": [
{
"id": 123,
"house": "Example house",
"priceTarget": 330,
"date": "2026-10-26"
}
],
"medianTarget": 330
}API Plus -rajapinnat
Tavoitehintojen historia -rajapinta
API PLUS/api/v2/stocks/{ticker}/targets/history
Yhden osakkeen kurssitavoitehistoria, uusin ensin.
KENTÄT:
PARAMETRIT:
| Nimi | Tyyppi | Pakollinen | Merkitys | Esimerkki |
|---|---|---|---|---|
| ticker | string | Pakollinen | Osaketunnus, jolla osake valitaan. | VOLV-B |
| from | date | Valinnainen | Alkupäivä mukaan lukien (YYYY-MM-DD). | 2026-01-01 |
| to | date | Valinnainen | Loppupäivä mukaan lukien (YYYY-MM-DD). | 2026-09-18 |
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/stocks/VOLV-B/targets/history?from=2026-01-01&to=2026-09-18"
[
{ "id": 33308, "house": "Jefferies", "priceTarget": 370, "currency": "SEK", "date": "2026-09-15" },
{ "id": 33192, "house": "Morgan Stanley", "priceTarget": 355, "currency": "SEK", "date": "2026-09-04" },
...
]
Tavoitehintasyöte-rajapinta
API PLUS/api/v2/targets
Globaali kurssitavoitevirta, uusin ensin.
KENTÄT:
PARAMETRIT:
| Nimi | Tyyppi | Pakollinen | Merkitys | Esimerkki |
|---|---|---|---|---|
| from | date | Valinnainen | Alkupäivä mukaan lukien (YYYY-MM-DD). | 2026-01-01 |
| to | date | Valinnainen | Loppupäivä mukaan lukien (YYYY-MM-DD). | 2026-09-18 |
| house | string | Valinnainen | Suodata talon mukaan kirjainkoosta riippumatta. | dnb-carnegie |
| ticker | string | Valinnainen | Tarkka ticker-haku | VOLV-B |
| limit | integer | Valinnainen | Rivejä sivulla; 1-500 (oletus 100). | 100 |
| cursor | string | Valinnainen | Edellisen vastauksen nextCursor-arvo. | MTAw |
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/targets?from=2026-09-01&house=dnb-carnegie&limit=100"
{
"items": [
{
"id": 33368,
"ticker": "ORSTED",
"stock": "Ørsted",
"house": "ABG Sundal Collier",
"priceTarget": 180,
"currency": "DKK",
"date": "2026-09-18"
},
...
],
"total": 28610,
"nextCursor": "MTAw"
}
Tavoitehintatietue-rajapinta
API PLUS/api/v2/targets/{id}
Yksi täydellinen kurssitavoitetietue.
KENTÄT:
PARAMETRIT:
| Nimi | Tyyppi | Pakollinen | Merkitys | Esimerkki |
|---|---|---|---|---|
| id | integer | Pakollinen | Kurssitavoitteen tunniste. | 33368 |
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/targets/33368"
{
"id": 33368,
"ticker": "ORSTED",
"stock": "Ørsted",
"house": "ABG Sundal Collier",
"priceTarget": 180,
"currency": "DKK",
"date": "2026-09-18",
"link": "https://www.placera.se/telegram/dagens-aktierekommendationer-i-oversikt-20260918"
}
Osakkeen sisäpiirikaupat -rajapinta
API PLUS/api/v2/stocks/{ticker}/insider-trades
Yhden osakkeen sisäpiirikaupat.
VASTAUSRAKENNE:
KENTÄT:
PARAMETRIT:
| Nimi | Tyyppi | Pakollinen | Merkitys | Esimerkki |
|---|---|---|---|---|
| ticker | string | Pakollinen | Osaketunnus, jolla osake valitaan. | VOLV-B |
| status | enum | Valinnainen | FI-lähteen statusarvot: Aktuell, Reviderad, Makulerad. Makulerad jätetään oletuksena pois; all sisällyttää mitätöidyt ilmoitukset. | all |
| category | enum | Valinnainen | Tapahtumaluokka: market-buy, market-sell, off-market-buy, off-market-sell, redemption, grant, subscription, gift, internal tai other. | market-buy |
| marketImpact | enum | Valinnainen | Sallitut arvot: buy-pressure, sell-pressure, no-pressure. | buy-pressure |
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/stocks/VOLV-B/insider-trades"
{
"dataAsOf": "2026-05-22",
"total": 2,
"items": [
{
"ticker": "VOLV-B",
"stock": "Volvo",
"person": "Bo Annvik",
"role": "board_member",
"type": "buy",
"volume": 1757,
"price": 284.3,
"currency": "SEK",
"totalValue": 499515,
"publicationDate": "2025-11-27",
"transactionDate": "2025-11-27",
"status": "Aktuell"
},
...
]
}
Sisäpiirikaupat-rajapinta
API PLUS/api/v2/insider-trades
Globaali sisäpiirivirta, uusin ensin. Lähdekohtaiset kentät ovat mukana, kun ne ovat saatavilla.
VASTAUSRAKENNE:
KENTÄT:
PARAMETRIT:
| Nimi | Tyyppi | Pakollinen | Merkitys | Esimerkki |
|---|---|---|---|---|
| from | date | Valinnainen | Julkaisun alkupäivä mukaan lukien (YYYY-MM-DD). | 2026-01-01 |
| to | date | Valinnainen | Julkaisun loppupäivä mukaan lukien (YYYY-MM-DD). On oltava sama tai myöhempi kuin from; muuten palautetaan 400. | 2026-09-18 |
| ticker | string | Valinnainen | Tarkka ticker-haku | VOLV-B |
| type | enum | Valinnainen | Tapahtumatyyppi: buy, sell tai other. | buy |
| status | enum | Valinnainen | FI-lähteen statusarvot: Aktuell, Reviderad, Makulerad. Makulerad jätetään oletuksena pois; all sisällyttää mitätöidyt ilmoitukset. | all |
| category | enum | Valinnainen | Tapahtumaluokka: market-buy, market-sell, off-market-buy, off-market-sell, redemption, grant, subscription, gift, internal tai other. | market-buy |
| marketImpact | enum | Valinnainen | Sallitut arvot: buy-pressure, sell-pressure, no-pressure. | buy-pressure |
| limit | integer | Valinnainen | Rivejä sivulla; 1-500 (oletus 100). | 100 |
| cursor | string | Valinnainen | Edellisen vastauksen nextCursor-arvo. | MTAw |
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/insider-trades?type=buy&limit=100"
{
"dataAsOf": "2026-05-22",
"items": [
{
"ticker": "CHEF",
"stock": "Cheffelo",
"person": "Adam Björklund",
"role": "management",
"type": "buy",
"volume": 1100,
"price": 119.6,
"currency": "SEK",
"totalValue": 131560,
"publicationDate": "2026-05-22",
"transactionDate": "2026-05-22",
"status": "Aktuell"
},
...
],
"total": 2199,
"nextCursor": "MTAw"
}
Yleistä
Listautumistila ja kurssin laatu
Osakeluettelon oletus on active. Suodata /stocks parametrilla listingStatus=active|delisted|unknown|all. Historiallisen /targets-syötteen oletus on all, ja sama suodatin toimii siinä. Virheellinen arvo palauttaa 400. Ticker-haut toimivat kaikille luettelon noteerauksille, myös listalta poistuneille. Instrumenttivaihdossa kokonaan poistuneet tickerit palauttavat 404, mutta niiden historia ja tunnisteet säilyvät. Vahvistetun nimi- tai tickervaihdon jälkeen vanha ticker voi edelleen ohjautua nykyiseen yhtiöön; muuten se palauttaa 404. Puuttuva nykyisen instrumentin kurssi pysyy null-arvona. Historialliset kurssit ja tunnisteet säilyvät.
KENTÄT:
| Kenttä | Arvot | Merkitys |
|---|---|---|
| listingStatus | active · delisted · unknown | Listautumisen nykyinen tila, ei tavoitehinnan päivämäärän tilaa. |
| delistedDate | date · null | Vahvistettu viimeinen kaupankäyntipäivä. Null, kunnes päivämäärä on vahvistettu. |
| latestPrice, latestPriceDate | number, date · null | Viimeisin tunnettu kurssi, ei lupaus nykyisestä kaupankäynnistä. |
| priceStale | true · false · null | True kahden odotetun päivittäisen EOD-päivityksen puuttuessa, viikonloput ja vahvistetut pörssipyhät pois lukien. False tarkoittaa riittävän tuoretta; null puuttuvaa kurssia tai kalenteria. Haku 12:30 UTC aiemmille kaupankäyntipäiville. |
| upsidePct | number · null | Null, ellei listingStatus ole active ja priceStale false. |
curl -H "Authorization: Bearer SINUN-AVAIN" \ "https://www.targetwatch.io/api/v2/stocks/FNOX/targets"
Esimerkkivastaus, ei reaaliaikaista markkinatietoa
{
"ticker": "FNOX",
"stock": "Fortnox",
"currency": "SEK",
"date": "2026-10-26",
"listingStatus": "delisted",
"delistedDate": null,
"priceStale": true,
"latestPrice": 89.4,
"latestPriceDate": "2025-07-24",
"upsidePct": null,
"houses": [],
"medianTarget": 90
}Sivutus
Virran rajapinnat (targets, insider-trades) palauttavat enintään limit kohdetta kerrallaan (oletus 100, enintään 500):
{ "items": [ ... ], "total": 7792, "nextCursor": "MTAw" }
Välitä nextCursor takaisin cursor-parametrina, kunnes se palautuu null.
Virtarivien ticker on null, kun yhtiö on pohjoismainen mutta ei vielä katalogissamme. Käytä siihen asti tunnisteena kenttää stock (yhtiön nimi). Ei-pohjoismaisiksi arvioituja yhtiöitä ei palauteta virrassa.
Virhekoodit
400- virheellinen parametri (väärä päivämäärä, cursor tai limit)401- puuttuva tai virheellinen API-avain403- kelvollinen avain, mutta rajapinta vaatii API Plussan404- tuntematon talo tai kurssitavoitteen id (sisäpiiri-endpointit palauttavat200tyhjälläitems-listalla tuntemattomalle tickerille)429- pyyntöraja ylittyi, katsoRetry-After
Lisenssi
Data on lisensoitu sisäiseen käyttöön. Voit rakentaa sen varaan tuotteita, analyysejä ja päätöksiä. Et saa jakaa raakadataa eteenpäin, myydä sitä tai tarjota sitä kilpailevana datapalveluna. Ota yhteyttä, jos tarvitset jakeluoikeudet.