Hoppa till huvudinnehållet

Overview

The Nordnet External API documentation.

Version information

Version : 2.0

Paths

Get system status information

GET https://public.nordnet.se/api/2

Description

Returns information about the system status.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

Status

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get user accounts

GET https://public.nordnet.se/api/2/accounts

Description

Returns a list of accounts to which the user has access.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

include_credit_accounts
optional

true if credit accounts should be included in the response. Defaults to false.

boolean

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Account > array

204

No content.

No Content

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

DEPRECATED - Get account information summary

GET https://public.nordnet.se/api/2/accounts/{accid}

Description

Returns account information details for one or more accounts. This endpoint is deprecated, please use /accounts/{accid}/info instead.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

The account identifier for the account. Some systems can or must use the account number as account identifier.

integer(int64)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

AccountInfo

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get account information summary

GET https://public.nordnet.se/api/2/accounts/{accid}/info

Description

Returns account information details for one or more account.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

One or more account identifier that identifies the accounts. Some systems can or must use the account number as account identifier. Multiple account identifiers must be comma separated.

< integer > array

Query

include_interest_rate
optional

true if interest_rate should be included in the response. Note that performance improves when the flag is set to false. Defaults to true.

boolean

Query

include_short_pos_margin
optional

true if short_postion_margin should be included in the response. Defaults to true.

boolean

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< AccountInfo > array

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get account ledgers

GET https://public.nordnet.se/api/2/accounts/{accid}/ledgers

Description

Returns information about the currency ledgers of an account.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

The account identifier for the account. Some systems can or must use the account number as account identifier.

integer(int64)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

LedgerInformation

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Enter order

POST https://public.nordnet.se/api/2/accounts/{accid}/orders

Description

Enters a new order for the tradable identified by the given market ID + tradable ID.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

The account identifier for the account. Some systems can or must use the account number as account identifier.

integer(int64)

FormData

activation_condition
optional

Used for stop-loss orders. STOP_ACTPRICE_PERC - Trailing stop-loss. The order is activated when the price changes by the given percentage. The fields target_value, trigger_value and trigger_condition are required and the price field should be omitted. STOP_ACTPRICE - The order is activated when the market price of the instrument reaches a trigger price. The fields trigger_value, trigger_condition and price are required. MANUAL - The order is inactive in the Nordnet system until it is manually activated by the customer. OCO_STOP_ACTPRICE - One cancels other orders. Our implementation is one normal order and one stop-loss order. If the real order is executed the stop-loss is cancelled. If the stop-loss triggers the normal order is canceled. This combination is always displayed as one order.

string

FormData

currency
optional

The currency that the instrument is traded in.

string

FormData

identifier
optional

Nordnet tradable identifier.

string

FormData

market_id
required

Nordnet market identifier.

integer(int64)

FormData

open_volume
optional

The visible part of an iceberg order. If this field is omitted the whole volume of the order is visible on the market. This field is only allowed if the order type is LIMIT or NORMAL.

integer(int64)

FormData

order_type
optional

The order type. Defaults to NORMAL. When using NORMAL the system guesses the order type based on used parameters. For better parameter validation and to ensure that the order type is the desired one the client should not use NORMAL, but rather the intended order type instead. NORMAL will be deprecated in future versions.

enum (FAK, FOK, NORMAL, LIMIT, STOP_LIMIT, STOP_TRAILING, OCO)

"NORMAL"

FormData

price
optional

The price limit of the order.

number(double)

FormData

reference
optional

Free text reference for the order. Intended for the customer.

string

FormData

side
required

BUY or SELL.

enum (BUY, SELL)

FormData

target_value
optional

Only used when type is STOP_ACTPRICE_PERC or OCO_STOP_ACTPRICE. This is the price on the market. If type is STOP_ACTPRICE_PERC the value is given in percentage points. The price will be trailing_value + (target_value percentage of trailing_value). If type is OCO_STOP_ACTPRICE the price is a fixed price.

number(double)

FormData

trigger_condition
optional

The comparison that should be used on trigger_value. Valid values are <= (less than or equal to) or >= (greater than or equal to).

string

FormData

trigger_value
optional

If type is STOP_ACTPRICE_PERC the value is given in percentage points. Minimum value is 1 for STOP_ACTPRICE_PERC. If type is STOP_ACTPRICE the value is a fixed price.

number(double)

FormData

valid_until
optional

Date formatted as YYYY-MM-DD. If this field is left out the order is a day order - that is, the same behavior as if valid_until is set to today. Smart-orders can only be day orders.

string(date)

FormData

volume
required

The volume of the order.

integer(int64)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

OrderReply

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get orders

GET https://public.nordnet.se/api/2/accounts/{accid}/orders

Description

Returns all orders belonging to the given account(s).

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

One or more account identifier that identifies the accounts. Some systems can or must use the account number as account identifier. Multiple account identifiers must be comma separated.

< integer > array

Query

deleted
optional

true if orders that are deleted today should be included in the response. Defaults to false.

boolean

"false"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Order > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Modify an order

PUT https://public.nordnet.se/api/2/accounts/{accid}/orders/{order_id}

Description

Modifies the price and/or volume of an order.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

The account identifier for the account. Some systems can or must use the account number as account identifier.

integer(int64)

Path

order_id
required

The identifier of the order to modify.

integer(int64)

FormData

currency
optional

The currency of the instrument. Required when the price is changed.

string

FormData

open_volume
optional

The new open volume.

integer(int64)

FormData

price
optional

The new price. If left out the price is left unchanged.

number(double)

FormData

volume
optional

The new volume.

integer(int64)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

OrderReply

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

404

Order not found.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Delete an order

DELETE https://public.nordnet.se/api/2/accounts/{accid}/orders/{order_id}

Description

Deletes an order.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

The account identifier for the account. Some systems can or must use the account number as account identifier.

integer(int64)

Path

order_id
required

The identifier of the order to be deleted.

integer(int64)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

OrderReply

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Activate an order

PUT https://public.nordnet.se/api/2/accounts/{accid}/orders/{order_id}/activate

Description

Activates an inactive order. Please note that it is not possible to deactivate an order - the order must be entered as inactive.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

The account identifier for the account. Some systems can or must use the account number as account identifier.

integer(int64)

Path

order_id
required

The order(s) to activate. Multiple identifiers must be comma separated.

< integer(int64) > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< OrderReply > array

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get account positions

GET https://public.nordnet.se/api/2/accounts/{accid}/positions

Description

Returns all positions for the given accounts.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

One or more account identifier that identifies the accounts. Some systems can or must use the account number as account identifier. Multiple account identifiers must be comma separated.

< integer > array

Query

include_instrument_loans
optional

true if instrument loan positions should be included in the response. Defaults to false.

boolean

"false"

Query

include_intraday_limit
optional

true if intraday limit should be included in the response. Defaults to false.

boolean

"false"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Position > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get today’s withdrawal/deposit transaction amounts

GET https://public.nordnet.se/api/2/accounts/{accid}/returns/transactions/today

Description

Returns today’s withdrawal/deposit transaction amounts for the given account.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

The account identifier for the account. Some systems can or must use the account number as account identifier.

integer(int64)

Query

include_credit_account
optional

true if credit accounts should be included in the response. Defaults to true.

boolean

"true"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< AccountTransactionsToday > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get trades

GET https://public.nordnet.se/api/2/accounts/{accid}/trades

Description

Returns all trades belonging to the given account(s).

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

accid
required

One or more account identifier that identifies the accounts. Some systems can or must use the account number as account identifier. Multiple account identifiers must be comma separated.

< integer > array

Query

days
optional

Number of days to use when looking up trades. Defaults to 0, which means trades from today only. Maximum is 7 days.

integer(int64)

"0"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Trade > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

User is logged in but user or system does not have privileges to use this endpoint.

No Content

404

Account not found.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get all countries

GET https://public.nordnet.se/api/2/countries

Description

Returns a list of all countries in the system. Please note that trading is not available in every one of the returned countries.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Country > array

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get country

GET https://public.nordnet.se/api/2/countries/{country}

