ProREST · v1.0

Innsidehandler, emisjoner og eiere på Oslo Børs som strukturerte data

Meldepliktige handler fra primærinnsidere siden 2016, klassifisert og med kontrollstatus på hver rad. I tillegg emisjoner og hvem av innsiderne som tegnet seg, flaggemeldinger, kontrakter og rapportnotater. Alt er lest ut av børsmeldingene, og hver rad har lenke til meldingen, så tallene kan etterprøves. JSON eller CSV, med API-nøkkel.

transaksjoner siden 2016
42 461
transaksjoner siden 2016
selskaper · 9 805 innsidere
456
selskaper · 9 805 innsidere
nyeste melding i datasettet
13. nov.
nyeste melding i datasettet
rader med lenke til kilden
100 %
rader med lenke til kilden

På to minutter

Kom i gang

  1. 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.
  2. Send nøkkelen i Authorization-headeren på hvert kall.
  3. Alle svar er JSON med samme struktur: data, pagination og meta.
curl
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

GET/api/v1/trades
Søk og bla i alle handler

Returnerer 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). EQNR og EQNR.OL er 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) eller published_at_asc. Likt tidspunkt sorteres på id.
limit1–1000
Rader per side. Standard 100.
cursorstring
Verdien av pagination.next_cursor fra forrige side.
formatenum
json (standard) eller csv.
Svar 200 · eksempel med fiktive verdier
{
  "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

GET/api/v1/trades/{id}
Oppslag på id, også inaktive rader

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

GET/api/v1/issuers
Alle selskaper med aktivitetsoppsummering

Ticker, navn, sektor og siste handel per selskap. has_trades=true gir bare selskaper med minst én handel. Støtter format=csv.

Svar 200 · fiktive verdier
{
  "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

GET/api/v1/persons/{person_key}
Profil, statistikk og handler

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.

Svar 200 · fiktive verdier
{
  "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

GET/api/v1/issuers/{ticker}
Innsidehandler, emisjoner, store eiere, kontrakter og rapportnotat

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.

Svar 200 · forkortet, fiktive verdier
{
  "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

GET/api/v1/equity-raises
Rettede emisjoner, fortrinnsrettsemisjoner, børsnoteringer og blokksalg

Emisjoner 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) eller block_sale (blokksalg), kommaseparert.
statusenum
completed eller cancelled. 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) eller csv.
curl
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"
Svar 200 · fiktive verdier
{
  "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
  }
}

Innsidernes tegning i emisjoner

GET/api/v1/share-issues?ticker=EKS
Hvem som tegnet seg, for hvor mye, og om de solgte etterpå

For ett selskap: emisjonene og tegningene fra innsiderne, gruppert per emisjon siden 2016. For hver innsider får du rolle, antall aksjer, beløp, hvor stor del av beholdningen etterpå tegningen utgjorde, og om innsideren solgte i markedet innen 60 dager. Nærståendes tegning telles på primærinnsideren. Er sell_window_complete false, har ikke 60 dager gått ennå.

ticker er påkrevd. limit 1–200 (standard 40). Bare JSON.

Svar 200 · forkortet, fiktive verdier
{
  "ticker": "EKS.OL",
  "data": [
    {
      "first_day": "2026-10-22",
      "last_day": "2026-10-24",
      "equity_raise": "… som i /equity-raises …",
      "insiders": {
        "insiders": 3,
        "value_nok": 4200000,
        "without_value": 0,
        "ceo": true,
        "cfo": false,
        "chair": true,
        "sold_within_60_days": 0,
        "sell_window_complete": false,
        "participants": [
          {
            "name": "Kari Nordmann",
            "via": [
              "Nordmann Invest AS"
            ],
            "role": "ceo",
            "shares": 250000,
            "value_nok": 2000000,
            "without_value": 0,
            "holding_share": 0.2,
            "sold_within_60_days": false,
            "first_sell_day": null,
            "sell_window_complete": false
          }
        ]
      }
    }
  ],
  "pagination": {
    "limit": 40,
    "returned": 1,
    "total": 6,
    "has_more": false
  },
  "meta": {
    "schema_version": "1.0",
    "generated_at": "2026-11-15T09:15:02.311Z",
    "data_as_of": "2026-11-15T09:01:10.000Z",
    "latest_published_at": "2026-11-14T16:05:00.000Z",
    "equity_raises_available": true,
    "dataset_covers_until": "2026-11-13T07:05:00.000Z",
    "dataset_listed_until": "2026-11-15T05:19:42.000Z"
  }
}

Store eiere (flaggemeldinger)

GET/api/v1/major-holders?ticker=EKS
Flaggemeldinger og eiere over 5 %

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

Svar 200 · fiktive verdier
{
  "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

GET/api/v1/contract-awards?ticker=EKS
Kontrakter, ordrer og intensjonsavtaler selskapet har kunngjort

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

Én kontrakt · fiktive verdier
{
  "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

GET/api/v1/report-notes
Alle publiserte notater, oppsummert
GET/api/v1/report-notes/{ticker}
Ett notat i sin helhet

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

GET/api/v1/status
Ferskhet, uten nøkkel

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

Python · hent alle sider
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:

curl · én gang i døgnet
# É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
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.csv

Datakontrakt

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.

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.

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

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:

Svar 429
{
  "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.

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 Code
claude mcp add --transport http norkvant https://www.norkvant.tech/api/mcp \
  --header "Authorization: Bearer nq_live_DIN_NØKKEL"
Codex (~/.codex/config.toml, nøkkelen i miljøvariabelen NORKVANT_API_KEY)
[mcp_servers.norkvant]
url = "https://www.norkvant.tech/api/mcp"
bearer_token_env_var = "NORKVANT_API_KEY"
Cursor (mcp.json)
{
  "mcpServers": {
    "norkvant": {
      "url": "https://www.norkvant.tech/api/mcp",
      "headers": { "Authorization": "Bearer nq_live_DIN_NØKKEL" }
    }
  }
}
VS Code med GitHub Copilot (.vscode/mcp.json)
{
  "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}" }
    }
  }
}
Windsurf (mcp_config.json)
{
  "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øyHva det gir
search_companiesOgså uten nøkkel, forsinketFinn selskap på navn eller ticker.
company_overviewKrever nøkkelAlt om ett selskap i ett kall: innsidehandler, emisjoner, store eiere, kontrakter og rapportnotat.
insider_tradesOgså uten nøkkel, forsinketInnsidehandler, filtrert på selskap, person, kjøp/salg og dato.
equity_raisesKrever nøkkelEmisjoner og blokksalg siden 2020: kurs, beløp, rabatt, tilretteleggere, lock-up og innsidernes tegning.
share_issuesKrever nøkkelHvem av innsiderne som tegnet seg i hver emisjon, for hvor mye, og om de solgte innen 60 dager.
major_holdersKrever nøkkelFlaggemeldinger per selskap: eier, terskel, andel i aksjer og i instrumenter, og hvem som er over 5 %.
contract_awardsKrever nøkkelKontrakter selskapet har kunngjort: type, verdi, kunde og varighet, og innsidehandler rundt kunngjøringen.
report_notesKrever nøkkelRapportnotater: 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.