Tool

Description

Parameters

search_instruments

Searches instruments by name, ticker, or ISIN; supports market/country/sector/branch filters, Nordic/global/all universes, deterministic sorting, and cursor-paginated results. Returns { totalMatched, returned, instruments, nextCursor? }

First call: search, marketId, countryId, sectorId, branchId, universe (nordic/global/all), sortBy (ticker/name), sortDirection (asc/desc), pageSize (default 50, max 200). Later pages: cursor only.

list_markets

Lists all markets known to Börsdata (e.g. Stockholm Large Cap, First North)

—

list_branches

Lists all industry branches known to Börsdata

—

list_sectors

Lists all sectors known to Börsdata

—

list_countries

Lists all countries known to Börsdata

—

list_kpi_metadata

Lists all KPIs known to Börsdata (kpiId, Swedish/English name, format, whether the value is a string) — use to find the kpiId for screen_instruments/get_kpi_screener/get_kpi_history/get_kpi_list_screener

—

list_kpi_history_options

Searches a bundled copy of Börsdata's official KPI History table for exact, valid kpiId/reportType/priceType combinations. Makes no Börsdata API request. Use before either KPI history tool whenever the combination is unknown; latest is not a history price type.

kpiId, query, maxCount (at least kpiId or query is required)

list_kpi_screener_options

Searches a bundled copy of Börsdata's official KPI Screener List for exact, valid kpiId/calcGroup/calc combinations. Makes no Börsdata API request. Use this before the screener tools whenever the combination is unknown; do not guess.

kpiId, query, maxCount (at least kpiId or query is required)

get_stock_splits

Stock splits and reverse splits across all instruments (small, ~44 entries live) — split date, ratio, type. Each result is enriched with ticker/name

—

list_report_metadata

Lists metadata for every field returned by get_reports/get_kpi_summary (property name, Swedish/English display name, format) — use to look up what a report field means

—

list_translation_metadata

Lists Börsdata's translation table (translationKey plus Swedish/English name) used for coded labels across the API, e.g. sector/branch names

—

get_instruments_updated

Last-updated timestamps for recently-updated instruments, most-recent-first. Does not cover every instrument — an id missing from the results just hasn't updated recently. Each result is enriched with ticker/name. Returns { totalMatched, returned, values }

instrumentIds (comma-separated), maxCount (optional — omitting both returns ~700 entries)

get_kpis_updated

The single global timestamp for when Börsdata's KPI calculations were last refreshed (not per-instrument). Returns { kpisCalcUpdated }

—

get_stock_prices

Daily stock price history (open, high, low, close, volume) for one instrument. Omitting from/to/maxCount returns Börsdata's default 10-year window. maxCount is a lookback window in years (1-20, Börsdata's own limit for this endpoint), not a count of days/entries — use from/to for an exact date range or a small recent window

instrumentId (required); from, to, maxCount (optional)

get_latest_stock_prices

Latest available daily OHLCV records, enriched with ticker/name, sorted and cursor-paginated. Returns { totalMatched, returned, values, nextCursor? } with compact Börsdata fields i/d/h/l/c/o/v.

First call: instrumentIds, global, sortBy, sortDirection, pageSize (optional). Later pages: cursor only.

get_stock_prices_by_date

Daily OHLCV records for a specific historical date; a non-trading day returns no results. Uses the same enriched, sorted and paginated shape as get_latest_stock_prices.

First call: date (required); instrumentIds, global, sortBy, sortDirection, pageSize (optional). Later pages: cursor only.

get_kpi_screener

A calculated KPI value (e.g. P/E, revenue growth) for one instrument — named to match Börsdata's own "KPI Screener" terminology for this endpoint

instrumentId, kpiId, calcGroup, calc (all required)

get_kpi_history

How a KPI (e.g. P/E) has trended over time for one instrument, unlike get_kpi_screener's single current value. The combination is validated against list_kpi_history_options before the API call.

instrumentId, kpiId, reportType, priceType (required); maxCount (optional)

get_kpi_summary

Every KPI Börsdata tracks for one instrument across multiple periods in one call — unlike get_kpi_screener's single value for one specific KPI. Each entry is keyed by KpiId (see list_kpi_metadata to resolve names)

instrumentId, reportType (year/quarter/r12) (required); maxCount (optional, caps periods per KPI)

get_reports

Financial reports (income statement, balance sheet, cash flow) for one instrument