Description

Lookup one or more countries by country code. Multiple countries can be queried at the same time by comma separating the country codes.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

country
required

The country code to lookup.

< string > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Country > array

204

No content.

No Content

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Search for attributes available in the instrument search APIs.

GET https://public.nordnet.se/api/2/instrument_search/attributes

Description

Returns attributes available in the instrument search APIs.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

apply_filters
optional

Specifies which filters to apply to the search.

string

Query

attribute_group
optional

Returns only attributes belonging to the specified attribute groups.

< enum (EXCHANGE_INFO, HISTORICAL_RETURN_INFO, INSTRUMENT_INFO, KEY_RATIOS_INFO, PRICE_INFO, MARKET_INFO, OPTION_INFO, UNDERLYING_INFO, FUND_INFO, PRICE_KO_INFO, DERIVATIVE_INFO, ETP_INFO, KO_INFO, CERTIFICATES_INFO, STATISTICAL_INFO, COMPANY_INFO, STATUS_INFO) > array

Query

entity_type
optional

Returns only attributes belonging to the specified entity type.

enum (STOCKLIST, OPTIONLIST, FUTUREFORWARDLIST, BULLBEARLIST, MINIFUTURELIST, UNLIMITEDTURBOLIST, WARRANTLIST, ASSET, FUNDLIST, DANISHINVESTFUNDLIST, ETFLIST)

Query

expand
optional

Expands attribute values only for the listed attributes. The default expand value is all.

< string > array

Query

minmax
optional

Returns minimum and maximum values for the specified attributes.

< string > array

Query

only_filterable
optional

Returns only filterable attributes.

boolean

"false"

Query

only_returnable
optional

Returns only returnable attributes.

boolean

"false"

Query

only_sortable
optional

Returns only sortable attributes.

boolean

"false"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

AttributeResults

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Search, filter and sort instruments within the Bull & Bear entity type.

GET https://public.nordnet.se/api/2/instrument_search/query/bullbearlist

Description

Intended for displaying Bull & Bear certificates to the end user, grouped by lists. To return only "Nordnet markets" instruments use the apply_filter parameter nordnet_markets=true. Access to real-time prices is handled based on access rights. When real-time prices are returned, real-time snapshot access logs are produced.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

apply_filters
optional

Specifies which filters to apply to the search.

string

Query

free_text_search
optional

Free text search for name, symbol and ISIN.

string

Query

limit
optional

Limits the search results to limit instruments. The default limit is 50. Combine with offset to implement pagination.

integer(int32)

"50"

Query

offset
optional

Skips the first offset search results. The default offset is 0. Combine with limit to implement pagination.

integer(int32)

"0"

Query

sort_attribute
optional

Defines the attribute to sort the search results by. The default sort_attribute is name.

string

"name"

Query

sort_order
optional

Defines the sort order of the search results. Use asc for ascending order and desc for descending order.The default sort_order is asc.

enum (asc, desc)

"asc"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

BullBearListResults

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Search, filter and sort instruments within the Mini future entity type.

GET https://public.nordnet.se/api/2/instrument_search/query/minifuturelist

Description

Intended for displaying Mini Future instruments to the end user, grouped by lists. To return only "Nordnet markets" instruments use the apply_filter parameter nordnet_markets=true. Access to real-time prices is handled based on access rights. When real-time prices are returned, real-time snapshot access logs are produced.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

apply_filters
optional

Specifies which filters to apply to the search.

string

Query

free_text_search
optional

Free text search for name, symbol and ISIN.

string

Query

limit
optional

Limits the search results to limit instruments. The default limit is 50. Combine with offset to implement pagination.

integer(int32)

"50"

Query

offset
optional

Skips the first offset search results. The default offset is 0. Combine with limit to implement pagination.

integer(int32)

"0"

Query

sort_attribute
optional

Defines the attribute to sort the search results by.

string

Query

sort_order
optional

Defines the sort order of the search results. Use asc for ascending order and desc for descending order.

enum (asc, desc)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

MinifutureListResults

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Search for the Option Pair (Put-Call) given an underlying instrument and the expiration date.

GET https://public.nordnet.se/api/2/instrument_search/query/optionlist/pairs

Description

Intended for displaying Option Pair lists to the end user grouped by underlying instrument and expiration date. Access to real-time prices is handled based on access rights. When real-time prices are returned, real-time snapshot access logs are produced.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

currency
required

Search for options with the given currency.

string

Query

expire_date
required

Search for options with the given expiration date.

integer(int64)

Query

underlying_symbol
required

Search for options with the given underlying instrument symbol.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

OptionListResults

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Search for stocks

GET https://public.nordnet.se/api/2/instrument_search/query/stocklist

Description

Returns the stocks matching the given search criteria.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

apply_filters
optional

Defines which filters to apply to the search.

string

Query

attribute_groups
optional

Returns only attributes for the given attribute groups.

< enum (DOCUMENT_INFO, EXCHANGE_INFO, HISTORICAL_RETURN_INFO, INSTRUMENT_INFO, KEY_RATIOS_INFO, PRICE_INFO, MARKET_INFO, COMPANY_INFO, STATISTICAL_INFO) > array

Query

attributes
optional

Returns only the given attributes.

< string > array

Query

free_text_search
optional

Free-text search string. May contain instrument name, symbol, ISIN code.

string

Query

limit
optional

Limits the search results to limit. A maximum of limit * 2 results are returned. The default limit is 50. Combine with offset to implement pagination.

integer(int32)

"50"

Query

offset
optional

Skips the first offset search results per group. The default offset is 0. Combine with limit to implement pagination.

integer(int32)

"0"

Query

sort_attribute
optional

Defines the attribute to sort the search results by. The default sort_attribute is name.

string

"name"

Query

sort_order
optional

Defines the sort order of the search results. Use asc for ascending order and desc for descending order. The default sort_order is asc.

enum (asc, desc)

"asc"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

StocklistResults

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Search, filter and sort instruments within the Unlimited Turbo entity type.

GET https://public.nordnet.se/api/2/instrument_search/query/unlimitedturbolist

Description

Intended for displaying Unlimited Turbo instruments to the end user, grouped by lists. To return only "Nordnet markets" instruments use the apply_filter parameter nordnet_markets=true. Access to real-time prices is handled based on access rights. When real-time prices are returned, real-time snapshot access logs are produced.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

apply_filters
optional

Specifies which filters to apply to the search.

string

Query

free_text_search
optional

Free text search for name, symbol and ISIN.

string

Query

limit
optional

Limits the search results to limit instruments. The default limit is 50. Combine with offset to implement pagination.

integer(int32)

"50"

Query

offset
optional

Skips the first offset search results. The default offset is 0. Combine with limit to implement pagination.

integer(int32)

"0"

Query

sort_attribute
optional

Defines the attribute to sort the search results by.

string

Query

sort_order
optional

Defines the sort order of the search results. Use asc for ascending order and desc for descending order.

enum (asc, desc)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

UnlimitedTurboListResults

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Instrument lookup

GET https://public.nordnet.se/api/2/instruments/lookup/{lookup_type}/{lookup}

Description

Lookup specfic instrument with predefined fields. Please note that this is not a search, only exact matches are returned.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

lookup
required

If the lookup type is market_id_identifier the lookup must be formatted as [market_id]:[identifier]. If the lookup type is isin_code_currency_market_id the lookup must be formatted as [isin]:[currency]:[market_id]. Multiple entries must be comma separated.

< string > array

Path

lookup_type
required

The lookup type to use.

enum (market_id_identifier, isin_code_currency_market_id)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Instrument > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get all instrument types

GET https://public.nordnet.se/api/2/instruments/types

Description

Returns all Nordnet instrument types.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< InstrumentType > array

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get instrument type

GET https://public.nordnet.se/api/2/instruments/types/{instrument_type}

Description

Returns information about one or more Nordnet instrument types.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

instrument_type
required

The instrument type code(s) to lookup. Multiple inputs must be comma separated.

< string > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< InstrumentType > array

204

No content.

No Content

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get underlyings

