API

TargetWatch API tarjoaa rakenteista dataa pohjoismaisista osakkeista. Voit hakea tavoitehintoja, niiden muutoksia, 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:

GET REQUEST

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 ja muutokset
Sisäpiirikaupat

Päivitä API Plussaan hintaan 1 $/kk yllä olevassa avainosiossa.

Jokainen vastaus sisältää tasosi ja pyyntörajan tilan:

X-API-Tier: free tai pro
X-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

GET /api/v2/analysts FREE

Seuraamamme analyytikkotalot. Saatavilla kaikilla tilauksilla.

KENTÄT:

slughouse

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/analysts"

200 OK - YKSI RIVI NÄYTETÄÄN

[
  { "slug": "abg-sundal-collier", "house": "ABG Sundal Collier" },
  { "slug": "aktiespararna", "house": "Aktiespararna" },
  ...
]

GET /api/v2/stocks FREE

Kaikki seurattavat osakkeet. Saatavilla kaikilla tasoilla.

KENTÄT:

tickerstockmarketlistsectorindustrycountrycurrency

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/stocks"

200 OK - YKSI RIVI NÄYTETÄÄN

[
  {
    "ticker": "8TRA",
    "stock": "Traton",
    "market": "Stockholmsbörsen",
    "list": "Large Cap",
    "sector": "Industrials",
    "industry": "Farm & Heavy Construction Machinery",
    "country": "sweden",
    "currency": "SEK"
  },
  ...
]

GET /api/v2/stocks/{ticker}/targets FREE

Yhden osakkeen ajantasainen mediaanitavoite: viimeisin kurssi, mediaanitavoite, nousuvara ja taustalla olevat analyysitalot. Saatavilla kaikilla tasoilla.

KENTÄT:

tickerstockcurrencydatemedianTargetlatestPricelatestPriceDateupsidePcthouses[]

PARAMETRIT:

Nimi	Tyyppi	Pakollinen	Merkitys	Esimerkki
ticker	string	Pakollinen	Osaketunnus, jolla osake valitaan.	VOLV-B

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/stocks/VOLV-B/targets"

API Plus -rajapinnat

GET /api/v2/stocks/{ticker}/targets/history API PLUS

Yhden osakkeen kurssitavoitehistoria, uusin ensin.

KENTÄT:

idhousepriceTargetcurrencydate

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
ticker	string	Pakollinen	Osaketunnus, jolla osake valitaan.	VOLV-B

GET REQUEST

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"

200 OK - YKSI RIVI NÄYTETÄÄN

[
  { "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" },
  ...
]

GET /api/v2/targets API PLUS

Globaali kurssitavoitevirta, uusin ensin.

KENTÄT:

idtickerstockhousepriceTargetcurrencydate

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

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/targets?from=2026-09-01&house=dnb-carnegie&limit=100"

200 OK - YKSI RIVI NÄYTETÄÄN

{
  "items": [
    {
      "id": 33368,
      "ticker": "ORSTED",
      "stock": "Ørsted",
      "house": "ABG Sundal Collier",
      "priceTarget": 180,
      "currency": "DKK",
      "date": "2026-09-18"
    },
    ...
  ],
  "total": 28610,
  "nextCursor": "MTAw"
}

GET /api/v2/targets/{id} API PLUS

Yksi täydellinen kurssitavoitetietue.

KENTÄT:

idtickerstockhousepriceTargetcurrencydatelink

PARAMETRIT:

Nimi	Tyyppi	Pakollinen	Merkitys	Esimerkki
id	integer	Pakollinen	Kurssitavoitteen tunniste.	33368

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/targets/33368"

200 OK

{
  "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"
}

GET /api/v2/targets/changes API PLUS

Uudet kurssitavoitteet pollaukseen.

KENTÄT:

idtickerstockhousepriceTargetcurrencydate

PARAMETRIT:

Nimi	Tyyppi	Pakollinen	Merkitys	Esimerkki
since	date	Pakollinen	Pakollinen alkupäivä (YYYY-MM-DD); enintään 31 päivän haku.	2026-09-12
limit	integer	Valinnainen	Rivejä sivulla; 1-500 (oletus 100).	100
cursor	string	Valinnainen	Edellisen vastauksen nextCursor-arvo.	MTAw

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/targets/changes?since=2026-09-12"

200 OK - YKSI RIVI NÄYTETÄÄN

{
  "items": [
    {
      "id": 33368,
      "ticker": "ORSTED",
      "stock": "Ørsted",
      "house": "ABG Sundal Collier",
      "priceTarget": 180,
      "currency": "DKK",
      "date": "2026-09-18"
    },
    ...
  ],
  "total": 12,
  "nextCursor": "MTAw"
}

GET /api/v2/stocks/{ticker}/insider-trades API PLUS

Yhden osakkeen sisäpiirikaupat.

VASTAUSRAKENNE:

dataAsOfitemstotal

KENTÄT:

tickerstockpersonroletypevolumepricecurrencytotalValuepublicationDatetransactionDatestatusroleTitlecategorymarketImpactissuerleinotifierrelatedPartycorrectioncorrectionDescriptioninitialNotificationlinkedToShareProgrammenatureinstrumentTypeinstrumentisinunittradingVenue

PARAMETRIT:

Nimi	Tyyppi	Pakollinen	Merkitys	Esimerkki
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
ticker	string	Pakollinen	Osaketunnus, jolla osake valitaan.	VOLV-B

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/stocks/VOLV-B/insider-trades"

200 OK - YKSI RIVI NÄYTETÄÄN

{
  "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"
    },
    ...
  ]
}

GET /api/v2/insider-trades API PLUS

Globaali sisäpiirivirta, uusin ensin. Lähdekohtaiset kentät ovat mukana, kun ne ovat saatavilla.

VASTAUSRAKENNE:

dataAsOfitemstotalnextCursor

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

GET REQUEST

curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/insider-trades?type=buy&limit=100"

200 OK - YKSI RIVI NÄYTETÄÄN

{
  "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"
}

Sivutus

Virran rajapinnat (targets, targets/changes, 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, tai yli 31 päivän since)
401 - puuttuva tai virheellinen API-avain
403 - kelvollinen avain, mutta rajapinta vaatii API Plussan
404 - tuntematon talo tai kurssitavoitteen id (sisäpiiri-endpointit palauttavat 200 tyhjällä items-listalla tuntemattomalle tickerille)
429 - pyyntöraja ylittyi, katso Retry-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.