Dokumentation

Kom igång med BörsAPI.se. Hämta finansiell data i standardiserat JSON-format.

Introduktion

BörsAPI erbjuder ett modernt REST-gränssnitt för att hämta standardiserade finansiella rapporter från noterade bolag i Sverige. API:et är byggt för utvecklare, analytiker och hobbyinvesterare som vill bygga egna screener-verktyg, finansiella modeller eller databaser.

Marknadstäckning

För närvarande täcks enbart svenska bolag noterade på Nasdaq Stockholm huvudlista (Large, Mid och Small Cap). Mindre listor som First North, Spotlight och NGM stöds inte för tillfället.

Datakvalitet & Beta

Årsrapporter (hämtade via ESEF/iXBRL) har högsta tillförlitlighet. Kvartalsrapporter tolkas via en AI-driven pipeline baserad på PDF-text och är under aktiv utveckling (Beta).

Autentisering

För att göra anrop mot API:et behöver du en API-nyckel. Registrera ett konto gratis på BörsAPI.se för att generera din nyckel från din personliga dashboard.

API-nyckeln ska skickas med i varje HTTP-anrop i Authorization-headern med formatet Bearer <nyckel>:

Authorization: Bearer fd_dina_api_nyckel_här

Rate Limiting (Anropsbegränsning)

Under vår beta-period erbjuder vi ett generöst gratiskonto. Följande regler gäller:

Du får göra anrop motsvarande totalt 500 rapporter per kalenderdygn (återställs vid midnatt svensk tid).
Kostnad per rapport: Varje enskild finansiell rapport som returneras i ditt API-svar räknas som 1 anrop mot gränsen.
Exempel: Om du gör en sökning på ett bolag och hämtar 15 historiska rapporter i en lista dras 15 enheter från din dagliga kvot om 500. Att hämta en specifik rapport för en specifik period kostar 1.
Allmänna endpoints (som att lista bolag) kostar 1 anrop totalt.

Viktiga konventioner

För att göra det enkelt att summera och räkna på siffrorna i resultaträkningen, balansräkningen och kassaflödesanalysen har vi en strikt teckenkonvention:

Teckenregler för alla rapporter

Alla intäkter, tillgångar och positiva kassaflöden sparas som positiva värden.
Alla kostnader (t.ex. råvarukostnader, personalkostnader, skatt), skulder samt utflöden (t.ex. CAPEX, utdelningar, amorteringar) sparas som negativa värden.
Detta gör att du alltid kan addera värden rakt av för att få fram exempelvis rörelseresultat (Rörelseintäkter + Rörelsekostnader).

API Endpoints

GET/api/v1/companies

Hämta en sökbar och sidindelad lista av alla tillgängliga bolag.

Parametrar:

search (string) - Sök på bolagsnamn eller ticker.
limit (number) - Antal resultat (standard 20, max 100).
offset (number) - Antal resultat att hoppa över.

GET/api/v1/companies/:id

Hämta information om ett enskilt bolag via dess interna ID (UUID) eller dess ISIN-kod (t.ex. SE0000115446).

GET/api/v1/companies/:id/reports

Hämta finansiella rapporter för ett bolag.

Parametrar:

report_type (string) - Filtrera efter rapport: RR (Resultat), BR (Balans), KA (Kassaflöde).
period_type (string) - Filtrera efter periodlängd: year (helår), quarter (enskilt kvartal), ttm (rullande 12 månader), eller all (standard).
from_year / to_year (number) - Filtrera på år.
limit (number) - Antal rader (standard 20, max 100).

GET/api/v1/companies/:id/reports/:period

Hämta en specifik rapport för en period. Formatet på period kan vara ett år (t.ex. 2023) eller ett kvartal (t.ex. 2024-Q3).

Kodexempel

cURL

curl -H "Authorization: Bearer fd_din_api_nyckel" \
  "https://börsapi.se/api/v1/companies/SE0000115446/reports?period_type=year&report_type=RR"

JavaScript / Node.js

const API_KEY = 'fd_din_api_nyckel';
const companyIsin = 'SE0000115446'; // Atlas Copco

async function getFinancials() {
  const response = await fetch(
    `https://börsapi.se/api/v1/companies/${companyIsin}/reports?period_type=year`,
    {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      }
    }
  );
  
  if (!response.ok) {
    throw new Error('Fel vid API-anrop: ' + response.statusText);
  }
  
  const result = await response.json();
  console.log('Rapporter:', result.data);
}

getFinancials();