instrumentId, reportType (year/quarter/r12) (all required)

screen_instruments

Recommended for finding Nordic or global instruments that satisfy one or more financial KPI conditions. Validates every KPI combination against the bundled official catalog, fetches complete KPI lists internally, combines filters with AND logic, and returns a cursor-paginated result snapshot. Call again with only cursor when nextCursor is returned.

First call: kpiFilters (required); global, countryIds, marketIds, sectorIds, branchIds, sortBy, pageSize (optional). Later pages: cursor only.

get_kpi_list_screener

A calculated KPI value (e.g. P/E) for every Nordic instrument on Börsdata in one call — a raw, complete mirror of Börsdata's bulk endpoint for export or custom processing, with no sort, filter, or count control (~14,000 entries). Prefer screen_instruments for KPI-condition screening. Each result is enriched with ticker/name. Returns { kpiId, calcGroup, calc, values }

kpiId, calcGroup, calc (all required)

get_global_kpi_list_screener

The raw, complete global counterpart to get_kpi_list_screener, mirroring Börsdata's separate global endpoint with no result cap. Prefer screen_instruments for KPI-condition screening. Returns { kpiId, calcGroup, calc, values }

kpiId, calcGroup, calc (all required)

get_kpi_history_array

Historical values for a KPI (e.g. P/E) over time for a list of up to 50 instruments in one call — the bulk version of get_kpi_history. The combination is validated against list_kpi_history_options before the API call. Returns one entry per instrument under kpisList (or an error field per instrument if unresolved).

kpiId, reportType, priceType, instrumentIds (comma-separated, all required); maxCount (optional — caps periods per instrument)

get_reports_compound

All financial report types (year, quarter, r12) for one instrument in a single call — unlike get_reports, which returns just one report type per call

instrumentId (required); maxYearCount, maxR12QCount, original (optional — Börsdata defaults 10/10, max 20/40; original returns figures in the instrument's original reporting currency)

get_reports_array

All financial report types (year, quarter, r12) for a list of instruments in one call — the bulk version of get_reports_compound, filtering server-side by instrumentIds. Returns one entry per instrument under reportList (or an error field per instrument if unresolved)

instrumentIds (comma-separated, required); maxYearCount, maxR12QCount, original (optional, same as get_reports_compound)

get_instrument_descriptions

Swedish/English company description text for a list of instruments (max 50 per Börsdata's own limit) — a direct mirror of Börsdata's own "Instrument Description" endpoint. Returns { insId, languageCode, text } per instrument (or an error field if unresolved)

instrumentIds (comma-separated, required, max 50)

get_report_calendar

Report release dates for specified instruments — Börsdata returns each instrument's full past + already-scheduled history in one list, so pass fromDate (e.g. today) to get only upcoming reports. Returns { instruments: [{ insId, totalMatched, returned, reports }] }

instrumentIds (comma-separated, required); fromDate, toDate, maxCount (optional)

get_dividend_calendar

Dividend ex-dates and amounts for specified instruments — same full past + already-scheduled history in one list as get_report_calendar, so pass fromDate for only upcoming dividends. Returns { instruments: [{ insId, totalMatched, returned, dividends }] }

instrumentIds (comma-separated, required); fromDate, toDate, maxCount (optional)

get_insider_holdings

Insider transactions (board members/executives trading their own company's shares) for specified instruments, sorted most-recent-first. Use direction (based on the sign of shares) rather than Börsdata's undocumented transactionType codes to distinguish acquisitions from disposals. Returns { instruments: [{ insId, totalMatched, returned, transactions }] }

instrumentIds (comma-separated, required); fromDate, toDate, minAmount, direction (increase/decrease), maxCount (optional)

get_buyback_holdings

Share buyback transactions for specified instruments, sorted most-recent-first (same full-history-oldest-first caveat as get_insider_holdings). Returns { instruments: [{ insId, totalMatched, returned, buybacks }] }

instrumentIds (comma-separated, required); fromDate, toDate, maxCount (optional)

get_short_holdings

Short-position data (shorting %, holders, days-to-cover, trend) — covers every Nordic instrument in one call unless filtered. Sorted by shorting percent descending by default. Each result is enriched with ticker/name. Returns { totalMatched, returned, values }

instrumentIds (comma-separated), minShortingPercent, sortAscending, maxCount (all optional — omitting all of these returns ~400+ entries)