På to minutter
Kom i gang
- API-et følger med Pro. Pro-kunder oppretter nøkler under Konto → API-nøkler. Nøkkelen vises én gang; vi lagrer bare en SHA-256-hash.
- Send nøkkelen i
Authorization-headeren på hvert kall. - Alle svar er JSON med samme struktur:
data,paginationogmeta.
export NORKVANT_API_KEY="nq_live_…"
curl -s "https://www.norkvant.tech/api/v1/trades?trade_type=market&min_value_nok=1000000&limit=50" \
-H "Authorization: Bearer $NORKVANT_API_KEY"Basis-URL: https://www.norkvant.tech/api/v1. Kun HTTPS. API-et er laget for server-til-server-bruk; legg aldri nøkkelen i kode som kjører i nettleseren. Maskinlesbar spesifikasjon (OpenAPI 3.1) for Postman, Insomnia eller kodegenerering: /api/v1/openapi.json.
Autentisering
Hver forespørsel må ha Authorization: Bearer nq_live_…. Nøkler har formatet nq_live_ + 40 tegn og er knyttet til et aktivt Pro-abonnement. Når abonnementet avsluttes, svarer API-et 403 plan_required. Du kan ha opptil 10 aktive nøkler (f.eks. én per system) og trekke dem tilbake hver for seg uten å påvirke de andre.
Hvert svar har X-Request-Id. Oppgi den hvis du kontakter oss om et kall.
Endepunkt
Innsidehandler
/api/v1/tradesReturnerer handler sortert på publiseringstidspunkt. Uten filtre får du alle transaksjonstyper; bruk trade_type=market eller market_only=true for kun kjøp og salg i markedet.
- tickerstring
- Én eller flere tickere, kommaseparert (maks 50).
EQNRogEQNR.OLer likeverdige. - personstring
- person_key eller navn. Treffer personens egne handler og handler av nærstående som er knyttet til personen.
- from / toYYYY-MM-DD
- Handelsdato (transaction_date), begge inklusive.
- published_sinceISO 8601
- Publisert (
published_at) ≥ tidspunktet, f.eks.2026-11-08T07:00:00Z. Dato uten klokkeslett betyr 00:00 UTC. - published_beforeISO 8601
- Publisert < tidspunktet.
- trade_typeliste
- Én eller flere transaksjonstyper, kommaseparert.
market=market_buy,market_sell. - market_onlyboolean
- Bare diskresjonære handler i markedet av innsidere (is_market_trade). Utelukker bl.a. selskapets egne kjøp.
- min_value_noktall
- Verdi i NOK ≥ beløpet. Handler uten kjent verdi utelates når filteret er satt.
- include_inactiveboolean
- Ta med rader som er erstattet av en korrigering eller er dubletter (is_active = false). Standard false.
- sortenum
published_at_desc(standard) ellerpublished_at_asc. Likt tidspunkt sorteres på id.- limit1–1000
- Rader per side. Standard 100.
- cursorstring
- Verdien av
pagination.next_cursorfra forrige side. - formatenum
json(standard) ellercsv.
| Parameter | Type | Beskrivelse |
|---|---|---|
| ticker | string | Én eller flere tickere, kommaseparert (maks 50). EQNR og EQNR.OL er likeverdige. |
| person | string | person_key eller navn. Treffer personens egne handler og handler av nærstående som er knyttet til personen. |
| from / to | YYYY-MM-DD | Handelsdato (transaction_date), begge inklusive. |
| published_since | ISO 8601 | Publisert (published_at) ≥ tidspunktet, f.eks. 2026-11-08T07:00:00Z. Dato uten klokkeslett betyr 00:00 UTC. |
| published_before | ISO 8601 | Publisert < tidspunktet. |
| trade_type | liste | Én eller flere transaksjonstyper, kommaseparert. market = market_buy,market_sell. |
| market_only | boolean | Bare diskresjonære handler i markedet av innsidere (is_market_trade). Utelukker bl.a. selskapets egne kjøp. |
| min_value_nok | tall | Verdi i NOK ≥ beløpet. Handler uten kjent verdi utelates når filteret er satt. |
| include_inactive | boolean | Ta med rader som er erstattet av en korrigering eller er dubletter (is_active = false). Standard false. |
| sort | enum | published_at_desc (standard) eller published_at_asc. Likt tidspunkt sorteres på id. |
| limit | 1–1000 | Rader per side. Standard 100. |
| cursor | string | Verdien av pagination.next_cursor fra forrige side. |
| format | enum | json (standard) eller csv. |
{
"data": [
{
"id": "6543210-1",
"message_id": "6543210",
"source_url": "https://newsweb.oslobors.no/message/6543210",
"ticker": "EKS.OL",
"issuer": "Eksempel ASA",
"published_at": "2026-11-06T07:42:18.000Z",
"transaction_date": "2026-11-05",
"person_name": "Kari Nordmann",
"person_key": "kari nordmann",
"person_is_placeholder": false,
"role": "Chief Executive Officer",
"role_group": "ceo",
"role_category": "CEO",
"relationship": "primary_insider",
"associated_with": null,
"trade_type": "market_buy",
"is_market_trade": true,
"shares": 25000,
"price": 48.6,
"currency": "NOK",
"value": 1215000,
"value_nok": 1215000,
"verification_status": "cross_checked",
"validation_flags": [],
"is_active": true,
"norkvant_url": "https://www.norkvant.tech/tickers/EKS.OL"
}
],
"pagination": {
"limit": 1,
"returned": 1,
"total": 412,
"has_more": true,
"next_cursor": "eyJ2IjoxLCJwIjoxNzYyNDE0OTM4MDAwLCJpIjoiNjU0MzIxMC0xIiwicyI6ImRlc2MifQ"
},
"meta": {
"schema_version": "1.0",
"generated_at": "2026-11-08T09:15:02.311Z",
"data_as_of": "2026-11-08T09:14:40.008Z",
"latest_published_at": "2026-11-08T09:11:57.000Z"
}
}Headere: X-Total-Count (antall treff for filteret) og X-Next-Cursor (samme som pagination.next_cursor).
Én handel
/api/v1/trades/{id}Svarer { data: Trade, meta }. Inaktive rader (korrigert eller dublett) returneres med is_active: false, slik at du kan oppdatere egne kopier. Ukjent id gir 404 not_found.
Selskaper
/api/v1/issuersTicker, navn, sektor og siste handel per selskap. has_trades=true gir bare selskaper med minst én handel. Støtter format=csv.
{
"data": [
{
"ticker": "EKS.OL",
"name": "Eksempel ASA",
"sector": "Energy",
"sector_label": "Energi",
"trades_total": 187,
"market_trades_total": 121,
"first_published_at": "2016-02-11T16:03:00.000Z",
"last_published_at": "2026-11-06T07:42:18.000Z",
"last_market_trade_published_at": "2026-11-06T07:42:18.000Z",
"norkvant_url": "https://www.norkvant.tech/tickers/EKS.OL"
}
],
"meta": {
"schema_version": "1.0",
"count": 1,
"data_as_of": "2026-11-08T09:14:40.008Z"
}
}Innsidere
/api/v1/persons/{person_key}person_key fra en handel (URL-kodet, f.eks. kari%20nordmann). Navn fungerer også; det normaliseres likt. Statistikken teller bare kjøp og salg i markedet. Handler av nærstående som er knyttet til personen, er med. Alle filtre fra /trades virker, og standard limit er 1000.
{
"person": {
"person_key": "kari nordmann",
"name": "Kari Nordmann",
"roles": [
"CEO"
],
"companies": [
{
"ticker": "EKS.OL",
"issuer": "Eksempel ASA",
"trades": 9,
"last_published_at": "2026-11-06T07:42:18.000Z"
}
],
"first_published_at": "2019-05-14T06:30:00.000Z",
"last_published_at": "2026-11-06T07:42:18.000Z",
"norkvant_url": "https://www.norkvant.tech/innside/Kari%20Nordmann"
},
"stats": {
"market_buys": 6,
"market_sells": 1,
"buy_value_nok": 4870000,
"sell_value_nok": 900000,
"net_value_nok": 3970000,
"market_trades_without_value": 0,
"other_transactions": 2
},
"data": [
"… handler som i /trades …"
],
"pagination": {
"limit": 1000,
"returned": 9,
"total": 9,
"has_more": false,
"next_cursor": null
}
}Alt om ett selskap
/api/v1/issuers/{ticker}Ett kall gir det vi har om selskapet: innsidernes kjøp og salg i markedet siste 90 og 365 dager med de siste handlene, emisjonene og hvor mange av dem innsiderne tegnet seg i, eierne som var over 5 % ved siste flaggemelding, de siste kontraktene og rapportnotatet når det finnes. Fullstendige lister henter du fra endepunktene under.
En del som ikke kan leses akkurat nå, er null og står i unavailable. Den vises aldri som 0. coverage viser nyeste melding i hvert datasett, og coverage.listed_until når børsmeldingene sist ble lest helt gjennom (se Ferskhet). Ukjent ticker gir 404 not_found.
{
"data": {
"company": {
"ticker": "EKS.OL",
"name": "Eksempel ASA",
"sector": "Energy",
"sector_label": "Energi",
"norkvant_url": "https://www.norkvant.tech/tickers/EKS.OL"
},
"insider_activity": {
"windows": [
{
"window_days": 90,
"market_buys": 6,
"market_sells": 1,
"buy_value_nok": 4870000,
"sell_value_nok": 900000,
"net_value_nok": 3970000,
"buyers": 4,
"sellers": 1,
"leadership_buyers": 3,
"trades_without_value": 0
},
"… 365 dager …"
],
"market_trades_since_2016": 121,
"last_market_buy_published_at": "2026-11-06T07:42:18.000Z",
"last_market_sell_published_at": "2026-08-19T15:02:11.000Z",
"latest_market_trades": [
"… handler som i /trades …"
]
},
"equity_raises": {
"total": 4,
"latest": [
"… som i /equity-raises …"
],
"share_issues_with_insider_subscriptions": 3
},
"major_holders": {
"notifications_total": 17,
"current_holders": [
"… som i /major-holders …"
],
"older_omitted": 0
},
"contract_awards": {
"total": 12,
"latest": [
"… som i /contract-awards …"
]
},
"report_note": null,
"unavailable": [],
"coverage": {
"insider_trades": "2026-11-14T16:05:00.000Z",
"equity_raises": "2026-11-13T07:05:00.000Z",
"major_holders": "2026-11-13T13:23:04.000Z",
"contract_awards": "2026-11-13T10:58:16.000Z",
"listed_until": {
"insider_trades": "2026-11-15T04:50:03.000Z",
"equity_raises": "2026-11-15T05:19:42.000Z",
"major_holders": "2026-11-15T05:39:51.000Z",
"contract_awards": "2026-11-15T05:29:37.000Z"
}
}
},
"meta": {
"schema_version": "1.0",
"generated_at": "2026-11-15T09:15:02.311Z"
}
}Flere datasett
Emisjoner
/api/v1/equity-raisesEmisjoner i selskaper på Oslo Børs siden 2020, nyeste først: tegningskurs, beløp, nye aksjer, rabatt mot siste sluttkurs, tilretteleggere, lock-up og etterfølgende emisjon, slik meldingene oppgir dem. Et tall som ikke besto kontrollen, er null. insider_subscriptions sier hvor mange innsidere som tegnet seg og for hvor mye.
Rabatten er en andel med fortegn: -0.08 betyr at tegningskursen var 8 % under siste sluttkurs før kunngjøringen (ref_date).
- tickerstring
- Én eller flere tickere, kommaseparert (maks 50).
- typeliste
private_placement(rettet emisjon),rights_issue(fortrinnsrettsemisjon),ipo(børsnotering) ellerblock_sale(blokksalg), kommaseparert.- statusenum
completedellercancelled. Avlyste emisjoner har ingen tall.- from / toYYYY-MM-DD
- Dagen emisjonen ble kunngjort (norsk tid), begge inklusive.
- insidersboolean
- Bare emisjoner der minst én innsider tegnet seg.
- limit / offsettall
- Rader per side (1–1000, standard 100) og hvor mange som hoppes over. Neste side:
pagination.next_offset. - formatenum
json(standard) ellercsv.
| Parameter | Type | Beskrivelse |
|---|---|---|
| ticker | string | Én eller flere tickere, kommaseparert (maks 50). |
| type | liste | private_placement (rettet emisjon), rights_issue (fortrinnsrettsemisjon), ipo (børsnotering) eller block_sale (blokksalg), kommaseparert. |
| status | enum | completed eller cancelled. Avlyste emisjoner har ingen tall. |
| from / to | YYYY-MM-DD | Dagen emisjonen ble kunngjort (norsk tid), begge inklusive. |
| insiders | boolean | Bare emisjoner der minst én innsider tegnet seg. |
| limit / offset | tall | Rader per side (1–1000, standard 100) og hvor mange som hoppes over. Neste side: pagination.next_offset. |
| format | enum | json (standard) eller csv. |
curl -s "https://www.norkvant.tech/api/v1/equity-raises?type=private_placement&from=2026-01-01&insiders=true" \
-H "Authorization: Bearer $NORKVANT_API_KEY"{
"data": [
{
"deal_id": "EKS-20261022-6543300",
"ticker": "EKS.OL",
"issuer_name": "Eksempel ASA",
"deal_type": "private_placement",
"status": "completed",
"announced_at": "2026-10-22T14:32:38.000Z",
"announced_day": "2026-10-22",
"offer_price": 8,
"offer_currency": "NOK",
"gross_proceeds": 250000000,
"proceeds_currency": "NOK",
"gross_proceeds_nok": 250000000,
"new_shares": 31250000,
"shares_sold": null,
"seller": null,
"discount_last_close": -0.1111,
"discount_vwap5": -0.0942,
"ref_date": "2026-10-22",
"managers": [
"Eksempel Securities",
"Fiktiv Bank"
],
"lockup_terms": [
{
"days": 90,
"parties": [
"company"
]
},
{
"days": 180,
"parties": [
"board",
"management"
]
}
],
"so_status": "proposed",
"insider_subscriptions": {
"insiders": 3,
"value_nok": 4200000,
"without_value": 0
},
"source_url": "https://newsweb.oslobors.no/message/6543300",
"messages": [
{
"message_id": 6543300,
"day": "2026-10-22",
"title": "Eksempel ASA: Contemplated private placement",
"source_url": "https://newsweb.oslobors.no/message/6543300"
}
],
"norkvant_url": "https://www.norkvant.tech/tickers/EKS.OL"
}
],
"pagination": {
"limit": 1,
"offset": 0,
"returned": 1,
"total": 212,
"has_more": true,
"next_offset": 1
},
"meta": {
"schema_version": "1.0",
"generated_at": "2026-11-15T09:15:02.311Z",
"data_as_of": "2026-11-15T09:01:10.000Z",
"dataset_covers_until": "2026-11-13T07:05:00.000Z",
"dataset_listed_until": "2026-11-15T05:19:42.000Z",
"insider_subscriptions_known": true
}
}Store eiere (flaggemeldinger)
/api/v1/major-holders?ticker=EKSFlaggemeldingene for ett selskap siden 2016, nyeste først: eier, terskel og retning, andel i aksjer, i finansielle instrumenter og totalt (prosent, 5 = 5 %). current_holders er eierne som var over 5 % ved sin siste melding, når den er yngre enn tre år. Det er det eierne har meldt, ikke dagens aksjonærregister.
ticker er påkrevd. limit 1–1000 (standard 100). format=csv gir meldingene.
{
"ticker": "EKS.OL",
"current_holders": [
{
"holder_name": "Fiktiv Kapital AS",
"holder_key": "fiktiv kapital as",
"position_pct": 10.2,
"shares_pct": 10.2,
"instruments_pct": null,
"over_threshold_pct": null,
"as_of_day": "2026-09-12",
"message_id": 6540001,
"source_url": "https://newsweb.oslobors.no/message/6540001",
"notifications": 4,
"holder_is_person": false,
"holder_is_bank_broker": false
}
],
"older_omitted": 0,
"data": [
{
"notification_id": "6540001-0",
"message_id": 6540001,
"source_url": "https://newsweb.oslobors.no/message/6540001",
"ticker": "EKS.OL",
"published_at": "2026-09-14T06:30:00.000Z",
"published_day": "2026-09-14",
"holder_name": "Fiktiv Kapital AS",
"holder_key": "fiktiv kapital as",
"holder_type": "legal_entity",
"holder_class": null,
"crossing_date": "2026-09-12",
"lag_days": 2,
"threshold_pct": 10,
"direction": "up",
"threshold_basis": "total",
"shares_pct": 10.2,
"instruments_pct": null,
"total_pct": 10.2,
"total_lt": null,
"prev_total_pct": 9.6,
"n_shares": 5100000,
"instrument_types": [],
"chain": []
}
],
"pagination": {
"limit": 100,
"returned": 1,
"total": 17,
"has_more": true
},
"meta": {
"schema_version": "1.0",
"generated_at": "2026-11-15T09:15:02.311Z",
"dataset_covers_until": "2026-11-13T13:23:04.000Z",
"dataset_listed_until": "2026-11-15T05:39:51.000Z"
}
}Kontrakter
/api/v1/contract-awards?ticker=EKSKontraktene ett selskap har kunngjort siden 2020, nyeste først: type, verdi slik den er oppgitt (et intervall, et gulv eller selskapets egen størrelsesklasse, se value_basis), kunde og varighet når de er oppgitt.
insider_proximity teller innsidernes kjøp og salg i markedet i selskapet 30 hverdager før og etter kunngjøringen. Det sier at handlene skjedde, ikke hvorfor. ticker er påkrevd, limit 1–300 (standard 100), og format=csv støttes.
{
"message_id": 6541200,
"source_url": "https://newsweb.oslobors.no/message/6541200",
"ticker": "EKS.OL",
"published_at": "2026-11-03T06:45:00.000Z",
"published_day": "2026-11-03",
"title": "Eksempel ASA awarded contract with Fiktiv Energi",
"contract_type": "contract",
"value_low": 50000000,
"value_high": 150000000,
"currency": "USD",
"value_nok_low": 545000000,
"value_nok_high": 1635000000,
"value_basis": "issuer_definition",
"value_approx": false,
"duration_months": 36,
"clients": [
"Fiktiv Energi"
],
"insider_proximity": {
"window_weekdays": 30,
"buys_before": 1,
"sells_before": 0,
"buys_after": 2,
"sells_after": 0
}
}Rapportnotater
/api/v1/report-notes/api/v1/report-notes/{ticker}Kvartalsrapporten målt mot terskler som ble satt kvelden før, ut fra selskapets egne tidligere dokumenter. Hvert tall har sidehenvisning. Oppsummeringen gir antall tall bedre, innenfor og svakere enn området, guidingen og aksjen mot OSEBX på reaksjonsdagen i prosentpoeng. Notatet selv har norske feltnavn: kveld (kveldsnotatet), morgen (morgennotatet), analyse (vår lesning) og reaction. Foreløpig finnes notater for noen få selskaper; se Rapportnotater.
Status
/api/v1/statusÅpent endepunkt for overvåking. Returnerer data_as_of (når datasettet sist ble oppdatert fra databasen), latest_published_at (nyeste publiserte handel) og datasets: for innsidehandel, emisjoner, store eiere og kontrakter nyeste melding (newest_published_at) og når børsmeldingene sist ble lest helt gjennom (listed_until). Telles ikke mot kvoten.
Paginering og synkronisering
Paginering er cursor-basert (keyset) på (published_at, id). Nye handler som kommer inn mens du blar, forskyver ikke sidene, og ingen rad returneres to ganger. Cursoren er knyttet til sorteringen den ble laget med.
import os, time, requests
BASE = "https://www.norkvant.tech/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['NORKVANT_API_KEY']}"}
def fetch_all(**params):
"""Henter alle sider for et filter. Keyset-paginering: ingen hull eller dubletter."""
params = {"limit": 1000, **params}
while True:
r = requests.get(f"{BASE}/trades", headers=HEADERS, params=params, timeout=30)
if r.status_code == 429:
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
body = r.json()
yield from body["data"]
cursor = body["pagination"]["next_cursor"]
if not cursor:
break
params["cursor"] = cursor
# Alle kjøp i markedet siste døgn, eldste først
for t in fetch_all(trade_type="market_buy", published_since="2026-11-07T00:00:00Z",
sort="published_at_asc"):
print(t["published_at"], t["ticker"], t["person_name"], t["value_nok"], t["source_url"])Inkrementell synk
Filteret published_since gjelder publiseringstidspunktet (published_at), ikke når raden kom inn hos oss. En melding som behandles sent, eller en korrigering som kommer senere, havner derfor ikke alltid i et kort vindu. Hent med et romslig, overlappende vindu, ta med inaktive rader, og oppdater din kopi på id:
# Én gang om morgenen: siste 48 timer (normalt én side). Upsert på id.
SINCE=$(date -u -v-48H +%Y-%m-%dT%H:%M:%SZ) # GNU: date -u -d '48 hours ago' +%FT%TZ
curl -s "https://www.norkvant.tech/api/v1/trades?published_since=$SINCE&sort=published_at_asc&include_inactive=true&limit=1000" \
-H "Authorization: Bearer $NORKVANT_API_KEY"
# En gang i døgnet: siste 90 dager, for korrigeringer av eldre meldinger.
SINCE=$(date -u -v-90d +%Y-%m-%dT00:00:00Z) # GNU: date -u -d '90 days ago' +%FT00:00:00Z- Ny id → sett inn. Kjent id → oppdater alle feltene.
- En korrigering kommer som en ny rad med ny id, og den opprinnelige raden får is_active = false. Den opprinnelige raden kan være publisert lenge før vinduet ditt. Derfor gjør den daglige 90-dagerssynken at inaktiveringen også når din kopi.
- Én side på 1000 rader dekker normalt flere uker med handler, så dette bruker en liten del av kvoten.
CSV
Legg til format=csv på /trades, /issuers, /persons/…, /equity-raises, /major-holders eller /contract-awards. Filen er UTF-8 med BOM (åpnes riktig i Excel), komma som skilletegn og samme kolonnenavn som JSON-feltene. Lister som validation_flags og managers er skilt med |. Tekst som starter med =, +, - eller @ får en apostrof foran, slik at regneark aldri tolker innhold fra børsmeldinger som formler. Paginer med X-Next-Cursor.
curl -s "https://www.norkvant.tech/api/v1/trades?ticker=EKS,ABC&from=2025-01-01&format=csv&limit=1000" \
-H "Authorization: Bearer $NORKVANT_API_KEY" -o innsidehandler.csvDatakontrakt
Felter i en handel
Feltene under er stabile i v1.0. Datoer er ISO 8601 i UTC. Tall er JSON-tall (ikke strenger); ukjente verdier er null, aldri 0.
- idstring
- Stabil id for raden: «<message_id>-<linjenummer>» for nye rader. Bruk den til deduplisering.
- message_idstring | null
- Newsweb-meldingens id.
- source_urlstring | null
- Lenke til børsmeldingen på newsweb.oslobors.no. Kilden for alle tall i raden.
- tickerstring
- Oslo Børs-ticker med suffiks, f.eks. EQNR.OL.
- issuerstring
- Selskapets registrerte navn.
- published_atISO 8601 (UTC)
- Tidspunktet Newsweb publiserte meldingen. Dette er tidspunktet informasjonen ble offentlig.
- transaction_dateYYYY-MM-DD | null
- Handelsdato oppgitt av innsideren.
- person_namestring
- Navnet i meldingen. Gruppeposter vises som f.eks. «Flere primærinnsidere».
- person_keystring | null
- Normalisert identitetsnøkkel (små bokstaver, uten aksenter). null for gruppeposter. Brukes i /persons/{person_key}.
- person_is_placeholderboolean
- true når meldingen ikke navngir én person.
- rolestring | null
- Rolle slik den står i meldingen.
- role_groupenum
- Normalisert rolle:
chair,ceo,cfo,board,deputy,exec,employee,associate,company,insider. - role_categorystring | null
- Rollekategori fra uttrekket (CEO, CFO, Chair, Board, Executive, Employee, Other). null på eldre rader.
- relationshipenum | null
- primary_insider (primærinnsider), closely_associated (nærstående person eller selskap) eller issuer (selskapet selv). null når meldingen ikke oppgir det.
- associated_withstring | null
- For nærstående: primærinnsideren handelen knyttes til.
- trade_typeenum
- Se transaksjonstyper.
- is_market_tradeboolean
- true for kjøp/salg i markedet av en innsider for egen regning. Bare disse telles som kjøp og salg i statistikk; tildelinger og opsjoner gjør ikke det. Meldte kjøp/salg som er skilt ut (se market_exclusion), har false.
- market_exclusionstring | null
- Hvorfor et meldt kjøp/salg ikke telles: mirror_pair (overføring, ikke to markedshandler), off_market_suspected (for stor til å ha skjedd i markedet), allocation_suspected (fordeling til flere eiere: emisjon, tilbud eller aksjeprogram), price_disputed (kurs avviker vesentlig fra børskurs). Se /metode#ikke-telt.
- holdings_afternumber | null
- Beholdning etter handelen slik meldingen oppgir den. null når meldingen ikke oppgir den eller raden ikke er prosessert på nytt.
- sharesnumber | null
- Antall aksjer/instrumenter.
- pricenumber | null
- Pris per aksje i currency. null når meldingen ikke oppgir pris.
- currencystring
- ISO 4217-valuta for price og value.
- valuenumber | null
- Handelsverdi i currency (oppgitt totalverdi, ellers shares × price).
- value_noknumber | null
- Verdi i NOK. Utenlandsk valuta regnes om med Norges Banks kurs for handelsdagen (siste bankdag før, ved helg og helligdag). null når verdien ikke kan fastslås – vi gjetter aldri.
- verification_statusenum
- Se kontrollstatus.
- validation_flagsstring[]
- Automatiske kontroller som slo ut, se kontrollstatus.
- is_activeboolean
- false når raden er erstattet av en korrigering eller er en dublett (samme handel meldt på norsk og engelsk). Inaktive rader returneres bare med include_inactive=true.
- norkvant_urlstring
- Selskapssiden på Norkvant.
| Felt | Type | Beskrivelse |
|---|---|---|
| id | string | Stabil id for raden: «<message_id>-<linjenummer>» for nye rader. Bruk den til deduplisering. |
| message_id | string | null | Newsweb-meldingens id. |
| source_url | string | null | Lenke til børsmeldingen på newsweb.oslobors.no. Kilden for alle tall i raden. |
| ticker | string | Oslo Børs-ticker med suffiks, f.eks. EQNR.OL. |
| issuer | string | Selskapets registrerte navn. |
| published_at | ISO 8601 (UTC) | Tidspunktet Newsweb publiserte meldingen. Dette er tidspunktet informasjonen ble offentlig. |
| transaction_date | YYYY-MM-DD | null | Handelsdato oppgitt av innsideren. |
| person_name | string | Navnet i meldingen. Gruppeposter vises som f.eks. «Flere primærinnsidere». |
| person_key | string | null | Normalisert identitetsnøkkel (små bokstaver, uten aksenter). null for gruppeposter. Brukes i /persons/{person_key}. |
| person_is_placeholder | boolean | true når meldingen ikke navngir én person. |
| role | string | null | Rolle slik den står i meldingen. |
| role_group | enum | Normalisert rolle: chair, ceo, cfo, board, deputy, exec, employee, associate, company, insider. |
| role_category | string | null | Rollekategori fra uttrekket (CEO, CFO, Chair, Board, Executive, Employee, Other). null på eldre rader. |
| relationship | enum | null | primary_insider (primærinnsider), closely_associated (nærstående person eller selskap) eller issuer (selskapet selv). null når meldingen ikke oppgir det. |
| associated_with | string | null | For nærstående: primærinnsideren handelen knyttes til. |
| trade_type | enum | Se transaksjonstyper. |
| is_market_trade | boolean | true for kjøp/salg i markedet av en innsider for egen regning. Bare disse telles som kjøp og salg i statistikk; tildelinger og opsjoner gjør ikke det. Meldte kjøp/salg som er skilt ut (se market_exclusion), har false. |
| market_exclusion | string | null | Hvorfor et meldt kjøp/salg ikke telles: mirror_pair (overføring, ikke to markedshandler), off_market_suspected (for stor til å ha skjedd i markedet), allocation_suspected (fordeling til flere eiere: emisjon, tilbud eller aksjeprogram), price_disputed (kurs avviker vesentlig fra børskurs). Se /metode#ikke-telt. |
| holdings_after | number | null | Beholdning etter handelen slik meldingen oppgir den. null når meldingen ikke oppgir den eller raden ikke er prosessert på nytt. |
| shares | number | null | Antall aksjer/instrumenter. |
| price | number | null | Pris per aksje i currency. null når meldingen ikke oppgir pris. |
| currency | string | ISO 4217-valuta for price og value. |
| value | number | null | Handelsverdi i currency (oppgitt totalverdi, ellers shares × price). |
| value_nok | number | null | Verdi i NOK. Utenlandsk valuta regnes om med Norges Banks kurs for handelsdagen (siste bankdag før, ved helg og helligdag). null når verdien ikke kan fastslås – vi gjetter aldri. |
| verification_status | enum | Se kontrollstatus. |
| validation_flags | string[] | Automatiske kontroller som slo ut, se kontrollstatus. |
| is_active | boolean | false når raden er erstattet av en korrigering eller er en dublett (samme handel meldt på norsk og engelsk). Inaktive rader returneres bare med include_inactive=true. |
| norkvant_url | string | Selskapssiden på Norkvant. |
Transaksjonstyper
Hver transaksjon klassifiseres fra MAR-skjemaet. Bare market_buy og market_sell er kjøp og salg i markedet. Tildelinger, opsjonsinnløsning, aksjesparing og tegning i emisjoner er egne typer og telles ikke som kjøp i markedet.
- market_buyKjøp i markedet
- Innsideren har kjøpt aksjer i det åpne markedet (børs eller MTF) for egne midler.
- market_sellSalg i markedet
- Innsideren har solgt aksjer i det åpne markedet.
- subscriptionTegning
- Tegning av nye aksjer i en emisjon eller rettet plassering, ikke kjøp i markedet.
- grantTildeling
- Tildeling av aksjer, opsjoner eller rettigheter som del av et insentivprogram.
- exerciseInnløsning av opsjoner
- Innløsning/utøvelse av opsjoner eller tegningsretter.
- vestingOpptjening (RSU/PSU)
- Aksjer mottatt når betingede aksjeenheter (RSU/PSU) opptjenes.
- share_savingsAksjesparing
- Kjøp gjennom selskapets aksjespareprogram for ansatte.
- dividend_reinvestmentUtbytte i aksjer
- Aksjer mottatt som utbytte eller ved reinvestering av utbytte.
- transferOverføring
- Overføring mellom innsiderens egne selskaper/kontoer eller til nærstående, uten markedshandel.
- gift_inheritanceGave/arv
- Aksjer gitt bort eller mottatt som gave eller arv.
- lendingAksjelån
- Utlån eller tilbakelevering av aksjer i en aksjelånsavtale.
- pledgePantsettelse
- Aksjer stilt som sikkerhet (pant).
- conversionKonvertering
- Konvertering av et instrument til aksjer (f.eks. konvertibelt lån).
- derivativeDerivat
- Handel i derivater (f.eks. TRS, opsjoner) knyttet til aksjen.
- otherAnnen transaksjon
- Transaksjon som ikke passer i noen av kategoriene over.
| trade_type | Norsk | Definisjon |
|---|---|---|
| market_buy | Kjøp i markedet | Innsideren har kjøpt aksjer i det åpne markedet (børs eller MTF) for egne midler. |
| market_sell | Salg i markedet | Innsideren har solgt aksjer i det åpne markedet. |
| subscription | Tegning | Tegning av nye aksjer i en emisjon eller rettet plassering, ikke kjøp i markedet. |
| grant | Tildeling | Tildeling av aksjer, opsjoner eller rettigheter som del av et insentivprogram. |
| exercise | Innløsning av opsjoner | Innløsning/utøvelse av opsjoner eller tegningsretter. |
| vesting | Opptjening (RSU/PSU) | Aksjer mottatt når betingede aksjeenheter (RSU/PSU) opptjenes. |
| share_savings | Aksjesparing | Kjøp gjennom selskapets aksjespareprogram for ansatte. |
| dividend_reinvestment | Utbytte i aksjer | Aksjer mottatt som utbytte eller ved reinvestering av utbytte. |
| transfer | Overføring | Overføring mellom innsiderens egne selskaper/kontoer eller til nærstående, uten markedshandel. |
| gift_inheritance | Gave/arv | Aksjer gitt bort eller mottatt som gave eller arv. |
| lending | Aksjelån | Utlån eller tilbakelevering av aksjer i en aksjelånsavtale. |
| pledge | Pantsettelse | Aksjer stilt som sikkerhet (pant). |
| conversion | Konvertering | Konvertering av et instrument til aksjer (f.eks. konvertibelt lån). |
| derivative | Derivat | Handel i derivater (f.eks. TRS, opsjoner) knyttet til aksjen. |
| other | Annen transaksjon | Transaksjon som ikke passer i noen av kategoriene over. |
Kontrollstatus og flagg
Alle rader har verification_status. Tallene hentes fra det offisielle MAR-skjemaet i børsmeldingen og kontrolleres mot markedskurs og selve meldingen. Les mer under Metode.
- source_verified
- Kontrollert mot kilden. Hvert felt kontrollert mot skjemaet i børsmeldingen. Ikke i bruk ennå.
- cross_checked
- Pris bekreftet. Kjøp eller salg i markedet der prisen innsideren oppgir, stemmer med børskursen rundt handelsdatoen, og ingen andre kontroller slo ut.
- auto
- Lest fra meldingen. Tallene står slik de er lest ut av børsmeldingen. Prisen er ikke bekreftet mot børskursen: transaksjonen er ikke et kjøp eller salg i markedet, prisen eller børskursen mangler, eller en annen kontroll slo ut.
- disputed
- Pris avviker. Prisen innsideren oppgir, avviker kraftig fra børskursen rundt handelsdatoen. Feilen kan ligge i meldingen eller i vår lesing av den, så handelen telles ikke. Sjekk børsmeldingen.
- unverified
- Ikke kontrollert. Eldre rad som ikke er lest på nytt med dagens metode. Kontrollene er ikke kjørt. Sjekk børsmeldingen.
| verification_status | Betydning |
|---|---|
| source_verified | Kontrollert mot kilden. Hvert felt kontrollert mot skjemaet i børsmeldingen. Ikke i bruk ennå. |
| cross_checked | Pris bekreftet. Kjøp eller salg i markedet der prisen innsideren oppgir, stemmer med børskursen rundt handelsdatoen, og ingen andre kontroller slo ut. |
| auto | Lest fra meldingen. Tallene står slik de er lest ut av børsmeldingen. Prisen er ikke bekreftet mot børskursen: transaksjonen er ikke et kjøp eller salg i markedet, prisen eller børskursen mangler, eller en annen kontroll slo ut. |
| disputed | Pris avviker. Prisen innsideren oppgir, avviker kraftig fra børskursen rundt handelsdatoen. Feilen kan ligge i meldingen eller i vår lesing av den, så handelen telles ikke. Sjekk børsmeldingen. |
| unverified | Ikke kontrollert. Eldre rad som ikke er lest på nytt med dagens metode. Kontrollene er ikke kjørt. Sjekk børsmeldingen. |
- price_off_market
- Pris avviker fra børskursen
- price_split_ratio
- Prisavviket tilsvarer en aksjesplitt
- date_after_publish
- Handelsdato etter publisering
- date_old
- Handelsdato over 60 dager før publisering
- missing_price
- Pris mangler
- missing_date
- Handelsdato mangler
- missing_transaction_date
- Handelsdato mangler
- zero_shares
- Antall mangler
- missing_volume
- Antall mangler
- fx_missing
- Valutakurs mangler
- currency_unknown
- Ukjent valuta
- low_confidence
- Usikker lesing av meldingen
- number_mismatch
- Tall stemmer ikke med meldingen
- aggregate_mismatch
- Delhandler summerer ikke
- source_conflict
- Meldingstekst og skjema er uenige
- person_unresolved
- Uklar person
- unknown_person
- Uklar person
- legacy_action_mapping
- Transaksjonstype fra eldre lesing, ikke lest på nytt
- aggregated
- Flere delhandler slått sammen
- value_outlier
- Uvanlig stor verdi
| validation_flags | Betydning |
|---|---|
| price_off_market | Pris avviker fra børskursen |
| price_split_ratio | Prisavviket tilsvarer en aksjesplitt |
| date_after_publish | Handelsdato etter publisering |
| date_old | Handelsdato over 60 dager før publisering |
| missing_price | Pris mangler |
| missing_date | Handelsdato mangler |
| missing_transaction_date | Handelsdato mangler |
| zero_shares | Antall mangler |
| missing_volume | Antall mangler |
| fx_missing | Valutakurs mangler |
| currency_unknown | Ukjent valuta |
| low_confidence | Usikker lesing av meldingen |
| number_mismatch | Tall stemmer ikke med meldingen |
| aggregate_mismatch | Delhandler summerer ikke |
| source_conflict | Meldingstekst og skjema er uenige |
| person_unresolved | Uklar person |
| unknown_person | Uklar person |
| legacy_action_mapping | Transaksjonstype fra eldre lesing, ikke lest på nytt |
| aggregated | Flere delhandler slått sammen |
| value_outlier | Uvanlig stor verdi |
Nye flagg kan komme. Behandle ukjente verdier som «sjekk børsmeldingen».
Ratebegrensning og kvoter
- Per nøkkel per minutt60
X-RateLimit-Limit / -Remaining / -Reset- Per nøkkel per døgn (UTC)50 000
X-Quota-Limit / X-Quota-Remaining- Rader per side1 000
- –
| Grense | Verdi | Header |
|---|---|---|
| Per nøkkel per minutt | 60 | X-RateLimit-Limit / -Remaining / -Reset |
| Per nøkkel per døgn (UTC) | 50 000 | X-Quota-Limit / X-Quota-Remaining |
| Rader per side | 1 000 | – |
Over grensen svarer API-et 429 med Retry-After i sekunder. Hele historikken (alle handler siden 2016) kan hentes på under ett minutt med 1000 rader per side. Trenger dere høyere grenser, ta kontakt.
Feilkoder
Feil har alltid samme form, med en stabil maskinlesbar code:
{
"error": {
"code": "rate_limited",
"message": "For mange forespørsler per minutt.",
"status": 429,
"request_id": "3f1c9a7e-2b8d-4c51-9e0f-6a7d2c4b8e11",
"docs": "https://www.norkvant.tech/api-dokumentasjon#feil"
}
}- 401missing_api_key
- Mangler API-nøkkel. Send «Authorization: Bearer nq_live_…».
- 401invalid_api_key
- Ugyldig API-nøkkel.
- 401revoked_api_key
- API-nøkkelen er trukket tilbake.
- 401expired_api_key
- API-nøkkelen er utløpt.
- 403plan_required
- API-tilgang krever et aktivt Pro-abonnement.
- 400invalid_parameter
- Ugyldig parameter.
- 404not_found
- Fant ikke ressursen.
- 429rate_limited
- For mange forespørsler per minutt.
- 429quota_exceeded
- Dagskvoten for API-nøkkelen er brukt opp.
- 429too_many_failed_attempts
- For mange mislykkede autentiseringsforsøk. Vent litt.
- 503api_unavailable
- API-et er ikke aktivert ennå (databaseoppsett mangler). Kontakt oss hvis dette vedvarer.
- 503data_unavailable
- Dataene er midlertidig utilgjengelige. Prøv igjen om litt.
- 500internal_error
- Uventet feil. Prøv igjen, eller kontakt oss med request_id.
| HTTP | code | Betydning |
|---|---|---|
| 401 | missing_api_key | Mangler API-nøkkel. Send «Authorization: Bearer nq_live_…». |
| 401 | invalid_api_key | Ugyldig API-nøkkel. |
| 401 | revoked_api_key | API-nøkkelen er trukket tilbake. |
| 401 | expired_api_key | API-nøkkelen er utløpt. |
| 403 | plan_required | API-tilgang krever et aktivt Pro-abonnement. |
| 400 | invalid_parameter | Ugyldig parameter. |
| 404 | not_found | Fant ikke ressursen. |
| 429 | rate_limited | For mange forespørsler per minutt. |
| 429 | quota_exceeded | Dagskvoten for API-nøkkelen er brukt opp. |
| 429 | too_many_failed_attempts | For mange mislykkede autentiseringsforsøk. Vent litt. |
| 503 | api_unavailable | API-et er ikke aktivert ennå (databaseoppsett mangler). Kontakt oss hvis dette vedvarer. |
| 503 | data_unavailable | Dataene er midlertidig utilgjengelige. Prøv igjen om litt. |
| 500 | internal_error | Uventet feil. Prøv igjen, eller kontakt oss med request_id. |
400 invalid_parameter har i tillegg param med navnet på parameteren som var feil.
Ferskhet og varsler
Nye børsmeldinger leses inn én gang i døgnet, tidlig om morgenen. En handel som publiseres i dag, er dermed i datasettet neste morgen. Faktisk ferskhet, nyeste melding og siste innhenting vises live på /datakvalitet, og meta.data_as_of viser når datasettet sist ble oppdatert.
Emisjoner, flaggemeldinger og kontrakter leses inn fra børsmeldingene i egne kjøringer. Svarene sier derfor hvor langt hvert datasett rekker: meta.dataset_listed_until er når børsmeldingene sist ble lest helt gjennom, og meta.dataset_covers_until er nyeste melding i datasettet. I /issuers/{ticker} står det samme i coverage og coverage.listed_until, og i /status under datasets. Er dataset_listed_until fersk, har det ikke kommet nyere meldinger. Er den gammel, er nyere meldinger ikke lest inn ennå. Hvor ferskt hvert datasett er nå, står på /datakvalitet.
Med Pro kan du sette opp e-postvarsler for egen watchlist (selskaper og innsidere), for alle handler over et beløp i hele markedet, og når flere innsidere kjøper i samme selskap innen 7 dager (under Konto). Utsendingen er ikke startet ennå; vi sier fra når den er i drift.
Datalisens
Børsmeldingene er offentlige. Det dere lisensierer, er Norkvants strukturering: uttrekk fra MAR-skjemaene, flaggemeldingene og emisjons- og kontraktsmeldingene, klassifisering, NOK-omregning, korrigeringskoblinger, dublettkontroll og kontrollstatus.
- Pro gir rett til intern bruk, for deg selv eller i virksomheten din: analyse, modeller, interne rapporter og beslutningsstøtte. Prisen er 20 000 kr/år eks. mva. (25 000 kr inkl. mva.).
- Videredistribusjon av rådata til tredjeparter, publisering eller videresalg krever egen avtale.
- Ved sitat i rapporter: «Kilde: Norkvant, basert på børsmeldinger publisert på Oslo Børs Newsweb».
- Dataene er fakta fra offentliggjorte meldinger, ikke investeringsråd. Kontroller alltid børsmeldingen (
source_url) før beslutninger. Se vilkårene.
Nytt
MCP for AI-assistenter
Med MCP (Model Context Protocol) kan AI-assistenten du allerede bruker, slå opp i Norkvant-dataene selv. Spør for eksempel «hvilke selskaper har hentet penger siste halvår, og har innsiderne kjøpt etterpå?», og assistenten henter svarene fra kilden og kan sette dem opp som tabell, graf eller dashboard.
Adresse: https://www.norkvant.tech/api/mcp (Streamable HTTP). Det er to måter å koble til på.
Med API-nøkkel: alle åtte verktøy, uten forsinkelse
For assistenter som kan sende en nøkkel i en header: Claude Code, Codex, Cursor, VS Code med GitHub Copilot og Windsurf. Du bruker samme API-nøkkel som for resten av API-et, og hvert kall teller mot de samme grensene.
claude mcp add --transport http norkvant https://www.norkvant.tech/api/mcp \
--header "Authorization: Bearer nq_live_DIN_NØKKEL"[mcp_servers.norkvant]
url = "https://www.norkvant.tech/api/mcp"
bearer_token_env_var = "NORKVANT_API_KEY"{
"mcpServers": {
"norkvant": {
"url": "https://www.norkvant.tech/api/mcp",
"headers": { "Authorization": "Bearer nq_live_DIN_NØKKEL" }
}
}
}{
"inputs": [
{ "type": "promptString", "id": "norkvant-key", "description": "Norkvant API-nøkkel", "password": true }
],
"servers": {
"norkvant": {
"type": "http",
"url": "https://www.norkvant.tech/api/mcp",
"headers": { "Authorization": "Bearer ${input:norkvant-key}" }
}
}
}{
"mcpServers": {
"norkvant": {
"serverUrl": "https://www.norkvant.tech/api/mcp",
"headers": { "Authorization": "Bearer nq_live_DIN_NØKKEL" }
}
}
}Uten nøkkel: åpen tilkobling med forsinkede data
ChatGPT- og Claude-appene tar ikke imot en API-nøkkel, bare en serveradresse. Legg til en egen MCP-server i appen og lim inn adressen over, uten pålogging. Da får assistenten det samme som gratisversjonen av nettsiden viser: selskapssøk, hele historikken for ett selskap, og de 50 nyeste handlene i markedet publisert for 1–30 dager siden. Alt kommer 24 timer etter publisering. De andre verktøyene krever nøkkel. Den åpne tilkoblingen er under utprøving: den følger kravene i appenes dokumentasjon, men vi har ikke testet den i hver app ennå.
| Verktøy | Hva det gir |
|---|---|
search_companiesOgså uten nøkkel, forsinket | Finn selskap på navn eller ticker. |
company_overviewKrever nøkkel | Alt om ett selskap i ett kall: innsidehandler, emisjoner, store eiere, kontrakter og rapportnotat. |
insider_tradesOgså uten nøkkel, forsinket | Innsidehandler, filtrert på selskap, person, kjøp/salg og dato. |
equity_raisesKrever nøkkel | Emisjoner og blokksalg siden 2020: kurs, beløp, rabatt, tilretteleggere, lock-up og innsidernes tegning. |
share_issuesKrever nøkkel | Hvem av innsiderne som tegnet seg i hver emisjon, for hvor mye, og om de solgte innen 60 dager. |
major_holdersKrever nøkkel | Flaggemeldinger per selskap: eier, terskel, andel i aksjer og i instrumenter, og hvem som er over 5 %. |
contract_awardsKrever nøkkel | Kontrakter selskapet har kunngjort: type, verdi, kunde og varighet, og innsidehandler rundt kunngjøringen. |
report_notesKrever nøkkel | Rapportnotater: kvartalsrapporten målt mot terskler satt kvelden før, tall for tall. |
Verktøyene leser bare og gir de samme feltene som REST-API-et. Hver rad har lenke til børsmeldingen, og felter som ikke er kontrollert, er tomme. For et bredt spørsmål om ett selskap bruker assistenten company_overview først.
Versjonering og endringer
v1.0 er stabil. Vi kan legge til nye felter, parametere, transaksjonstyper og flagg, men vi endrer ikke navn eller betydning på eksisterende felter. Klienter bør derfor ignorere ukjente felter. Brytende endringer kommer som en ny versjon (/api/v2) og varsles på e-post til kunder med API-nøkkel i god tid. Svarene har X-Api-Version.
Klar til å koble på?
API-et, MCP, CSV og e-postvarsler (utsending starter snart) følger med Pro: 20 000 kr/år eks. mva. (25 000 kr inkl. mva.). Pro selges direkte, så ta kontakt og fortell hva dere skal bruke dataene til. Trenger dere flere brukere, høyere grenser eller historiske leveranser, finner vi en avtale.