SymbolsScope: symbolsData API

The collection of the available trading symbols. Please note that the symbol list is subject to change, and it needs to be updated from time to time.

/2.0/symbols

get

HTTP status code 200

Media type: application/json

Items: Symbol list

  • optionData: (object)
    • optionGroupId (string)
      Option group id.
    • right: required (one of CALL, PUT)
    • strikePrice: required (string)

      Strike price of the option

  • i18n: (string)

    Object with localized descriptions

  • name: (string)

    Symbol name

  • description: required (string)

    Symbol description

  • country: (string)

    Country of symbol's exchange

  • exchange: (string)

    Exchange id where the symbol is traded

  • id: required (string)

    Internal symbol id

  • currency: required (string)

    Currency of symbol price

  • mpi: required (string)

    Minimum possible increment of symbol price

  • type: required (string)

    Symbol type

  • ticker: required (string)

    Exchange ticker

  • expiration: (string)

    Expiration timestamp in ms, applicable to Futures, Options and Bonds

  • group: (string)

    Group of symbol, applicable to Futures and Options

Example:

[  [
  {
    "optionData": {
      "optionGroupId": "RTS.FORTS.18M2020.P*",
      "right": "PUT",
      "strikePrice": "122500"
    },
    "i18n": {},
    "name": "Russian Trading System Index",
    "description": "Options On Russian Trading System Index Future 18 Jun 2020    PUT 122500",
    "country": "RU",
    "exchange": "FORTS",
    "id": "RTS.FORTS.18M2020.P122500",
    "currency": "USD",
    "mpi": "10.0",
    "type": "OPTION",
    "ticker": "RTS",
    "expiration": 1592495100000,
    "group": "RTS2"
  },
  {
    "optionData": {
      "optionGroupId": "MRK.CBOE.18V2019.P*",
      "right": "PUT",
      "strikePrice": "110"
    },
    "i18n": {},
    "name": "Merck & Company",
    "description": "Options On Merck & Company 18 Oct 2019 PUT 110",
    "country": "US",
    "exchange": "CBOE",
    "id": "MRK.CBOE.18V2019.P110",
    "currency": "USD",
    "mpi": "0.01",
    "type": "OPTION",
    "ticker": "MRK",
    "expiration": 1571428800000,
    "group": "MRK"
  },
  {
    "optionData": {
      "optionGroupId": "VIX.CBOE.21Q2019.C*",
      "right": "CALL",
      "strikePrice": "22"
    },
    "i18n": {},
    "name": "CBOE Market Volatility Index",
    "description": "Options On CBOE Market Volatility Index 21 Aug 2019 CALL 22",
    "country": "US",
    "exchange": "CBOE",
    "id": "VIX.CBOE.21Q2019.C22",
    "currency": "USD",
    "mpi": "0.05",
    "type": "OPTION",
    "ticker": "VIX",
    "expiration": 1566332100000,
    "group": "VIX"
  }
]

/2.0/symbols/{symbolId}

get

URI Parameters

  • symbolId: required (string)

HTTP status code 200

Media type: application/json

Properties
  • optionData: (object)
    • optionGroupId (string)
      Option group id.
    • right: required (one of CALL, PUT)
    • strikePrice: required (string)

      Strike price of the option

  • i18n: (string)

    Object with localized descriptions

  • name: (string)

    Symbol name

  • description: required (string)

    Symbol description

  • country: (string)

    Country of symbol's exchange

  • exchange: (string)

    Exchange id where the symbol is traded

  • id: required (string)

    Internal symbol id

  • currency: required (string)

    Currency of symbol price

  • mpi: required (string)

    Minimum possible increment of symbol price

  • type: required (string)

    Symbol type

  • ticker: required (string)

    Exchange ticker

  • expiration: (string)

    Expiration timestamp in ms, applicable to Futures, Options and Bonds

  • group: (string)

    Group of symbol, applicable to Futures and Options

HTTP status code 404

Symbol wasn’t found or unavailable.

/2.0/symbols/{symbolId}/specification

get

URI Parameters

  • symbolId: required (string)

HTTP status code 200

Media type: application/json

Properties
  • leverage: required (string)

    Leverage rate available for this instrument. For instance, 0.2 stands for leverage 1:5.

  • contractMultiplier: required (string)

    Trade amount should be a multiplier of this value, mostly for Futures and Options

  • priceUnit: required (string)
  • units: required (string)

    Units of measurement

  • lotSize: required (string)

    Minimum lot size on exchange (may be optional for some exchanges)

Example:

{
  "leverage": "0.2",
  "contractMultiplier": "1.0",
  "priceUnit": "1.0",
  "units": "Shares",
  "lotSize": "1.0"
}

HTTP status code 404

Symbol wasn't found or unavailable.

/2.0/symbols/{symbolId}/schedule

get

URI Parameters

  • symbolId: required (string)
  • types: (boolean - default: false)

    Show order types

HTTP status code 200

Media type: application/json

Properties
  • intervals: required (array of items)

    Items: items

    • name: required (string)

      Trading session name. May be PreMarket, AfterMarket or MainSession / Online

    • period: required (object)
      • start: required (string)

        Session start timestamp in ms

      • end: required (string)

        Session finish timestamp in ms

    • orderTypes: (object)

      Available order types

      • limit: required (array of Duration)
      • market: required (array of Duration)
      • pegged: required (array of Duration)
      • stop: required (array of Duration)
      • stop_limit: required (array of Duration)
      • trailing_stop: required (array of Duration)
      • twap: required (array of Duration)
      • iceberg: required (array of Duration)

Example:

{
  "intervals": [
    {
      "name": "PreMarket",
      "period": {
        "start": 1481533200000,
        "end": 1481553000000
      }
    },
    {
      "name": "MainSession",
      "period": {
        "start": 1481553000000,
        "end": 1481576400000
      }
    },
    {
      "name": "AfterMarket",
      "period": {
        "start": 1481576400000,
        "end": 1481590800000
      },
      "orderTypes": {
        "limit": [
          "day",
          "good_till_cancel",
          "good_till_time"
        ],
        "market": [
          "day",
          "good_till_cancel",
          "good_till_time"
        ],
        "stop": [
          "day",
          "good_till_cancel",
          "good_till_time"
        ],
        "stop_limit": [
          "day",
          "good_till_cancel",
          "good_till_time"
        ]
      }
    }
  ]
}

HTTP status code 404

Symbol wasn't found or unavailable

ExchangesScope: symbolsData API

Collection of available exchanges.

/2.0/exchanges

get

HTTP status code 200

Media type: application/json

Items: Exchange list

  • id: required (string)

    Exchange internal id

  • name: required (string)

    Full exchange name

  • country: required (string)

    Exchange country

Example:

[
  {
    "id": "NASDAQ",
    "name": "NASDAQ: National Association of Securities Dealers Automated Quotations",
    "country": "US"
  }
]

/2.0/exchanges/{exchangeId}

get

URI Parameters

  • exchangeId: required (string)

HTTP status code 200

Media type: application/json

Items: Symbol list

  • optionData: (object)
    • optionGroupId (string)
      Option group id.
    • right: required (one of CALL, PUT)
    • strikePrice: required (string)

      Strike price of the option

  • i18n: (string)

    Object with localized descriptions

  • name: (string)

    Symbol name

  • description: required (string)

    Symbol description

  • country: (string)

    Country of symbol's exchange

  • exchange: (string)

    Exchange id where the symbol is traded

  • id: required (string)

    Internal symbol id

  • currency: required (string)

    Currency of symbol price

  • mpi: required (string)

    Minimum possible increment of symbol price

  • type: required (string)

    Symbol type

  • ticker: required (string)

    Exchange ticker

  • expiration: (string)

    Expiration timestamp in ms, applicable to Futures, Options and Bonds

  • group: (string)

    Group of symbol, applicable to Futures and Options

HTTP status code 404

Specified exchange has not found or unavailable.

TypesScope: symbolsData API

Collection of available instrument types.

/2.0/types

get

HTTP status code 200

Media type: application/json

Example:

[
  {
    "id": "FX_SPOT"
  },
  {
    "id": "FUND"
  },
  {
    "id": "CURRENCY"
  },
  {
    "id": "FUTURE"
  },
  {
    "id": "BOND"
  },
  {
    "id": "STOCK"
  },
  {
    "id": "OPTION"
  }
]

/2.0/types/{type}

get

URI Parameters

  • type: required (string)

HTTP status code 200

Media type: application/json

Items: Symbol list

  • optionData: (object)
    • optionGroupId (string)
      Option group id.
    • right: required (one of CALL, PUT)
    • strikePrice: required (string)

      Strike price of the option

  • i18n: (string)

    Object with localized descriptions

  • name: (string)

    Symbol name

  • description: required (string)

    Symbol description

  • country: (string)

    Country of symbol's exchange

  • exchange: (string)

    Exchange id where the symbol is traded

  • id: required (string)

    Internal symbol id

  • currency: required (string)

    Currency of symbol price

  • mpi: required (string)

    Minimum possible increment of symbol price

  • type: required (string)

    Symbol type

  • ticker: required (string)

    Exchange ticker

  • expiration: (string)

    Expiration timestamp in ms, applicable to Futures, Options and Bonds

  • group: (string)

    Group of symbol, applicable to Futures and Options

HTTP status code 404

Specified type has not found or unavailable.

GroupsScope: symbolsData API

Some symbols can be grouped by their underlying asset. For instance, futures on Brent Crude Oil will have group B.ICE.

/2.0/groups

get

HTTP status code 200

Media type: application/json

Items: Group list

  • group: required (string)

    Group id

  • name: (string)

    Group title

  • types: required (array of )

    List of symbol types in group

  • exchange: (string)

    Exchange id where group is traded

Example:

[
  {
    "group": "NG",
    "name": "Henry Hub Natural Gas",
    "types": [ "FUTURE" ],
    "exchange": "NYMEX"
  },
  {
    "group": "GDX",
    "name": "Market Vectors Gold Miners ETF",
    "types": [ "OPTION" ],
    "exchange": "CBOE"
  }
]

/2.0/groups/{groupId}

get

URI Parameters

  • groupId: required (string)

HTTP status code 200

Media type: application/json

Items: Symbol list

  • optionData: (object)
    • optionGroupId (string)
      Option group id.
    • right: required (one of CALL, PUT)
    • strikePrice: required (string)

      Strike price of the option

  • id: required (string)

    Internal symbol id

  • ticker: required (string)

    Exchange ticker

  • name: (string)

    Symbol name

  • description: required (string)

    Symbol description

  • exchange: (string)

    Exchange id where the symbol is traded

  • country: (string)

    Country of symbol's exchange

  • type: required (string)

    Symbol type

  • mpi: required (string)

    Minimum possible increment of symbol price

  • i18n: (string)

    Object with localized descriptions

  • currency: required (string)

    Currency of symbol price

  • group: (string)

    Group of symbol, applicable to Futures and Options

  • expiration: (string)

    Expiration timestamp in ms, applicable to Futures, Options and Bonds

HTTP status code 404

Specified group has not found or unavailable.

/2.0/groups/{groupId}/nearest

get

URI Parameters

  • groupId: required (string)

HTTP status code 200

Media type: application/json

Properties
  • optionData: (object)
    • optionGroupId (string)
      Option group id.
    • right: required (one of CALL, PUT)
    • strikePrice: required (number)

      Strike price of the option

  • id: required (string)

    Internal symbol id

  • ticker: required (string)

    Exchange ticker

  • name: (string)

    Symbol name

  • description: required (string)

    Symbol description

  • exchange: (string)

    Exchange id where the symbol is traded

  • country: (string)

    Country of symbol's exchange

  • type: required (string)

    Symbol type

  • mpi: required (string)

    Minimum possible increment of symbol price

  • i18n: (string)

    Object with localized descriptions

  • currency: required (string)

    Currency of symbol price

  • group: (string)

    Group of symbol, applicable to Futures and Options

  • expiration: (string)

    Expiration timestamp in ms, applicable to Futures, Options and Bonds

HTTP status code 404

Specified group has not found or unavailable or contains no Futures.

OHLC (2.0)Scope: ohlcData API

OHLC stands for Open-High-Low-Close — candles — and can be used to build candlestick charts. Several aggregation intervals are available. OHLC version 2.0 allows getting historical data for quotes.

/2.0/ohlc/{symbolId}/{duration}

get

URI Parameters

  • symbolId: required (string)
  • duration: required (one of 60 (1 min), 300 (5 min), 600 (10 min), 900 (15 min), 3600 (1 hour), 21600 (6 hours), 86400 (1 day))

    Aggregation interval in seconds

Query Parameters

  • from: (number)

    Specify starting timestamp in ms

  • to: (number)

    Specify ending timestamp in ms

  • size: (integer - default: 60)

    Specify maximum amount of candles to retrieve

  • type: required (string): trades or quotes

    Trades or quotes.

HTTP status code 200

Media type: application/json

Items: OHLC list for trades

  • timestamp: required (string)
  • open: required (string)
  • high: required (string)
  • low: required (string)
  • close: required (string)
  • volume: required (string)

Example:

[
  {
    "timestamp": 1556131440000,
    "open": "260.4203",
    "low": "260.4203",
    "close": "260.4203",
    "volume": "250",
    "high": "260.4203"
  },
  {
    "timestamp": 1556131440000,
    "open": "260.4203",
    "low": "260.4203",
    "close": "260.4203",
    "volume": "250",
    "high": "260.4203"
  },
  {
    "timestamp": 1556131380000,
    "open": "260.24",
    "low": "260.24",
    "close": "260.39",
    "volume": "3418",
    "high": "260.47"
  },
  {
    "timestamp": 1556131320000,
    "open": "260.2977",
    "low": "260.21",
    "close": "260.25",
    "volume": "6818",
    "high": "260.4"
  },
  {
    "timestamp": 1556131260000,
    "open": "260.22",
    "low": "260.18",
    "close": "260.3",
    "volume": "13926",
    "high": "260.397"
  }
]

Items: OHLC list for quotes

  • timestamp: required (string)
  • open: required (string)
  • high: required (string)
  • low: required (string)
  • close: required (string)

Example:

[
  {
    "timestamp": 1556131440000,
    "open": "260.375",
    "low": "260.375",
    "close": "260.375",
    "high": "260.375"
  },
  {
    "timestamp": 1556131380000,
    "open": "260.22",
    "low": "260.22",
    "close": "260.42",
    "high": "260.435"
  },
  {
    "timestamp": 1556131320000,
    "open": "260.31",
    "low": "260.245",
    "close": "260.25",
    "high": "260.385"
  },
  {
    "timestamp": 1556131260000,
    "open": "260.24",
    "low": "260.2",
    "close": "260.325",
    "high": "260.345"
  },
  {
    "timestamp": 1556131200000,
    "open": "260.18",
    "low": "260.18",
    "close": "260.22",
    "high": "260.22"
  }
]

HTTP status code 404

Requested symbol has not found or unavailable.

TicksScope: ohlcData API

Tick data.

/2.0/ticks/{symbolId}

get

URI Parameters

  • symbolId: required (string)

Query Parameters

  • size: (integer - default: 60)

    Specify maximum amount of candles to retrieve

  • type: required (string): trades or quotes

    Trades or quotes.

  • from: (number)

    Specify starting timestamp in ms

  • to: (number)

    Specify ending timestamp in ms

HTTP status code 200

Media type: application/json

Items: ticks list for trades

  • timestamp: required (string)
  • value: required (string)
  • size: required (string)

Example:

[
  {
    "timestamp": 1556131477917,
    "symbolId": "TSLA.NASDAQ",
    "value": "260.4203",
    "size": "250"
  },
  {
    "timestamp": 1556131439665,
    "symbolId": "TSLA.NASDAQ",
    "value": "260.39",
    "size": "1767"
  },
  {
    "timestamp": 1556131439324,
    "symbolId": "TSLA.NASDAQ",
    "value": "260.47",
    "size": "251"
  },
  {
    "timestamp": 1556131439324,
    "symbolId": "TSLA.NASDAQ",
    "value": "260.46",
    "size": "200"
  },
  {
    "timestamp": 1556131439324,
    "symbolId": "TSLA.NASDAQ",
    "value": "260.44",
    "size": "100"
  }
]

Items: ticks list for quotes

  • timestamp: required (string)
  • symbolId: required (string)
  • ask: required (array of items)

    Items: items

    • size: required (string)
    • value: required (string)
  • bid: required (array of items)

    Items: items

    • size: required (string)
    • value: required (string)

Example:

[
  {
    "timestamp": 1556131479991,
    "symbolId": "TSLA.NASDAQ",
    "bid": [
      {
        "value": "260.3",
        "size": "400"
      }
    ],
    "ask": [
      {
        "value": "260.45",
        "size": "200"
      }
    ]
  },
  {
    "timestamp": 1556131439215,
    "symbolId": "TSLA.NASDAQ",
    "bid": [
      {
        "value": "260.38",
        "size": "100"
      }
    ],
    "ask": [
      {
        "value": "260.46",
        "size": "100"
      }
    ]
  },
  {
    "timestamp": 1556131439015,
    "symbolId": "TSLA.NASDAQ",
    "bid": [
      {
        "value": "260.4",
        "size": "100"
      }
    ],
    "ask": [
      {
        "value": "260.47",
        "size": "500"
      }
    ]
  },
  {
    "timestamp": 1556131434872,
    "symbolId": "TSLA.NASDAQ",
    "bid": [
      {
        "value": "260.34",
        "size": "200"
      }
    ],
    "ask": [
      {
        "value": "260.47",
        "size": "800"
      }
    ]
  },
  {
    "timestamp": 1556131430470,
    "symbolId": "TSLA.NASDAQ",
    "bid": [
      {
        "value": "260.34",
        "size": "200"
      }
    ],
    "ask": [
      {
        "value": "260.48",
        "size": "1200"
      }
    ]
  }
]

HTTP status code 404

Requested symbol wasn’t found or unavailable.

Feed streamScope: feedData API

Stream of symbol(s) price updates.

/2.0/feed/{symbolIds}

get

URI Parameters

  • symbolIds: required (string)

    Symbol or comma-delimited symbols to request quotes.

    Examples:

    MSFT.NASDAQ,AAPL.NASDAQ,GAZP.MICEX

Headers

  • Accept: (string - default: text/event-stream)

    Specify stream format: text/event-stream or application/x-json-stream.

    text/event-stream is standard media-type for Server-Sent Events (SSE). For more information on this please refer to https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events

    Please note today there is no way to pass headers (like Authorization) in browser using SSE, so you need to use token query parameter to pass authentication token.

    application/x-json-stream is just newline delimited json stream.

HTTP status code 200

Media type: text/event-stream

Example:

id: 1
data: {"timestamp":1481643841200,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.3", "size": "1"}],"ask":[{"value": "115.31", "size": "1"}]}

id: 2
data: {"timestamp":1481643846625,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.3", "size": "1"}],"ask":[{"value": "115.32", "size": "1"}]}

Media type: application/x-json-stream

Example:

{"timestamp":1481643866925,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.21", "size": "1"}],"ask":[{"value": "115.2", "size": "1"}]}
{"timestamp":1481643912200,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.3", "size": "1"}],"ask":[{"value": "115.31", "size": "1"}]}
{"timestamp":1481643963900,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.29", "size": "1"}],"ask":[{"value": "115.30", "size": "1"}]}
{"timestamp":1481643973550,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.33", "size": "1"}],"ask":[{"value": "115.34", "size": "1"}]}
{"timestamp":1481643977025,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.31", "size": "1"}],"ask":[{"value": "115.32", "size": "1"}]}
{"timestamp":1481644016325,"symbolId":"AAPL.NASDAQ","bid":[{"value": "115.25", "size": "1"}],"ask":[{"value": "115.26", "size": "1"}]}

HTTP status code 404

No symbols were found or available.

/2.0/feed/{symbolIds}/last

get

URI Parameters

  • symbolIds: required (string)

    Symbol or comma-delimited symbols to request quotes.

    Examples:

    MSFT.NASDAQ,AAPL.NASDAQ,GAZP.MICEX

Query Parameters

  • level: (string - default: best_price)

    Quote level, one of

    market_depth
    or
    best_price
    .

HTTP status code 200

Media type: application/json

Example:

[
  {
    "timestamp": 1556193240198,
    "symbolId": "AAPL.NASDAQ",
    "bid": [
      {
        "value": "207.54",
        "size": "200.0"
      }
    ],
    "ask": [
      {
        "value": "207.59",
        "size": "100.0"
      }
    ]
  }
]

HTTP status code 404

No symbols were found or available.

Daily changeScope: changeData API

Collection of daily change data.

/2.0/change

get

HTTP status code 200

Media type: application/json

Items: DailyChange list

  • symbolId: required (string)

    Related symbol id

  • basePrice: required (string)

    Symbol price at the end of last day (UTC)

  • dailyChange: required (string)

    Absolute daily change of the price at the moment of request

Example:

[
  {
    "symbolId": "HINT.LSE",
    "basePrice": 1.45625,
    "dailyChange": 0.00625
  },
  {
    "symbolId": "REP.ES",
    "basePrice": 12.93,
    "dailyChange": -0.2475
  },
  {
    "symbolId": "1161.HKEX",
    "basePrice": 0.58,
    "dailyChange":0.005
  }
]

/2.0/change/{symbolIds}

get

URI Parameters

  • symbolIds: required (string)

    Symbol or comma-delimited symbols to request daily change.

    Examples:

    MSFT.NASDAQ,AAPL.NASDAQ,GAZP.MICEX

HTTP status code 200

Media type: application/json

Items: DailyChange list

  • symbolId: required (string)

    Related symbol id

  • basePrice: required (string)

    Symbol price at the end of last day (UTC)

  • dailyChange: required (string)

    Absolute daily change of the price at the moment of request

HTTP status code 404

No symbols were found or available.

CrossratesScope: crossratesData API

Collection of currency crossrates.

/2.0/crossrates

get

HTTP status code 200

Media type: application/json

Example:

{
  "currencies": [
    "USD",
    "RUB",
    "NZD",
    "NOK",
    "EUR"
  ]
}

/2.0/crossrates/{from}/{to}

get

URI Parameters

  • from: required (string)

    First currency in crossrate pair

  • to: required (string)

    Second currency in crossrate pair

HTTP status code 200

Media type: application/json

Properties
  • pair: required (string)
  • rate: required (string)

    Current crossrate

  • symbolId: (string)

    Optional symbol id, which can be used to request history or subscribe to feed

Example:

{
  "pair": "EUR/USD",
  "symbolId": "EUR/USD.EXANTE",
  "rate": 1.0622
}

HTTP status code 404

Requested pair has not found or unavailable.

Trade API

Resources exposed in this section give access to trading and reporting.

Please note, Trade API has different endpoint URI from Market Data API.

OrdersScope: ordersTrade API

/2.0/orders

get

Query Parameters

  • limit: (integer - default: 10)

    The limit for max items of the order list

  • account: (string)

    The account list

  • from: (string)

    Specify starting timestamp in ISO format

  • to: (string)

    Specify ending timestamp in ISO format

HTTP status code 200

Return the list of trading orders

Media type: application/json

Items: Order list

  • placeTime: required (string)
  • orderState: required (object)
    • status: required (one of created, accepted, placing, working, cancelled, pending, filled, rejected)
    • lastUpdate: required (string)
    • fills: required (array of items)

      Items: items

      • time: required (string)
      • quantity: required (string)
      • price: required (string)
      • position: required (number)
    • reason: (string)
  • accountId: required (string)
  • id: required (string)
  • clientTag: (string)

    custom description

  • orderParameters: required (object)
    • side: required (one of buy, sell)
    • duration: required (one of day, fill_or_kill, immediate_or_cancel, good_till_cancel, good_till_time, at_the_opening, at_the_close)
    • quantity: required (string)
    • ocoGroup: (string)

      the OCO group identifier

    • ifDoneParentId: (string)

      the parent order identifier

    • orderType: required (one of market, limit, stop, stop_limit, trailing_stop, twap, iceberg)
    • limitPrice: (string)
    • instrument: required (string)
    • stopPrice: (string)
    • gttExpiration: (string)

      required only for good_till_time orders; format 2017-05-18T10:00:00.000Z

    • priceDistance: (number)

      required only for trailing_stop order

    • placeInterval: (integer)

      required only for twap order

    • partQuantity: (number)

      required only for twap and iceberg orders

  • currentModificationId: required (string)

Example:

[
  {
    "placeTime": "2019-05-20T08:51:42.776Z",
    "orderState": {
      "status": "pending",
      "lastUpdate": "2019-05-20T08:51:42.776Z",
      "fills": []
    },
    "accountId": "WWB1220.001",
    "id": "5a5562e4-cef0-4c79-ab84-840c8890af74",
    "clientTag": "",
    "orderParameters": {
      "side": "buy",
      "duration": "day",
      "quantity": "10",
      "ocoGroup": null,
      "ifDoneParentId": null,
      "orderType": "market",
      "instrument": "TSLA.NASDAQ"
    },
    "currentModificationId": "5a5562e4-cef0-4c79-ab84-840c8890af74"
  },
  {
    "placeTime": "2019-05-20T08:50:58.693Z",
    "orderState": {
      "status": "pending",
      "lastUpdate": "2019-05-20T08:50:58.693Z",
      "fills": []
    },
    "accountId": "WWB1220.001",
    "id": "becfc415-8484-40d8-8a35-25f0c5f6f873",
    "clientTag": "",
    "orderParameters": {
      "side": "buy",
      "duration": "day",
      "quantity": "10",
      "ocoGroup": null,
      "ifDoneParentId": null,
      "orderType": "market",
      "instrument": "TSLA.NASDAQ"
    },
    "currentModificationId": "becfc415-8484-40d8-8a35-25f0c5f6f873"
  },
 {
    "placeTime": "2019-04-26T09:31:33.759Z",
    "orderState": {
      "status": "filled",
      "lastUpdate": "2019-04-26T13:30:00.755Z",
      "fills": [
        {
          "time": "2019-04-26T13:30:00.755Z",
          "quantity": "1E+1",
          "price": "246.3",
          "position": 0
        }
      ]
    },
    "accountId": "WWB1220.001",
    "id": "bc2a4eea-96cf-43f0-8a7c-d3833565519d",
    "clientTag": "",
    "orderParameters": {
      "side": "buy",
      "duration": "day",
      "quantity": "10",
      "ocoGroup": null,
      "ifDoneParentId": null,
      "orderType": "market",
      "instrument": "TSLA.NASDAQ"
    },
    "currentModificationId": "bc2a4eea-96cf-43f0-8a7c-d3833565519d"
  }
]

HTTP status code 400

The query parameters do not have correct format

HTTP status code 500

Internal server error

post

Body

Media type: application/json

Properties
  • accountId: required (string)
  • instrument: required (string)
  • side: required (one of buy, sell)
  • quantity: required (string)
  • orderType: required (one of market, limit, stop, stop_limit, trailing_stop, twap, iceberg)
  • takeProfit: (string)

    Price of take profit order

  • stopLoss: (string)

    Price of stop loss order

  • duration: required (one of day, fill_or_kill, immediate_or_cancel, good_till_cancel, good_till_time, at_the_opening, at_the_close)
  • stopPrice: (string)
  • limitPrice: (string)
  • gttExpiration: (string)

    required only for good_till_time orders; format 2017-05-18T10:00:00.000Z

  • clientTag: (string)

    custom description

  • ocoGroup: (string)

    the OCO group identifier

  • ifDoneParentId: (string)

    the parent order identifier

  • priceDistance: (number)

    required only for trailing_stop order

  • placeInterval: (integer)

    required only for twap order

  • partQuantity: (number)

    required only for twap and iceberg orders

HTTP status code 201

Media type: application/json

Properties
  • placeTime: required (string)
  • orderState: required (object)
    • status: required (one of created, accepted, placing, working, cancelled, pending, filled, rejected)
    • lastUpdate: required (string)
    • fills: required (array of items)

      Items: items

      • time: required (string)
      • quantity: required (string)
      • price: required (string)
      • position: required (number)
    • reason: (string)
  • accountId: required (string)
  • id: required (string)
  • clientTag: (string)

    custom description

  • orderParameters: required (object)
    • side: required (one of buy, sell)
    • duration: required (one of day, fill_or_kill, immediate_or_cancel, good_till_cancel, good_till_time, at_the_opening, at_the_close)
    • quantity: required (string)
    • ocoGroup: (string)

      the OCO group identifier

    • ifDoneParentId: (string)

      the parent order identifier

    • orderType: required (one of market, limit, stop, stop_limit, trailing_stop, twap, iceberg)
    • limitPrice: (string)
    • instrument: required (string)
    • stopPrice: (string)
    • gttExpiration: (string)

      required only for good_till_time orders; format 2017-05-18T10:00:00.000Z

    • priceDistance: (number)

      required only for trailing_stop order

    • placeInterval: (integer)

      required only for twap order

    • partQuantity: (number)

      required only for twap and iceberg orders

  • currentModificationId: required (string)

Example:

[
  {
    "placeTime": "2019-05-20T08:51:42.776Z",
    "orderState": {
      "status": "pending",
      "lastUpdate": "2019-05-20T08:51:42.776Z",
      "fills": []
    },
    "accountId": "WWB1220.001",
    "id": "5a5562e4-cef0-4c79-ab84-840c8890af74",
    "clientTag": "",
    "orderParameters": {
      "side": "buy",
      "duration": "day",
      "quantity": "10",
      "ocoGroup": null,
      "ifDoneParentId": null,
      "orderType": "market",
      "instrument": "TSLA.NASDAQ"
    },
    "currentModificationId": "5a5562e4-cef0-4c79-ab84-840c8890af74"
  }
]

HTTP status code 400

Order placing parameters are incorrect.

/2.0/orders/active

get

Query Parameters

  • limit: (integer - default: 10)

    The limit for max items of the order list

  • account: (string)

    The account list

  • instrument: (string)

    The instrument identifier

HTTP status code 200

Return the list of trading orders

Media type: application/json

Items: Order list

  • placeTime: required (string)
  • orderState: required (object)
    • status: required (one of created, accepted, placing, working, cancelled, pending, filled, rejected)
    • lastUpdate: required (string)
    • fills: required (array of items)

      Items: items

      • time: required (string)
      • quantity: required (string)
      • price: required (string)
      • position: required (number)
    • reason: (string)
  • accountId: required (string)
  • id: required (string)
  • clientTag: (string)

    custom description

  • orderParameters: required (object)
    • side: required (one of buy, sell)
    • duration: required (one of day, fill_or_kill, immediate_or_cancel, good_till_cancel, good_till_time, at_the_opening, at_the_close)
    • quantity: required (string)
    • ocoGroup: (string)

      the OCO group identifier

    • ifDoneParentId: (string)

      the parent order identifier

    • orderType: required (one of market, limit, stop, stop_limit, trailing_stop, twap, iceberg)
    • limitPrice: (string)
    • instrument: required (string)
    • stopPrice: (string)
    • gttExpiration: (string)

      required only for good_till_time orders; format 2017-05-18T10:00:00.000Z

    • priceDistance: (number)

      required only for trailing_stop order

    • placeInterval: (integer)

      required only for twap order

    • partQuantity: (number)

      required only for twap and iceberg orders

  • currentModificationId: required (string)

Example:

[
  {
    "placeTime": "2019-04-26T09:31:33.759Z",
    "orderState": {
      "status": "pending",
      "lastUpdate": "2019-04-26T09:31:33.759Z",
      "fills": []
    },
    "accountId": "WWB1220.001",
    "id": "bc2a4eea-96cf-43f0-8a7c-d3833565519d",
    "clientTag": "",
    "orderParameters": {
      "side": "buy",
      "duration": "day",
      "quantity": "10",
      "ocoGroup": null,
      "ifDoneParentId": null,
      "orderType": "market",
      "instrument": "TSLA.NASDAQ"
    },
    "currentModificationId": "bc2a4eea-96cf-43f0-8a7c-d3833565519d"
  },
  {
    "placeTime": "2019-04-26T09:30:28.029Z",
    "orderState": {
      "status": "pending",
      "lastUpdate": "2019-04-26T09:30:28.029Z",
      "fills": []
    },
    "accountId": "WWB1220.001",
    "id": "644b60f4-f37f-43b3-adf8-e54aac099442",
    "clientTag": "",
    "orderParameters": {
      "side": "buy",
      "duration": "day",
      "quantity": "10",
      "ocoGroup": null,
      "ifDoneParentId": null,
      "orderType": "market",
      "instrument": "TSLA.NASDAQ"
    },
    "currentModificationId": "644b60f4-f37f-43b3-adf8-e54aac099442"
  },
  {
    "placeTime": "2019-03-01T12:08:33.555Z",
    "orderState": {
      "status": "working",
      "lastUpdate": "2019-04-03T10:57:25.934Z",
      "fills": []
    },
    "accountId": "WWB1220.001",
    "id": "1cf4ef3d-68b7-482b-8f55-bea6714bc764",
    "clientTag": "TradingFull",
    "orderParameters": {
      "side": "buy",
      "duration": "good_till_cancel",
      "quantity": "1",
      "ocoGroup": null,
      "ifDoneParentId": null,
      "orderType": "limit",
      "limitPrice": "3600",
      "instrument": "BTC.EXANTE"
    },
    "currentModificationId": "1cf4ef3d-68b7-482b-8f55-bea6714bc764"
  }
]

HTTP status code 400

The query parameters are of incorrect format.

/2.0/orders/{id}

get

URI Parameters

  • id: required (string)

    Order identifier

HTTP status code 200

Return the trading order

Media type: application/json

Properties
  • placeTime: required (string)
  • orderState: required (object)
    • status: required (one of created, accepted, placing, working, cancelled, pending, filled, rejected)
    • lastUpdate: required (string)
    • fills: required (array of items)

      Items: items

      • time: required (string)
      • quantity: required (string)
      • price: required (string)
      • position: required (number)
    • reason: (string)
  • accountId: required (string)
  • id: required (string)
  • clientTag: (string)

    custom description

  • orderParameters: required (object)
    • side: required (one of buy, sell)
    • duration: required (one of day, fill_or_kill, immediate_or_cancel, good_till_cancel, good_till_time, at_the_opening, at_the_close)
    • quantity: required (string)
    • ocoGroup: (string)

      the OCO group identifier

    • ifDoneParentId: (string)

      the parent order identifier

    • orderType: required (one of market, limit, stop, stop_limit, trailing_stop, twap, iceberg)
    • limitPrice: (string)
    • instrument: required (string)
    • stopPrice: (string)
    • gttExpiration: (string)

      required only for good_till_time orders; format 2017-05-18T10:00:00.000Z

    • priceDistance: (number)

      required only for trailing_stop order

    • placeInterval: (integer)

      required only for twap order

    • partQuantity: (number)

      required only for twap and iceberg orders

  • currentModificationId: required (string)

Example:

{
  "placeTime": "2018-03-23T13:55:05.076Z",
  "orderState": {
    "status": "rejected",
    "lastUpdate": "2018-03-23T13:55:05.116Z",
    "fills": [],
    "reason": "Limit exceeded (position: -10, active: 0 long / 0 short)"
  },
  "accountId": "WWB1220.001",
  "id": "d0c7b0dd-0212-406b-8bbf-095740ded26e",
  "clientTag": "TradingFull",
  "orderParameters": {
    "side": "sell",
    "duration": "day",
    "quantity": "1",
    "ocoGroup": null,
    "ifDoneParentId": null,
    "orderType": "limit",
    "limitPrice": "1030",
    "instrument": "Si.FORTS.M2018.P57750"
  },
  "currentModificationId": "d0c7b0dd-0212-406b-8bbf-095740ded26e"
}

HTTP status code 400

The specified order identifier does not have correct format.

HTTP status code 404

The order is not found.

post

URI Parameters

  • id: required (string)

    Order identifier

Body

Media type: application/json

Properties
  • action: required (one of replace, cancel)
  • parameters: required (object)
    • quantity: required (string)
    • limitPrice: (string)
    • stopPrice: (string)
    • placeDistance: (number)

      only for replace action and for trailing_stop orders

HTTP status code 200

Order action is accepted

Media type: application/json

Properties
  • placeTime: required (string)
  • orderState: required (object)
    • status: required (one of created, accepted, placing, working, cancelled, pending, filled, rejected)
    • lastUpdate: required (string)
    • fills: required (array of items)

      Items: items

      • time: required (string)
      • quantity: required (string)
      • price: required (string)
      • position: required (number)
    • reason: (string)
  • accountId: required (string)
  • id: required (string)
  • clientTag: (string)

    custom description

  • orderParameters: required (object)
    • side: required (one of buy, sell)
    • duration: required (one of day, fill_or_kill, immediate_or_cancel, good_till_cancel, good_till_time, at_the_opening, at_the_close)
    • quantity: required (string)
    • ocoGroup: (string)

      the OCO group identifier

    • ifDoneParentId: (string)

      the parent order identifier

    • orderType: required (one of market, limit, stop, stop_limit, trailing_stop, twap, iceberg)
    • limitPrice: (string)
    • instrument: required (string)
    • stopPrice: (string)
    • gttExpiration: (string)

      required only for good_till_time orders; format 2017-05-18T10:00:00.000Z

    • priceDistance: (number)

      required only for trailing_stop order

    • placeInterval: (integer)

      required only for twap order

    • partQuantity: (number)

      required only for twap and iceberg orders

  • currentModificationId: required (string)

Example:

{
  "placeTime": "2019-05-20T08:51:42.776Z",
  "orderState": {
    "status": "cancelled",
    "lastUpdate": "2019-05-20T09:05:20.142Z",
    "fills": []
  },
  "accountId": "WWB1220.001",
  "id": "5a5562e4-cef0-4c79-ab84-840c8890af74",
  "clientTag": "",
  "orderParameters": {
    "side": "buy",
    "duration": "day",
    "quantity": "10",
    "ocoGroup": null,
    "ifDoneParentId": null,
    "orderType": "market",
    "instrument": "TSLA.NASDAQ"
  },
  "currentModificationId": "beb4c027-9af4-44bf-89fc-88b517cb3a3b"
}

HTTP status code 400

Order modification parameters are incorrect.

Orders & trades HTTP streamsScope: ordersTrade API

Streaming updates of orders and trades

/2.0/stream/orders

get

HTTP status code 200

Media type: application/x-json-stream

Example:

{
  "event":"order",
  "order":{
    "placeTime":"2019-04-26T09:31:33.759Z",
    "orderState":{
        "status":"pending",
        "lastUpdate":"2019-04-26T09:31:33.759Z",
        "fills":[]
    },
    "accountId":"WWB1220.001",
    "id":"bc2a4eea-96cf-43f0-8a7c-d3833565519d",
    "clientTag":"",
    "orderParameters":{
        "side":"buy",
        "duration":"day",
        "quantity":"10",
        "ocoGroup":null,
        "ifDoneParentId":null,
        "orderType":"market",
        "instrument":"TSLA.NASDAQ"
    },
    "currentModificationId":"bc2a4eea-96cf-43f0-8a7c-d3833565519d"}
}

/2.0/stream/trades

get

HTTP status code 200

Media type: application/x-json-stream

Example:

{
  "event": "trade",
   "quantity": "12",
  "order_id": "f0b9d02a-2214-41b0-93d2-96f07dfd894d",
  "price": "157.49",
  "position": "0",
  "time": "2019-01-25T20:01:57.508Z"
}