GET https://public.nordnet.se/api/2/instruments/underlyings/{derivative_type}/{currency}

Description

Returns instruments that are underlyings for a specific type of instruments. Can return instruments that have option derivatives or leverage derivatives. Warrants are included in the leverage derivatives.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

currency
required

The derivative currency. Please note that the underlying can have a different currency.

string

Path

derivative_type
required

Specifies which instrument type to find underlyings for.

enum (leverage, option_pair)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Instrument > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get trading eligibility

GET https://public.nordnet.se/api/2/instruments/validation/suitability/{instrument_id}

Description

Returns the customer’s trading eligibility for the given instrument ID(s).

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

instrument_id
required

The instrument identifier. One or more instrument identifiers can be specified. Multiple inputs must be comma separated.

< integer(int64) > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< InstrumentEligibility > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

Access forbidden for anonymous sessions.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get instruments

GET https://public.nordnet.se/api/2/instruments/{instrument_id}

Description

Returns instrument information for the given instrument ID(s).

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

instrument_id
required

The unique instrument ID. Multiple inputs must be comma separated.

< integer(int64) > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Instrument > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get leverage instruments

GET https://public.nordnet.se/api/2/instruments/{instrument_id}/leverages

Description

Returns a list of leverage instruments that have the current instrument as underlying. Leverage instruments are for example warrants and ETFs. To get all valid filters for the current underlying please use "Get leverages filters". The filters can be used to narrow the search. If "Get leverages filters" is used to fill comboboxes the same filters can be applied on the that call to hide filter cominations that are not valid. Multiple filters can be applied.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

instrument_id
required

The underlying instrument ID.

integer(int64)

Query

currency
optional

Show only leverage instruments with a specific currency.

string

Query

expiration_date
optional

Show only leverage instruments with a specific expiration date.

string(date)

Query

instrument_group_type
optional

Show only instruments with a specific instrument group type.

string

Query

instrument_type
optional

Show only instruments with a specific instrument type.

string

Query

issuer_id
optional

Show only leverage instruments from a specific issuer.

integer(int64)

Query

market_view
optional

Show only leverage instruments with a specific market view.

enum (D, U)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Instrument > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get leverage instruments filters

GET https://public.nordnet.se/api/2/instruments/{instrument_id}/leverages/filters

Description

Returns valid leverage instruments filter values. Can be used to fill combo boxes in client applications in order to filter leverage instruments results. The same filters can be applied on this request to exclude invalid filter combinations.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

instrument_id
required

The underlying instrument ID.

integer(int64)

Query

currency
optional

Show only leverage instruments with a specific currency.

string

Query

expiration_date
optional

Show only leverage instruments with a specific expiration date.

string(date)

Query

instrument_group_type
optional

Show only instruments with a specific instrument group type.

string

Query

instrument_type
optional

Show only instruments with a specific instrument type.

string

Query

issuer_id
optional

Show only leverage instruments from a specific issuer.

integer(int64)

Query

market_view
optional

Show only leverage instruments with a specific market view.

enum (D, U)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

LeverageFilter

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get todays public trades

GET https://public.nordnet.se/api/2/instruments/{instrument_id}/trades

Description

Returns all the public trades (trades executed on the marketplace) belonging to one or more instruments.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

instrument_id
required

The instrument identifier. One or more instrument identifiers can be specified. Multiple inputs must be comma separated.

< integer(int64) > array

Query

count
optional

The number of trades to return. Integer value or all. Defaults to 5.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< InstrumentPublicTrades > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Create session (log in)

POST https://public.nordnet.se/api/2/login

Description

Before any other of the services (except for the system information request) can be called the user must log in. The username, password and timestamp must be encrypted before being sent.

Three steps is required:
1. First Base64-encode the username, password and timestamp (UNIX timestamp in milliseconds) and join them using the : separator.
2. Use the service public key to encrypt the string created in the previous step.
3. Base64 encode the encrypted string.


Note that the public key is unique for the service type and can only be used together with the service. The name of the service and the public key is provided by Nordnet.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

FormData

auth
required

The authorization blob created above.

string

FormData

service
required

The service name (provided by Nordnet).

string

FormData

session_lang
optional

The default preferred language of the session. The header Accept-Language overrides the session language. Please note that if the session fails to be created the language will not be set. So in order to get an error message on the login in the correct language, the header Accept-Language must also be set. Valid values are sv, da, fi, en, no, nb, nn. Please note that nb and nn are equivalent with no. Defaults to en if not set.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

LoginResponse

400

Invalid parameter.

ErrorResponse

401

Unauthorized to log in using the given credentials.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Touch session

PUT https://public.nordnet.se/api/2/login

Description

If the application needs to keep the session alive the session can be touched. Note that the basic authorization header field must be set in the same manner as for all the other calls. All calls to any Web service are touching the session. Touching the session manually is only needed if no other calls are done during the session timeout interval.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

LoggedInStatus

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Delete session (log out).

DELETE https://public.nordnet.se/api/2/login

Description

Invalidates the session.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

LoggedInStatus

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

GET https://public.nordnet.se/api/2/main_search

Description

Returns the instruments, news, and pages matching the given search criteria.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

instrument_group
optional

Defines the instrument groups to be searched. When not specified the search returns results from all instrument groups.

< enum (EQUITY, PINV, FUND, ETF, ETC, WARRANT, DERIVATIVES, INDICATOR, OTHER) > array

Query

limit
optional

Limits the search results per group to limit. The default limit is 5. Combine with offset to implement pagination.

integer(int32)

"5"

Query

offset
optional

Skips the first offset search results per group. The default offset is 0. Combine with limit to implement pagination.

integer(int32)

"0"

Query

query
required

Search string.

string

Query

search_space
optional

Search space.

enum (ALL, INSTRUMENTS, NEWS, CMS, BLOG, INSTRUMENTS_NEWS, INSTRUMENTS_CMS, NEWS_CMS, NEWS_BLOG, NEWS_BLOG_CMS)

"ALL"

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< MainSearchResponse > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

404

Not found.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get all markets

GET https://public.nordnet.se/api/2/markets

Description

Returns information about all tradable markets.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Market > array

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get market

GET https://public.nordnet.se/api/2/markets/{market_id}

Description

Returns information about one or more markets as specified by the given market ID(s). Multiple markets can be queried at the same time using comma-separated market IDs.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

market_id
required

The market ID(s) to lookup. Multiple inputs must be comma separated.

< integer(int64) > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< Market > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Search for news

GET https://public.nordnet.se/api/2/news

Description

Returns the articles the user has access to matching the given search criteria. Returns the latest articles the user has access to when no criteria are specified.

Parameters

Type Name Description Schema Default

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Query

days
optional

Defines how many days back in time to search for articles. Use 0 for today. When not specified the search returns all articles, irrespective of age.

integer(int64)

Query

excluded_news_types
optional

Excludes articles by type. Multiple types must be comma-separated. When not specified the search returns all articles, irrespective of type. When specified, included_news_types must be omitted. See the news_type field of the NewsPreview model for an enumeration of the valid types.

< string > array

Query

included_news_types
optional

Includes articles by type. Multiple types must be comma-separated. When not specified the search returns all articles, irrespective of type. When specified, excluded_news_types must be omitted. See the news_type field of the NewsPreview model for an enumeration of the valid types.

< string > array

Query

instrument_id
optional

Filters articles by instrument ID. Multiple instrument IDs must be comma-separated. When not specified the search returns articles for all instrument IDs.

< integer(int32) > array

Query

limit
optional

Limits the search results to limit articles. The default limit is 100. The maximum limit is 100. Combine with offset to implement pagination.

integer(int64)

"100"

Query

market_id
optional

Filters articles by market ID. Multiple market IDs must be comma-separated.

< integer(int32) > array

Query

news_lang
optional

Filters articles by language (en, sv, etc.) Multiple languages must be comma-separated.

< string > array

Query

offset
optional

Skips the first offset search results. The default offset is 0. Combine with limit to implement pagination.

integer(int64)

"0"

Query

query
optional

Search string. When not specified the search returns all articles in the interval.

