OpenAPI
Open API Learn Tutorial Reference Docs Explorer Apps Updates Get 24 Hour Token Sign in
Other Products FIX Trading API Client Management Systems API End-of-Day File Transfers Trade Event Notification System OpenAPI for Excel

Data Formats

Data Formats

The OpenAPI will enforce input validation and rejects requests that are not providing data in correct formats with HTTP status code 400 - Bad Request.

Likewise, the API will deliver response data in a consistent manner according to the below data types.

JSON is currently the only supported content type. JSON objects are by nature fairly lenient, and in order to ensure consistency across the API most data types are only accepted in one or a few specific formats.

Simple Types

Type
Format
Accepted:
Rejected:Example from OpenAPI
Integer
  • Whole number
  • No single/double quotes
  • No digit grouping (commas and/or full stops)

123

4567

1000000

"123"

4567.75

1,000,000

"NetPositionsCount": 3
Decimal
  • Float with (optional) decimals
  • Decimal separator: full stop only
  • No single/double quotes
  • No digit grouping (commas and/or full stops)

12.3015

4567.75

1000000.80

"12.3015"

4567,75

1,000,000.80

"DefaultSlippage": 0.01
String
  • Double quotes
  • Characters and numbers
  • Cannot be a number
  • No white space
  • No Null values

"EURUSD"

"TrailingStop"

"NYSE_ARCA"

'EURUSD'

" "

"123"

"Name": "NASDAQ OMX Copenhagen"
Boolean
  • No quotes
  • No capitalization

true

false

True

"false"

"MarketDataViaOpenApiTermsAccepted": false
Enumerations
  • String-equivalent
  • No numbers
  • Optional capitalization

"FxSpot"

"DayOrder"

"dayorder"

"123"
"TradeLevel": "OrdersOnly"

Derived Types

Type
Accepted Format(s)
Examples
AccountGroupKeyString
"X1JlUyeXTMK3mBxzd-D2UA=="
AccountIdString
"9073876INET"
AccountKeyString
"KMgyuRfY-yDoSzDmdK-HZQ=="
AmountInteger or Decimal
2
2220745.77
AssetTypeEnumeration
"FxSpot"
ClientIdString
"9073876"
ClientKeyString
"X1JlUyaXTMK3mBxzd-D2UA=="
CountryCodeString - 2 upper case letters
"DK"
DateString - format: yyyy-MM-dd
"2018-11-01"
ExchangeIdString
"NYSE_ARCA"
LanguageCode

String - formatted as two lowercase letters and a two capital letters if applicable

"en"
"en-US"
OrderIdString
"84897763"
PercentageDecimal
69.44
PositionIdString
"241551543"
SectorIdInteger
5
SymbolString
"EURUSD"
UicInteger
21
UserIdString
"9073876"
UserKeyString
"X1JlUyeXTMK3mBxzd-D2UA=="
UtcDateTime

String - format:

yyyy-MM-ddTHH:mm:ss.ffffffZ

"2019-10-08T08:41:23.770000Z"