Instruments & Price Data

Instruments

Download Spec

All instrument related paths.

get/instruments

List instruments

trading_statusstring

Filters the list to only show instruments with a certain status (e.g. only instruments that can be currently traded).

Enum: ACTIVE
INACTIVE
Example: "ACTIVE"

sortstring

Sort the result by created_at or updated_at.

Default: "created_at"
Enum: created_at
updated_at

orderstring

Sort order of the result list if the sort parameter is specified. Use ASC for ascending or DESC for descending sort order.

Default: "ASC"
Enum: ASC
DESC

offsetint

Use the offset argument to specify where in the list of results to start when returning items for a particular query.

Format: int32
Min: 0

limitint

Use the limit argument to specify the maximum number of items returned.

Format: int32
Default: 100
Min: 0
Max: 1000

Responses

Response examples

{
  "meta": {
    "offset": 0,
    "limit": 100,
    "count": 1,
    "total_count": 10,
    "sort": "created_at",
    "order": "ASC"
  },
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2022-08-31T17:28:00.00Z",
      "updated_at": "2022-08-31T17:28:00.00Z",
      "isin": "DE0007664005",
      "wkn": "766400",
      "name": "Volkswagen (VW) St. Aktie.",
      "fractional_trading": true,
      "trading_status": "ACTIVE"
    }
  ]
}

get/instruments/{instrument_id}

Get instrument

Returns the instrument.

instrument_idOne Of

required

Instrument unique identifier.

Must match one of

International securities identification number defined by ISO 6166, prefixed with a 'isin:' URN scheme.

Pattern: ^(urn:)?isin:[A-Z]{2}[A-Z0-9]{9}[0-9]$

Responses

Response examples

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2022-08-31T17:28:00.00Z",
  "updated_at": "2022-08-31T17:28:00.00Z",
  "isin": "DE0007664005",
  "wkn": "766400",
  "name": "Volkswagen (VW) St. Aktie.",
  "fractional_trading": true,
  "trading_status": "ACTIVE"
}

webhook

Instruments events

idstring

required

Event unique identifier

Format: uuid

created_atstring

required

Date and time when the event was created. RFC 3339-5, ISO8601 UTC

Format: date-time

typestring

required

Event type

Enum: INSTRUMENT.ONBOARDED
INSTRUMENT.ACTIVATED
INSTRUMENT.DEACTIVATED
INSTRUMENT.FRACTIONAL_TRADING_ENABLED
INSTRUMENT.FRACTIONAL_TRADING_DISABLED
INSTRUMENT.DATA_CHANGED

objectobject

required

webhook_idstring

required

Webhook unique identifier.

Format: uuid

Responses

Request examples

{
  "id": "de4e9e75-5c74-44c7-b741-9b3e0d85f4de",
  "created_at": "2022-08-31T17:28:00.00Z",
  "type": "INSTRUMENT.ACTIVATED",
  "object": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2022-03-31T17:28:00.00Z",
    "updated_at": "2022-08-31T17:28:00.00Z",
    "isin": "DE0007664005",
    "wkn": "766400",
    "name": "Volkswagen (VW) St. Aktie.",
    "fractional_trading": true,
    "trading_status": "ACTIVE"
  },
  "webhook_id": "0af63506-289c-4051-8859-4e17ec89b002"
}

Response examples

Request has been processed successfully.

Empty response

Was this page helpful?