string

Query

sort_order
optional

Defines the sort order of the search results. Use asc for ascending order and desc for descending order. The default sort_order is desc.

string

Query

source_id
optional

Filters articles by source ID. Multiple source IDs must be comma-separated. When not specified the search returns all articles, irrespective of source ID.

< integer > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< NewsPreview > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Retrieve news

GET https://public.nordnet.se/api/2/news/{item_id}

Description

Retrieve one or more articles.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

item_id
required

Article ID. Multiple article IDs must be comma-separated.

< integer(int64) > array

Query

body_format
optional

Deprecated parameter. Has no effect on the response.

enum (plain, markdown)

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< NewsArticle > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get news sources

GET https://public.nordnet.se/api/2/news_sources

Description

Returns a list containing the news sources the user has access to.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< NewsSource > array

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get all tick size tables

GET https://public.nordnet.se/api/2/tick_sizes

Description

Returns a list of all tick size tables.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< TicksizeTable > array

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get tick size tables

GET https://public.nordnet.se/api/2/tick_sizes/{tick_size_id}

Description

Returns one or more tick size tables as specified by the given tick size ID(s).

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

tick_size_id
required

The tick size table(s) to lookup. Multiple inputs must be comma separated.

< integer(int64) > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< TicksizeTable > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get tradable info

GET https://public.nordnet.se/api/2/tradables/info/{tradables}

Description

Returns trading calendar and allowed trading types for one or more tradables.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

tradables
required

[market_id]:[identifier] of the tradable. Example: 11:101 for ERIC B. Multiple inputs must be comma separated.

< string > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< TradableInfo > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get todays public trades

GET https://public.nordnet.se/api/2/tradables/trades/{tradables}

Description

Returns a list of public trades (all trades executed on the marketplace) for the given tradable(s).

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

tradables
required

[market_id]:[identifier] of the tradable. Example: 11:101 for ERIC B. Multiple inputs must be comma separated.

< string > array

Query

count
optional

Number of trades to return. Integer value or all. Defaults to 5.

string

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< TradablePublicTrades > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Get trading eligibility

GET https://public.nordnet.se/api/2/tradables/validation/suitability/{tradables}

Description

Returns the customer’s trading eligibility for one or more tradables.

Parameters

Type Name Description Schema

Header

Accept-Language
optional

Language preferred in the response. Overrides the session language. Note that nb and nn are equivalent to no.

enum (en, sv, fi, da, no, nb, nn)

Header

Authorization
optional

Basic authorization header, that is the value must be Basic <credentials> where <credentials> is the base64 encoded string <session_id>:<session_id>.

string

Path

tradables
required

[market_id]:[identifier] of the tradable. Example: 11:101 for ERIC B. Multiple inputs must be comma separated.

< string > array

Responses

HTTP Code Description Schema

200

Standard response for successful HTTP requests.

< TradableEligibility > array

204

No content.

No Content

400

Invalid parameter.

ErrorResponse

401

Invalid session.

ErrorResponse

403

Access forbidden for anonymous sessions.

No Content

429

Too Many Requests. Please wait for 10 seconds before retrying.

ErrorResponse

503

Service Unavailable. Follow the Retry-After header and retry in the specified amount of seconds.

ErrorResponse

Security

Type Name

basic

basic

Definitions

Account

Name Description Schema

accid
optional

The account identifier. An account identifier refers to a specific account for the duration of a session, but this is not guaranteed between sessions. Not applicable for partners.

integer(int64)

accno
required

The Nordnet account number. An account number always refers to a specific account.

integer(int64)

alias
required

The account alias. This can be set by the customer.

string

atyid
optional

The account type identifier

integer(int32)

blocked_reason
optional

The reason why the account is blocked. This field is translated to the language specified in the request.

string

default
required

true if this is the default account.

boolean

is_blocked
optional

true if the account is blocked. No queries can be made against a blocked account.

boolean

type
required

The account type. This field is translated.

string

AccountInfo

Name Description Schema

accid
optional

The account identifier. An account identifier refers to a specific account for the duration of a session, but this is not guaranteed between sessions. Not applicable for partners.

integer(int64)

accno
required

The Nordnet account number. An account number always refers to a specific account.

integer(int64)

account_credit
required

The account credit.

Amount

account_currency
required

The account currency.

string

account_sum
required

The combined sum of all ledgers.

Amount

bonus_cash
optional

The bonus cash if available.

Amount

buy_orders_value
required

The combined value of all pending buy orders.

Amount

collateral
required

The collateral claim for options.

Amount

credit_account_interest
optional

The accrued interest for credit account if available.

Amount

credit_account_sum
optional

The sum for credit account if available.

Amount

equity
required

The sum of own_capital and credit_account_sum.

Amount

forward_sum
required

The locked amount for forwards.

Amount

full_marketvalue
required

The total market value.

Amount

future_sum
required

The sum of intraday realized profits/losses for futures in account currency. This is calculated for positions that are being closed out whether in part or entirely. The latest known foreign exchange rate is used. Reset at night. It differs from unrealized_future_profit_loss which looks at existing positions in order to calculate its value.

Amount

interest
required

The interest on the account.

Amount

intraday_credit
optional

The intraday credit if available.

Amount

loan_limit
required

The maximum loan limit, regardless of pawn value.

Amount

own_capital
required

The sum of account_sum, full_marketvalue, interest, forward_sum, future_sum and unrealized_future_profit_loss.

Amount

own_capital_morning
required

Own capital calculated in the morning. Does not change during the day.

Amount

pawn_value
required

The pawn value of all positions combined.

Amount

registration_date
optional

The registration date of the account formatted as YYYY-MM-DD.

string(date)

short_positions_margin
optional

The short position margin if available.

Amount

trading_power
required

The amount available for trading.

Amount

unrealized_future_profit_loss
required

The sum of profit and loss for all currently existing futures positions. Not the same as future_sum which deals with contracts that are closed out during the day, i.e. realized profits/losses.

Amount

AccountTransactionsToday

Name Description Schema

transactions
required

Transaction amounts today.

Amount

ActivationCondition

Name Description Schema

trailing_value
optional

The fix point that the trigger_value and target_value percent is calculated from. Only used when type is STOP_ACTPRICE_PERC.

number(double)

trigger_condition
optional

The comparison that should be used on trigger_value. Valid values are <= (less than or equal to) or >= (greater than or equal to).

string

trigger_value
optional

The trigger value. If type is STOP_ACTPRICE_PERC the value is given in percentage points. If type is STOP_ACTPRICE the value is a fixed price.

number(double)

type
required

The stop-loss activation condition: NONE - This order has no activation condition. It is sent directly to the market (if the market is open). MANUAL - The order is inactive in the Nordnet system and is activated by the customer. STOP_ACTPRICE_PERC - Trailing stop-loss. The order is activated when the price changes by the given percentage. STOP_ACTPRICE - The order is activated when the market price of the instrument reaches a trigger price.

string

Amount

The value and currency pair for an amount in a specific currency.

Name Description Schema

currency
required

The amount currency.

string

value
required

The amount.

number(double)

AttributeResult

Name Description Schema

filter_details
optional

Additional details for attributes having the filterable=true flag.

FilterDetails

filterable
optional

Signals whether the attribute can be used as a filter in the instrument search APIs.

boolean

id
optional

Attribute ID.

string

max
optional

Maximum value.

number(double)

min
optional

Minumum value.

number(double)

name
optional

Attribute name.

string

returnable
optional

Signals whether the attribute can be returned by the instrument search APIs.

boolean

sortable
optional

Signals whether the attribute can be used for sorting by the instrument search APIs.

boolean

AttributeResults

Name Description Schema

attributes
optional

Attribute search results.

< AttributeResult > array

attributes_count
required

Number of results returned.

integer(int64)

BullBearEntity

Name Description Schema

certificate_info
optional

Certificate information.

CertificateInfo

etp_info
optional

ETP information.

EtpInfo

exchange_info
optional

Information regarding the instrument/tradable on the exchange.

ExchangeInfo

