Skip to main content

Validate 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": 21.0, \
"time_in_force": "day", \
"order_type": "limit", \
"side": "buy", \
"exchange": "auto", \
"client_order_id": "01HWYX297HG2J9V607VSY4GQ3S" \
}' 'https://api.lime.co/orders/validate'

Request example

{
"account_number": "12345678@vision",
"symbol": "BAC",
"quantity": 1,
"price": 21.0,
"time_in_force": "day",
"order_type": "limit",
"side": "buy",
"exchange": "auto",
"client_order_id": "01HWYX297HG2J9V607VSY4GQ3S"
}

Response example

{
"is_valid": false,
"validation_message": "You cannot sell more shares than your effective long position (effective long position = long position less open sell orders) using one order ticket. Please check your pending order(s) for potential outstanding duplicate order(s). Industry regulations require that two order tickets be submitted: one to sell your effective long position and one to sell your desired short position."
}

The method verifies an order and responds with the validation message if the order can not be placed at the moment. The order is not sent to market.

Request​

The method uses the same request parameters as Place an order method.

Response​

The method returns the following json structure:

nametypedescription
is_validbooleanOrder validation status: true or false
validation_messagestringOptional reject reason