Place a new order

post

https://demo.tradelocker.com/backend-api/trade/accounts/{accountId}/orders

Place a new order.
Fields qty, routeId, side, validity, type, tradableInstrumentId are mandatory inside of the request body. Price can be set to 0 for market orders.

If using a stop type of order, you must specify the stopPrice.

Validity (also known as TimeInForce - TIF in some error messages) must be IOC for market orders and GTC for limit and stop orders.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

accountId

int32

required

Account identifier.

Body Params

Request body with parameters

price

number

Limit Price for Limit order.

qty

number

required

The number of units to open the buy or sell order.

routeId

number

required

Identifier of the trade connection. Find the corresponding INFO or TRADE routeId by querying the /trade/accounts/{accountId}/instruments endpoint.

side

string

enum

required

Order side. If the creating order is a closing one for the position, then the side must be opposite to the side of the position

Allowed:

strategyId

string

Arbitrary string (up to 31 chars) that can be attached to identify orders and positions placed through algorithmic trading. This value will also be visible in GET /orders, GET /ordersHistory, and GET /positions.

stopLoss

number

Stop loss amount for the order. Must be specified in case of absolute or offset stop loss type.

stopLossType

string

enum

Type of stop loss price for the order. Available types: absolute, offset, trailingOffset.

Allowed:

stopPrice

number

Stop Price for Stop orders.

takeProfit

number

TakeProfit amount for the order. Must be specified together with the takeProfitType field. Specifies either the absolute price, or an offset in pips.

takeProfitType

string

enum

Type of take profit for the order. Available types: [absolute, offset]. Must be specified together with the takeProfit field.

Allowed:

trStopOffset

number

For the 'trailingOffset' stopLossType. The trailing offset in pips.

tradableInstrumentId

int64

required

Identifier of the instrument that is used for trading purposes.

type

string

enum

required

Order type. Available types: limit, market, stop. If using a stop order, the stopPrice field must be specified. If using a limit order, the price field must be specified. If using a market order, the price field is ignored.

Allowed:

validity

string

enum

required

Whether the order is Good Till Cancelled (GTC) or Immediate or Cancel (IOC). For market orders, use IOC, otherwise, use GTC. In error messages, Validity is sometimes referred to as TimeInForce (TIF).

Allowed:

Headers

accNum

int32

required

Account number

developer-api-key

string

developer-api-key

Responses

401

Unauthorized

403

Forbidden

404

Not Found

200OK