OpenAPI

The trade service group bundles functionality, which is most often relevant for trading. This includes pricing, order placement and getting notifications about trade activity as well as margin status.

Overview

Pricing

OpenAPI provides three different price resources: Under Prices are grouped together functionality for streaming prices used for trading. An alternative is InfoPrices which are more lightweight and provides slightly less data. InfoPrices are useful for when you have a need for a price snapshot and not a stream of update and is generally recommended for non-trading data. For option trading OpenAPI provides a custom price feed to handle streaming bulk prices to be used for displaying an Options Chain.


PropertyInfoPricesPricesOptionsChain
PurposeWatchlistsTrade Tickets, to be displayed individually or on a trade board.Options Chain
Possible Operations

Request/Response

Streaming

StreamingStreaming
Available Data

DisplayAndFormat

HistoricalChanges

InstrumentPriceDetails

MarketDepth

PriceInfo

PriceInfoDetails

Quote (w/o QuoteId)

Information for a single instrument

Commissions

DisplayAndFormat

Greeks

HistoricalChanges

InstrumentPriceDetails

MarketDepth

PriceInfo

PriceInfoDetails

Quote (with QuoteId)

A scrollable array with expiry/strikes for an option

Expiries:

- Stikes:

OptionSide: Put/Call for all options

OptionSide: FxBinary additional info for FxOptions


Orders & Positions

An application may place orders (by posting to the /orders endpoint) or trade on quote (by posting to the /positions endpoint).

  • All asset classes except Fx Options are traded by placing orders
  • Fx Options can only be traded by accepting a quote

The orders endpoint also supports the ability to amend existing orders, add related orders and cancel orders.

At the time of this writing Saxo Bank supports two orders endpoints:

  • V1: The original orders endpoint (undocumented)
  • V2: The current orders endpoints, which includes support for OCO orders and a better syntax for placing or amending multiple related orders

In order to trade Fx Options, Saxo supports Trade on Quote and the ability to change an Fx Options exercise style.

Messages

The messages endpoint provides access to the messages, which are shown to the user, within SaxoTrader GO. This includes trade confirmations, margin calls, price alerts etc. An application can mark messages as having been "seen" by the user.

Exercising Contract Options

For positions in contract options (StockIndexOption, StockOption and FuturesOption) OpenAPI supports exercising an amount of those held:

PUT https://developer.saxobank.com/sim/openapi/trade/v1/positions/1029724644/exercise
{
	"AccountKey": "zsnh|NO42RmzjC4oPovKGA==",
	"Amount": 1,
	"Uic": 2087231,
	"AssetType": "FuturesOption"
}