instrument_info
optional

Instrument information. The same content may appear in multiple search results if there are multiple tradables or fund universes.

InstrumentInfo

market_info
optional

Identifies which market the price information is collected from.

MarketInfo

price_info
optional

Price information, representing an exchange-traded model containing top-of-book information.

PriceInfo

BullBearListResults

Name Description Schema

results
optional

Bull & Bear search results.

< BullBearEntity > array

rows
optional

Number of results returned.

integer(int32)

total_hits
optional

Number of search hits.

integer(int64)

underlying_instrument_id
optional

ID of the underlying instrument if and only if the results contain instruments with the same underlying instrument.

integer(int64)

CalendarDay

Name Description Schema

close
required

The market closing time. UNIX timestamp in milliseconds.

integer(int64)

date
required

The date formatted as YYYY-MM-DD.

string(date)

open
required

The market opening time. UNIX timestamp in milliseconds.

integer(int64)

CertificateInfo

Name Description Schema

static_high_risk
optional

High-risk (static.)

boolean

static_leverage
optional

Static leverage.

number(double)

CompanyInfo

Name Description Schema

dividend_amount
optional

Upcoming dividend amount.

number(double)

dividend_currency
optional

Upcoming dividend currency.

string

dividend_date
optional

Upcoming dividend payout date.

integer(int64)

excluding_date
optional

Upcoming dividend exclude date.

integer(int64)

general_meeting_date
optional

Upcoming annual general meeting date.

integer(int64)

report_date
optional

Upcoming report date.

integer(int64)

report_description
optional

Upcoming report type translation.

string

report_type
optional

Upcoming report type. For example, ANNUAL_REPORT, FIRST_QUARTER_EARNINGS_RESULTS.

string

Country

Name Description Schema

country
required

The country code.

string

name
required

The translated name of the country.

string

DerivativeInfo

Name Description Schema

contract_multiplier
optional

Derivative contract multiplier.

integer(int32)

expire_date
optional

Derivative expiration date for the derivative; Epoch time.

integer(int64)

start_date
optional

Derivative start date; Epoch time.

integer(int64)

DiffWithDecimals

Name Description Schema

decimals
optional

Number of decimals.

integer(int32)

diff
optional

Difference amount.

number(double)

ErrorResponse

Standard error description.

Name Description Schema

code
required

The error code.

string

message
optional

A human-readable error if available. This message is translated.

string

EtpInfo

Name Description Schema

direction
optional

Certificate direction; localized.

string

first_trading_date
optional

First ETP trading date; Epoch time.

integer(int64)

market_view
optional

Leverage ETPs market view.

string

nordnet_markets
optional

Signals whether the instrument is part of the "Nordnet markets."

boolean

underlying_instrument_id
optional

Underlying instrument ID.

integer(int64)

underlying_name
optional

Underlying instrument name.

string

ExchangeInfo

Name Description Schema

exchange_country
optional

Instrument trading country.

string

Feed

Name Description Schema

encrypted
required

true if the feed is encrypted.

boolean

hostname
required

The feed hostname.

string

port
required

The feed port.

integer(int64)

FilterDetails

Name Description Schema

attribute
optional

Attribute ID.

string

parent_filters
optional

List of attribute IDs which are logical parent filters for this attribute. (E.g. market_id is a parent of market_sub_id.)

< string > array

requires_expand
optional

When requires_expand=true, the attribute ID must be provided to the attribute search APIs via expand if filter values should be returned.

boolean

values
optional

List of filter values for this attribute, if expand is specified. Supports only the MULTISELECT filter type.

< FilterVal > array

FilterVal

Name Description Schema

count
optional

The number of instruments or tradables which have this filter ID.

integer(int64)

id
optional

Attribute filter ID.

string

name
optional

Attribute filter display name. Can be localized.

string

HistoricalReturnsInfo

Name Description Schema

realtime
optional

Set to true if the historical returns information is based on a real-time snapshot.

boolean

yield_10y
optional

Yield ten years. Price difference between now and ten years ago.

number(double)

yield_1m
optional

Yield one month. Price difference between now and one month ago.

number(double)

yield_1w
optional

Yield one week. Price difference between now and last week.

number(double)

yield_1y
optional

Yield one year. Price difference between now and last year.

number(double)

yield_3m
optional

Yield three months. Price difference between now and three months ago.

number(double)

yield_3y
optional

Yield three years. Price difference between now and three years ago.

number(double)

yield_5y
optional

Yield five years. Price difference between now and five years ago.

number(double)

yield_ytd
optional

Yield year to date. Price difference between now and the start of the year.

number(double)

Instrument

Instrument definition.

Name Description Schema

asset_class
optional

Asset class key word.

string

brochure_url
optional

URL to brochure if available.

string

currency
required

The currency of the instrument.

string

dividend_policy
optional

The dividend policy.

string

expiration_date
optional

Expiration date if applicable.

string(date)

instrument_group_type
optional

The instrument group. Wider description than instrument type. The description is available in the instrument type lookup.

string

instrument_id
required

Unique identifier of the instrument. Can be 0 if the instrument is not tradable.

integer(int64)

instrument_type
required

The instrument type.

string

isin_code
optional

The instrument ISIN code.

string

key_information_documents
optional

URLs to key information documents (KIDs) if available.

KeyInformationDocuments

leverage_percentage
optional

The leverage percentage if applicable.

number(double)

margin_percentage
optional

The margin percentage if applicable.

number(double)

market_view
optional

Marking market view for leverage instruments. U for up and D for down.

string

mifid2_category
optional

The MiFID II category of the instrument. Used to determine if a user can trade the instrument.

integer(int32)

multiplier
optional

The instrument multiplier.

number(double)

name
required

The instrument name.

string

number_of_securities
optional

Number of securities, not available for all instruments.

number(double)

pawn_percentage
optional

The pawn percentage if applicable.

number(double)

price_type
optional

Price type when trading. Not available for all markets. Examples: monetary_amount, percentage, yield.

string

prospectus_url
optional

URL to prospectus if available

string

sector
optional

The sector ID of the instrument.

string

sector_group
optional

The sector group of the instrument.

string

sfdr_article
optional

The SFDR article of a fund. Can be 6, 8 or 9.

integer(int32)

strike_price
optional

Strike price if applicable.

number(double)

symbol
required

The instrument symbol, e.g ERIC B

string

total_fee
optional

Total fee.

number(double)

tradables
optional

The tradables that belongs to the instrument. If the instrument is not tradable this field is left out.

< Tradable > array

underlyings
optional

A list of underlyings to the instrument.

< UnderlyingInfo > array

InstrumentEligibility

Name Description Schema

eligible
required

true if the customer is eligible to trade the instrument.

boolean

instrument_id
required

The instrument identifier.

integer(int32)

InstrumentInfo

Name Description Schema

clearing_place
optional

Clearing place.

string

currency
optional

Currency.

string

display_name
optional

Country-specific name. Populated only for indicators.

string

instrument_group_type
optional

Instrument group type.

string

instrument_id
optional

Unique instrument ID.

integer(int64)

instrument_pawn_percentage
optional

Maximum pawn percentage.

integer(int32)

instrument_type
optional

Instrument type.

string

instrument_type_hierarchy
optional

Instrument type hierarchy.

string

is_monthly_saveable
optional

Set to true if the instrument can be used for monthly savings.

boolean

is_shortable
optional

Set to true if the instrument is shortable.

boolean

is_tradable
optional

Set to true if the instrument is tradable. For example, the instrument may be an untradable index or a tradable stock.

boolean

isin
optional

International securities identification number (ISIN.)

string

issuer_id
optional

Issuer ID.

integer(int64)

issuer_name
optional

Issuer name.

string

long_name
optional

Localized long instrument name.

string

name
optional

Short instrument name.

string

price_unit
optional

Price unit.

string

symbol
optional

Instrument symbol. Intended for presentation.

string

InstrumentPublicTrades

Name Description Schema

instrument_id
required

The unique instrument ID.

integer(int32)

trades
required

A list of the public trades.

< PublicTrade > array

