TW1 <GO> TARGETWATCH 2 <GO>MARKETLIVE
API

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:

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
  • 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

  1. Kirjaudu sisään (tai luo tili) oikean yläkulman painikkeesta.
  2. Avaa avainosio tällä sivulla ja valitse API Plus hinnastotaulukosta.
  3. 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
GET /api/v2/analysts

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

Osakkeet-rajapinta

FREE
GET /api/v2/stocks

Kaikki seurattavat osakkeet. Saatavilla kaikilla tasoilla.

KENTÄT:

tickerstockmarketlistsectorindustrycountrycurrencylistingStatusdelistedDate
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",
    "listingStatus": "active",
    "delistedDate": null,
    "currency": "SEK"
  },
  ...
]

Osakkeen tavoitehinnat -rajapinta

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

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

KENTÄT:

tickerstockcurrencydatemedianTargetlistingStatusdelistedDatepriceStalelatestPricelatestPriceDateupsidePcthouses[]

PARAMETRIT:

NimiTyyppiPakollinenMerkitysEsimerkki
tickerstringPakollinenOsaketunnus, jolla osake valitaan.VOLV-B
GET REQUEST
curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/stocks/VOLV-B/targets"
200 OK

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
GET /api/v2/stocks/{ticker}/targets/history

Yhden osakkeen kurssitavoitehistoria, uusin ensin.

KENTÄT:

idhousepriceTargetcurrencydate

PARAMETRIT:

NimiTyyppiPakollinenMerkitysEsimerkki
tickerstringPakollinenOsaketunnus, jolla osake valitaan.VOLV-B
fromdateValinnainenAlkupäivä mukaan lukien (YYYY-MM-DD).2026-01-01
todateValinnainenLoppupäivä mukaan lukien (YYYY-MM-DD).2026-09-18
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" },
  ...
]

Tavoitehintasyöte-rajapinta

API PLUS
GET /api/v2/targets

Globaali kurssitavoitevirta, uusin ensin.

KENTÄT:

listingStatusdelistedDateidtickerstockhousepriceTargetcurrencydate

PARAMETRIT:

NimiTyyppiPakollinenMerkitysEsimerkki
fromdateValinnainenAlkupäivä mukaan lukien (YYYY-MM-DD).2026-01-01
todateValinnainenLoppupäivä mukaan lukien (YYYY-MM-DD).2026-09-18
housestringValinnainenSuodata talon mukaan kirjainkoosta riippumatta.dnb-carnegie
tickerstringValinnainenTarkka ticker-hakuVOLV-B
limitintegerValinnainenRivejä sivulla; 1-500 (oletus 100).100
cursorstringValinnainenEdellisen 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"
}

Tavoitehintatietue-rajapinta

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

Yksi täydellinen kurssitavoitetietue.

KENTÄT:

listingStatusdelistedDateidtickerstockhousepriceTargetcurrencydatelink

PARAMETRIT:

NimiTyyppiPakollinenMerkitysEsimerkki
idintegerPakollinenKurssitavoitteen 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"
}

Osakkeen sisäpiirikaupat -rajapinta

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

Yhden osakkeen sisäpiirikaupat.

VASTAUSRAKENNE:

dataAsOfitemstotal

KENTÄT:

tickerstockpersonroletypevolumepricecurrencytotalValuepublicationDatetransactionDatestatusroleTitlecategorymarketImpactissuerleinotifierrelatedPartycorrectioncorrectionDescriptioninitialNotificationlinkedToShareProgrammenatureinstrumentTypeinstrumentisinunittradingVenue

PARAMETRIT:

NimiTyyppiPakollinenMerkitysEsimerkki
tickerstringPakollinenOsaketunnus, jolla osake valitaan.VOLV-B
statusenumValinnainenFI-lähteen statusarvot: Aktuell, Reviderad, Makulerad. Makulerad jätetään oletuksena pois; all sisällyttää mitätöidyt ilmoitukset.all
categoryenumValinnainenTapahtumaluokka: market-buy, market-sell, off-market-buy, off-market-sell, redemption, grant, subscription, gift, internal tai other.market-buy
marketImpactenumValinnainenSallitut arvot: buy-pressure, sell-pressure, no-pressure.buy-pressure
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"
    },
    ...
  ]
}

Sisäpiirikaupat-rajapinta

API PLUS
GET /api/v2/insider-trades

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

VASTAUSRAKENNE:

dataAsOfitemstotalnextCursor

KENTÄT:

tickerstockpersonroletypevolumepricecurrencytotalValuepublicationDatetransactionDatestatusroleTitlecategorymarketImpactissuerleinotifierrelatedPartycorrectioncorrectionDescriptioninitialNotificationlinkedToShareProgrammenatureinstrumentTypeinstrumentisinunittradingVenue

PARAMETRIT:

NimiTyyppiPakollinenMerkitysEsimerkki
fromdateValinnainenJulkaisun alkupäivä mukaan lukien (YYYY-MM-DD).2026-01-01
todateValinnainenJulkaisun loppupäivä mukaan lukien (YYYY-MM-DD). On oltava sama tai myöhempi kuin from; muuten palautetaan 400.2026-09-18
tickerstringValinnainenTarkka ticker-hakuVOLV-B
typeenumValinnainenTapahtumatyyppi: buy, sell tai other.buy
statusenumValinnainenFI-lähteen statusarvot: Aktuell, Reviderad, Makulerad. Makulerad jätetään oletuksena pois; all sisällyttää mitätöidyt ilmoitukset.all
categoryenumValinnainenTapahtumaluokka: market-buy, market-sell, off-market-buy, off-market-sell, redemption, grant, subscription, gift, internal tai other.market-buy
marketImpactenumValinnainenSallitut arvot: buy-pressure, sell-pressure, no-pressure.buy-pressure
limitintegerValinnainenRivejä sivulla; 1-500 (oletus 100).100
cursorstringValinnainenEdellisen 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"
}

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äArvotMerkitys
listingStatusactive · delisted · unknownListautumisen nykyinen tila, ei tavoitehinnan päivämäärän tilaa.
delistedDatedate · nullVahvistettu viimeinen kaupankäyntipäivä. Null, kunnes päivämäärä on vahvistettu.
latestPrice, latestPriceDatenumber, date · nullViimeisin tunnettu kurssi, ei lupaus nykyisestä kaupankäynnistä.
priceStaletrue · false · nullTrue 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.
upsidePctnumber · nullNull, ellei listingStatus ole active ja priceStale false.
GET REQUEST
curl -H "Authorization: Bearer SINUN-AVAIN" \
  "https://www.targetwatch.io/api/v2/stocks/FNOX/targets"
200 OK - FNOX

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