Place an order

  -X POST
  --header 'Content-Type: application/json'
  --header 'Accept: application/json'
  --header 'Authorization: Bearer {token here}'
  -d '{ \ 
   "account_number": "12345678@vision", \ 
   "symbol": "BAC", \ 
   "quantity": 1, \ 
   "price": 20, \ 
   "time_in_force": "day", \ 
   "order_type": "limit", \ 
   "side": "buy", \ 
   "exchange": "Auto" \ 
  }' 'https://api.lime.co/orders/place'

Request example

{
  "account_number": "12345678@vision",
  "symbol": "BAC",
  "quantity": 1,
  "price": 20.0,
  "time_in_force": "day",
  "order_type": "limit",
  "side": "buy",
  "exchange": "Auto"
}

Response example

{
  "success": true,
  "data": "201710041710516537"
}

The order is accepted immediately, the method returns assigned id. The order is still validated with exactly same logic as in Validate an order method and is sent to market on successful validation pass. Otherwise, the order will reject asynchronously and you can query its status by calling the Get order details method.

Request

name	type	description
account_number	string	Required. The account number in the format of 123456578@vision
symbol	string	Required. The security symbol, stocks in CQS or CMS convention, options in OCC
quantity	number	Required. Positive integer, number of shares or contracts
price	number	Required. Positive decimal if the order_type is limit
time_in_force	string	Optional, day by default. Specifies how long the order remains in effect. Possible values are day - regular hours, ext - extended hours. More values to come
order_type	string	Optional, market by default. Possible values are market, limit. More values to come
side	string	Optional, buy by default. Available values are buy and sell. buy opens long position, sell closes the position. The system will detemine the proper side according to the current position, but you are still required to place two orders to revert the position from long to short and the other way around.
exchange	string	Optional, Auto by default. The routing instructions for order execution. The actual values are dynamic and depend on the account settings. Use Get account routes method to get a list of all available routes and their properties

Response

name	type	description
success	boolean	Place order status: true or false
data	string	The id assigned to the order