InstrumentType

Name Description Schema

instrument_type
required

The instrument type code.

string

name
required

The translated instrument type name.

string

Issuer

Name Description Schema

issuer_id
required

Unique issuer ID.

integer(int64)

name
required

Issuer name.

string

KeyInformationDocuments

Name Description Schema

url_for_combined
optional

The URL of the key information document (KID). Link to a Combined KID document.

string

url_for_long
optional

The URL of the key information document (KID). Link to a Long KID document.

string

url_for_short
optional

The URL of the key information document (KID). Link to a Short KID document.

string

KeyRatiosInfo

Name Description Schema

dividend_per_share
optional

Dividend per share (Utdelning/aktie.)

number(double)

dividend_yield
optional

Dividend yield (Direktavkastning.)

number(double)

eps
optional

Earnings per share (EPS) (Vinst/aktie.)

number(double)

pb
optional

Price to book ratio (P/B ratio.)

number(double)

pe
optional

Price to earnings ratio (P/E ratio.)

number(double)

ps
optional

Price to sales ratio (P/S ratio.)

number(double)

KoCalcInfo

Name Description Schema

ko_calc_conversion_ratio
optional

The conversion ratio

number(double)

ko_calc_underlying_currency
optional

The underlying currency

string

ko_calc_underlying_identifier
optional

The underlying identifier

string

ko_calc_underlying_market_id
optional

The underlying market id

integer(int64)

KoInfo

Name Description Schema

financial_level
optional

Financial level (strike price.)

number(double)

stop_loss
optional

Stop-loss (barrier price.)

number(double)

Ledger

Name Description Schema

acc_int_cred
required

The interest credit in the ledger currency.

Amount

acc_int_deb
required

The interest debit in the ledger currency.

Amount

account_sum
required

The sum in the ledger currency.

Amount

account_sum_acc
required

The sum in the account currency.

Amount

currency
required

The currency of the ledger.

string

exchange_rate
required

The price to convert to base currency.

Amount

LedgerInformation

Name Description Schema

ledgers
required

The list of all ledgers.

< Ledger > array

total
required

The total of all the ledgers in the account currency.

Amount

total_acc_int_cred
required

The total interest credit in the account currency.

Amount

total_acc_int_deb
required

The total interest debit in the account currency.

Amount

LeverageFilter

Name Description Schema

currencies
required

List of valid currencies.

< string > array

expiration_dates
required

List of valid expiry dates.

< string > array

instrument_group_types
required

List of valid instrument group types.

< string > array

instrument_types
required

List of valid instrument types.

< string > array

issuers
required

List of valid issuers.

< Issuer > array

market_view
required

List of valid market views.

< string > array

no_of_instruments
required

Number of derivative instruments.

integer(int64)

LoggedInStatus

Name Description Schema

logged_in
required

true if the session is valid.

boolean

LoginResponse

Name Description Schema

environment
required

The environment of the server. Examples: production, test.

string

expires_in
required

The session expiration interval in seconds. Note that this is not the remaining time until session time-out but rather the entire interval.

integer(int64)

private_feed
required

Connection information for the Private Feed.

Feed

public_feed
required

Connection information for the Public Feed.

Feed

session_key
required

The session key used for identification in all other requests.

string

MainSearchResponse

Name Description Schema

display_group_description
required

Result group data description.

string

display_group_type
required

Result group data type.

string

limit
optional

Limit for the search results.

integer(int32)

offset
optional

Offset for the search results.

integer(int32)

results
required

Results.

< MainSearchResponseRow > array

total
optional

Total number of available rows.

integer(int32)

MainSearchResponseRow

Name Description Schema

agency
optional

News agency.

string

agency_description
optional

Localized news agency description.

string

avatar_uri
optional

Shareville avatar URI.

string

close_price
optional

Close price value for the previous trading day.

PriceWithDecimals

country
optional

Shareville profile country.

string

currency
optional

Instrument currency.

string

diff_pct_one_day
optional

Yield for one day in percent.

string

diff_pct_one_year
optional

Yield for one year in percent.

string

display_name
required

Display name.

string

display_name_highlighted
optional

Display name with highlight tags.

string

display_symbol
optional

Display symbol.

string

entity_type
optional

Indicator entity type. For example, COMMODITY.

string

etp_info
optional

ETP information.

EtpInfo

exchange_country
optional

Exchange country code.

string

external_news_id
optional

External unique news ID.

integer(int64)

indicator_identifier
optional

Indicator ID.

string

indicator_source
optional

Indicator source ID.

string

instrument_group_type
optional

Instrument group type.

string

instrument_id
optional

Unique instrument ID.

integer(int64)

instrument_type
optional

Instrument type.

string

is_cms
optional

True if the page is a CMS page.

boolean

is_external
optional

True if the page is an external page.

boolean

joined_at
optional

Shareville user join date.

integer(int64)

ko_info
optional

Information related to knock-out instruments

KoInfo

language
optional

Language of the news article or page.

string

last_price
optional

Current last price value.

PriceWithDecimals

last_price_title
optional

Last price title. For example, "Senaste NAV".

string

market_data_order_book_id
optional

Market data order book ID used in NNX.

string

market_info
optional

Market information. Specifies which market the price information is collected from.

MarketInfo

news_id
optional

News ID as UUID used in NNX.

string

news_type
optional

News type.

string

news_type_description
optional

Localized news type description.

string

nnx_instrument_id
optional

Instrument ID used in NNX.

string

price_ko_info
optional

Knock-out instrument price information.

PriceKoInfo

profile_id
optional

UUID for Shareville profile.

string

published_date_time
optional

Publication date according to the news source.

integer(int64)

rating
optional

Shareville rating.

string

spread
optional

Bid-ask spread.

PriceWithDecimals

spread_pct
optional

Bid-ask spread in percent.

number(double)

status_info
optional

Current market trading status.

StatusInfo

tick_timestamp
optional

Price time stamp.

integer(int64)

trading_order_book_id
optional

Trading order book ID used in NNX.

string

turnover
optional

Daily turnover.

number(double)

turnover_volume
optional

Turnover volume.

integer(int64)

uri
optional

Page URI.

string

username
optional

Shareville username.

string

views
optional

Number of times news article has been viewed.

integer(int32)

yield_1y
optional

1-day yield.

string

Market

Name Description Schema

country
optional

The country code. Available for all non-virtual markets.

string

market_id
required

The Nordnet unique market identifier.

integer(int64)

name
required

The market name.

string

MarketInfo

Name Description Schema

identifier
optional

Market identifier.

string

market_id
optional

Market ID.

integer(int64)

market_sub_id
optional

Market sub-ID.

integer(int64)

tick_size_id
optional

Tick size ID for the tick size table to use, when applicable.

integer(int64)

MinifutureEntity

Name Description Schema

etp_info
optional

ETP information.

EtpInfo

exchange_info
optional

Information regarding the instrument/tradable on the exchange.

ExchangeInfo

instrument_info
optional

Instrument information. The same content may appear in multiple search results if there are multiple tradables or fund universes.

InstrumentInfo

ko_calc_info
optional

Knock-out instrument related information.

KoCalcInfo

ko_info
optional

Information related to knock-out instruments.

KoInfo

market_info
optional

Identifies which market the price information is collected from.

MarketInfo

price_info
optional

Price information, representing an exchange-traded model containing top-of-book information.

PriceInfo

price_ko_info
optional

Knock-out instrument related price information.

PriceKoInfo

MinifutureListResults

Name Description Schema

results
optional

Mini Future search results.

< MinifutureEntity > array

rows
optional

Number of results returned.

integer(int32)

total_hits
optional

Number of search hits.

integer(int64)

underlying_instrument_id
optional

ID of the underlying instrument if and only if the results contain instruments with the same underlying instrument.

integer(int64)

NewsArticle

Name Description Schema

body
optional

Article body.

string

byline
optional

Article author.

string

headline
required

Article headline.

string

instruments
optional

List of instrument IDs affected by article.

< integer > array

isin_codes
optional

List of ISINs affected by the article.

< string > array

lang
required

News language.

string

markdown_format
required

Whether the article is in markdown format.

boolean

markets
optional

List of market IDs affected by the article.

< integer > array

news_id
required

External unique news ID.

integer(int64)

news_type
required

Valid types are: NEWS, ANALYSIS, PRESS_RELEASE, MARKET_COMMENTARY, PM, PMVECKAN, MARKET_NEWS, VOLATILITY_HALT, TRADING_HALT, TRADING_EVENT, TOP10.

string

sectors
optional

List of sectors affected by the article.

< string > array

source_id
required

Nordnet unique news source ID.

integer(int64)

summary
optional

Article summary.

string

timestamp
required

Publication date expressed in milliseconds since January 1st 1970 00:00:00 UTC.

integer(int64)

top_story_image
optional

Article image.

TopStoryImageMeta

type
required

Exists for backwards compatibility. Always set to NEWS.

string

version
required

Article version.

integer(int64)

NewsPreview

Name Description Schema

headline
required

Article headline.

string

instruments
optional

Instrument IDs affected by the article.

< integer > array

lang
required

News language.

string

markdown_format
required

Whether the article is in markdown format.

boolean

markets
optional

Market IDs affected by the article.

< integer > array

news_id
required

External unique news ID.

integer(int64)

news_type
required

Valid types are: NEWS, ANALYSIS, PRESS_RELEASE, MARKET_COMMENTARY, PM, PMVECKAN, MARKET_NEWS, VOLATILITY_HALT, TRADING_HALT, TRADING_EVENT, TOP10.

string

source_id
required

Nordnet unique news source ID.

integer(int64)

summary
optional

Article summary.

string

timestamp
required

Publication date expressed in milliseconds since January 1st 1970 00:00:00 UTC.

integer(int64)

top_story_image
optional

Article image.

TopStoryImageMeta

type
required

Exists for backwards compatibility. Always set to NEWS.

string

NewsSource

Name Description Schema

countries
optional

List containing the country codes affected by the news source.

< string > array

level
required

Valid access levels: DELAYED (news access with a 15 minute delay), REALTIME (real-time news access), FLASH (flash news access - implies real-time access for ordinary news).

string

name
required

News source name.

string

source_id
required

Nordnet unique news source ID.

integer(int64)

OptionInfo

Name Description Schema

exercise_type
optional

Option exercise type.

string

risk_free_interest
optional

Risk-free interest based on the option expiration date.

number

strike_price
optional

Option strike price.

number

underlying_instrument_id
optional

Underlying instrument ID.

integer(int64)

underlying_name
optional

Underlying instrument name.

string

OptionListResults

Name Description Schema

results
required

Option Pair search results.

< OptionlistPair > array

rows
required

Number of results returned.

integer(int32)

total_hits
required

Number of search hits.

integer(int64)

OptionlistEntity

Name Description Schema

derivative_info
optional

Derivative information.

DerivativeInfo

exchange_info
optional

Information regarding the instrument/tradable on the exchange.

ExchangeInfo

instrument_info
optional

Instrument information. The same content may appear in multiple search results if there are multiple tradables or fund universes.

InstrumentInfo

market_info
optional

Identifies which market the price information is collected from.

MarketInfo

option_info
optional

Option information.

OptionInfo

price_info
optional

Price information, representing an exchange-traded model containing top-of-book information.

PriceInfo

OptionlistPair

Name Description Schema

call_option
required

Call option.

OptionlistEntity

put_option
required

Put option.

OptionlistEntity

strike_price
required

Common strike price for the Put and Call options.

number

Order

Name Description Schema

accid
optional

The account identifier. An account identifier refers to a specific account for the duration of a session, but this is not guaranteed between sessions. Not applicable for partners.

integer(int64)

accno
required

The Nordnet account number. An account number always refers to a specific account.

integer(int64)

action_state
required

The state of the last action performed on the order: DEL_FAIL - Delete request failed and the order is still active on the market. DEL_PEND - Delete request in progress and unconfirmed by the market. DEL_CONF - Delete confirmed by the market. DEL_PUSH - Deleted by the market. INS_FAIL - Insert failed. INS_PEND - Pending insert. INS_CONF - Confirmed insert. INS_STOP - The order inserted into the Nordnet system and stopped. This is the state of inactive orders and not triggered stop-loss orders. MOD_FAIL - Modification failed and the previous order values are still valid. MOD_PEND - Modification in progress and waiting confirmation from the market. MOD_PUSH - Modified by the market. INS_WAIT - Insert waiting for market opening. MOD_WAIT - Modification of order on the market, waiting for market opening. DEL_WAIT - Delete of order on the market, waiting for market opening. MOD_CONF - Modification confirmed by the market.

string

activation_condition
optional

The activation condition for stop-loss orders.

ActivationCondition

modified
required

Last modification time of the order. UNIX timestamp in milliseconds.

integer(int64)

open_volume
optional

The open volume of an iceberg order.

number(double)

order_id
required

The Nordnet order identifier.

integer(int64)

order_state
required

The state of the order: DELETED - Order is deleted. LOCAL - The order is offline/local and eligible for activation. ON_MARKET - The order is active on the market. LOCKED - The order can’t be modified by the customer.

string

order_type
required

The type of the order. Each order type assumes a certain combination of parameters, for instance fill-and-kill requires certain validity and volume conditions. These predefined combinations of parameters can also be used for input validation.

string

price
required

The price of the order.

Amount

price_condition
required

The price condition on the order: LIMIT - The order is limited by the given price. AT_MARKET - The order is entered at the current market price. This is not supported by most markets.

string

reference
optional

Customer reference for the order. This is a free text field for the customer.

string

side
required

BUY or SELL.

string

tradable
required

The tradable identifier.

TradableId

traded_volume
required

The total traded volume of the order.

number(double)

validity
required

The validity period for the order.

Validity

volume
required

The original volume of the order.

number(double)

volume_condition
required

The volume condition on the order: NORMAL - All types of fills are accepted. ALL_OR_NOTHING - Partial fills are not accepted.

string

OrderReply

Name Description Schema

action_state
optional

The action state. This can be missing if the order fails the prevalidation and never enters the order system.

string

message
optional

Translated error message if result_code is not OK.

string

order_id
required

The Nordnet order identifier.

integer(int64)

order_state
optional

The order state. Only returned for valid orders.

string

result_code
required

OK or error code.

string

OrderType

Name Description Schema

name
required

The translated order type.

string

type
required

The order type code.

string

Position

Name Description Schema

accid
optional

The account identifier. An account identifier refers to a specific account for the duration of a session, but this is not guaranteed between sessions. Not applicable for partners.

integer(int64)

accno
required

The Nordnet account number. An account number always refers to a specific account.

integer(int64)

acq_price
required

The acquisition price in the tradable currency.

Amount

acq_price_acc
required

The acquisition price in the account currency.

Amount

instrument
required

The position instrument.

Instrument

margin_percent
required

The collateral percentage required to cover this position if short (qty < 0).

integer(int32)

market_value
required

The market value in the tradable currency.

Amount

market_value_acc
required

The market value in the account currency.

Amount

morning_price
required

The price of the position instrument in the morning

Amount

pawn_percent
required

The percentage the user is allowed loan on this position.

integer(int32)

qty
required

The quantity of the position.

number(float)

PriceInfo

Name Description Schema

ask
optional

Ask price, top of book.

PriceWithDecimals

ask_volume
optional

Ask volume, top of book.

integer(int64)

bid
optional

Bid price, top of book.

PriceWithDecimals

bid_volume
optional

Bid volume, top of book.

integer(int64)

close
optional

Close price.

PriceWithDecimals

diff
optional

Price difference since the last close price.

DiffWithDecimals

diff_pct
optional

Percent difference since the last close price.

number(double)

high
optional

Highest paid today.

PriceWithDecimals

last
optional

Last price.

PriceWithDecimals

low
optional

Lowest paid today.

PriceWithDecimals

open
optional

Open price.

PriceWithDecimals

realtime
optional

Set to true if the price information is based on a real-time snapshot.

boolean

spread
optional

Bid-ask spread.

PriceWithDecimals

spread_pct
optional

Bid-ask spread percent.

number(double)

tick_timestamp
optional

Last tick time stamp.

integer(int64)

turnover
optional

Daily turnover.

number(double)

turnover_volume
optional

Turnover volume.

integer(int64)

PriceKoInfo

Name Description Schema

indicative_high_risk
optional

High-risk (indicative.)

boolean

indicative_leverage
optional

Indicative leverage.

number(double)

risk_buffer
optional

Risk buffer.

number(double)

PriceWithDecimals

Name Description Schema

decimals
optional

Number of decimals.

integer(int32)

price
optional

Price amount.

number(double)

PublicTrade

Name Description Schema

broker_buying
optional

Buying participant.

string

broker_selling
optional

Selling participant.

string

price
required

The price of the trade.

number(double)

trade_id
required

The trade ID on the exchange.

string

trade_type
optional

The trade type defined by the exchange.

string

volume
required

The volume of the trade.

integer(int64)

StatisticalInfo

Name Description Schema

number_of_owners
optional

The number of Nordnet customers with positions in the instrument.

integer(int64)

statistics_timestamp
optional

Statistics time stamp.

integer(int64)

Status

Name Description Schema

message
required

Additional information.

string

system_running
required

Indicates if the system is running or temporarily stopped.

boolean

timestamp
required

Server time. UNIX timestamp in milliseconds.

integer(int64)

valid_version
required

true if the API version is valid.

boolean

StatusInfo

Name Description Schema

tick_timestamp
optional

The last tick timestamp

integer(int64)

trading_status
optional

The trading status

string

translated_trading_status
optional

The translated trading status

string

Stocklist

Name Description Schema

company_info
optional

Company information providing upcoming activity dates and other information associated with the company.

CompanyInfo

exchange_info
optional

Instrument exchange information.

ExchangeInfo

historical_returns_info
optional

Historical returns information showing the yield over time.

HistoricalReturnsInfo

instrument_info
optional

Instrument information. The same instrument information may appear in multiple search results for multiple instruments or fund universes.

InstrumentInfo

key_ratios_info
optional

Key ratios information describing the financial condition of the company (or the share.)

KeyRatiosInfo

market_info
optional

Market information. Identifies the origin market for the price information.

MarketInfo

price_info
optional

Price information representing an exchange-traded model containing top-of-book information.

PriceInfo

statistical_info
optional

Statistical information on the number of Nordnet customers with positions in the instrument and the number of orders.

StatisticalInfo

StocklistResults

Name Description Schema

results
optional

Stock search results.

< Stocklist > array

rows
optional

Number of results returned.

integer(int32)

total_hits
optional

Number of search hits.

integer(int64)

TicksizeInterval

Name Description Schema

decimals
required

The number of decimals used in this interval.

integer(int64)

from_price
required

The interval is valid from this price.

number(double)

tick
required

The tick size.

number(double)

to_price
required

The interval is valid to this price.

number(double)

TicksizeTable

Name Description Schema

tick_size_id
required

The unique tick size table ID.

integer(int64)

ticks
required

The tick size interval table.

< TicksizeInterval > array

TopStoryImageMeta

Name Description Schema

alt_text
optional

Image descriptive text.

string

copyright
required

Image copyright notice.

string

mime_type
required

Image MIME type.

string

sizes
required

Valid image sizes.

TopStoryImageSizes

version
required

Image version. top_story_image_size path is always updated when the version changes.

integer(int32)

TopStoryImageSize

Name Description Schema

height
required

Image height.

integer(int32)

path
required

Image path.

string

width
required

Image width.

integer(int32)

TopStoryImageSizes

Name Description Schema

large
required

Large image size.

TopStoryImageSize

medium
required

Medium image size.

TopStoryImageSize

small
required

Small image size.

TopStoryImageSize

Tradable

Name Description Schema

display_order
required

Determine the display order of the tradables for an instrument. The tradables should be shown in the order of increasing display_order numbers.

integer(int64)

identifier
required

Nordnet tradable identifier. The combination of market ID and identifier is unique.

string

lot_size
required

The lot size of the tradable.

number(double)

market_id
required

Nordnet market identifier.

integer(int64)

mic
required

The market identifier code (MIC) of the tradable.

string

price_unit
required

The unit that the prices is sent in. Examples: GBX for GBP with multiplier 0.01, % for bonds and the same as currency for normal instruments.

string

tick_size_id
required

Tick size identifier.

integer(int64)

TradableEligibility

Name Description Schema

eligible
required

true if the customer is eligible to trade the tradable.

boolean

identifier
required

The tradable identifier. The combination of market ID and tradable ID is unique.

string

market_id
required

The market identifier.

integer(int32)

TradableId

Name Description Schema

identifier
required

The Nordnet tradable identifier.

string

market_id
required

The Nordnet market identifier.

integer(int64)

TradableInfo

Name Description Schema

calendar
required

Allowed days for long term orders.

< CalendarDay > array

iceberg
required

true if iceberg orders are allowed.

boolean

identifier
required

The Nordnet tradable identifier. The combination of market ID and tradable ID is unique.

string

market_id
required

The Nordnet unique market identifier.

integer(int64)

order_types
required

Allowed order types.

< OrderType > array

TradablePublicTrades

Name Description Schema

identifier
required

The tradable identifier. The combination of market ID and tradable identifier is unique.

string

market_id
required

The Nordnet unique market identifier.

integer(int64)

trades
required

A list of the public trades.

< PublicTrade > array

Trade

Name Description Schema

accid
optional

The account identifier. An account identifier refers to a specific account for the duration of a session, but this is not guaranteed between sessions. Not applicable for partners.

integer(int64)

accno
required

The Nordnet account number. An account number always refers to a specific account.

integer(int64)

counterparty
optional

The counterparty if available.

string

order_id
required

Nordnet order identifier.

integer(int64)

price
required

The price of the trade.

Amount

side
required

BUY or SELL.

string

tradable
required

The tradable identifier.

TradableId

trade_id
optional

Trade identifier from the market if available.

string

tradetime
required

The time of the trade. UNIX timestamp in milliseconds.

integer(int64)

volume
required

The volume of the trade.

number(double)

UnderlyingInfo

Name Description Schema

instrument_id
required

Unique identifier of the underlying instrument.

integer(int64)

instrumment_id
optional

Unique identifier of the underlying instrument. (The field name is misspelled, but kept for legacy reasons.)

integer(int64)

isin_code
required

The ISIN code of the underlying instrument.

string

symbol
required

The symbol of the underlying instrument.

string

UnlimitedTurboEntity

Name Description Schema

etp_info
optional

ETP information.

EtpInfo

exchange_info
optional

Information regarding the instrument/tradable on the exchange.

ExchangeInfo

instrument_info
optional

Instrument information. The same content may appear in multiple search results if there are multiple tradables or fund universes.

InstrumentInfo

ko_calc_info
optional

Knock-out instrument related information.

KoCalcInfo

ko_info
optional

Information related to knock-out instruments.

KoInfo

market_info
optional

Identifies which market the price information is collected from.

MarketInfo

price_info
optional

Price information, representing an exchange-traded model containing top-of-book information.

PriceInfo

price_ko_info
optional

Knock-out instrument related price information.

PriceKoInfo

UnlimitedTurboListResults

Name Description Schema

results
optional

Unlimited Turbo search results.

< UnlimitedTurboEntity > array

rows
optional

Number of results returned.

integer(int32)

total_hits
optional

Number of search hits.

integer(int64)

underlying_instrument_id
optional

ID of the underlying instrument if and only if the results contain instruments with the same underlying instrument.

integer(int64)

Validity

Name Description Schema

type
required

DAY, UNTIL_DATE or IMMEDIATE

string

valid_until
optional

The cancel date, only used when type is UNTIL_DATE. UNIX timestamp in milliseconds.

integer(int64)

Security

basic

Type : basic

© 2024 Nordnet Bank AB.
Nordnet | Box 30099 | 104 25 Stockholm