Place Order
POST/order/create
Order status will change according to following sequence.
- Send to OMS new
- Pending new (for some exchanges)
- Queued
- Rejected
- Partially Filled
- Filled
- Expire (depending on the TIF type of the order)
During market closure, only limit orders will be queued at GTN.
quantity or orderValue is required(for equity/option type orders). if quantity > 0, order will place using quantity not orderValue.
For limit type sell side equity orders, if quantity is null or 0, quantity will be taken by dividing the given orderValue by given price.
For market type sell side equity orders, quantity must be > 0.
Request
- application/json
Body
Security account number of the customer.
The symbol code of the symbol/ticker which need to be traded.
Find exchange codes. here
Quantity or Order Value is required. if quantity > 0, order will place using quantity not order value.
boundary value - 15 digits including decimals
Find Order types - Master Data > Get Exchange Order Types
Possible values: [1
, 2
]
1 (Buy) | 2 (Sell)
boundary value - 16 digits including decimals
FInd Time in force. Master Data > Get Exchange Tif Types
Default value: REG
Find trading Sessions - Master Data > Get Exchange Trading Session
Quantity or Order Value is required. if quantity > 0, order will place using quantity not order value.
boundary value - 16 digits including decimals
Possible values: [CS
]
Default value: CS
If securityType is not given, it will set to CS(Common Stock/Equity) by default.
Responses
- 200
OK
- application/json
- Schema
- Example (from schema)
- example
Schema
Find error codes here)
Security account number
Possible values: [1
, 2
]
1 (Buy) | 2 (Sell)
Possible values: [1
, 2
]
1 (Market order) | 2 (Limit order)
Find list of status here
Possible values: Value must match regular expression ^[0-9]{4}/(0[1-9]|1[0-2])/(0[1-9]|[1-2][0-9]|3[0-1])-(2[0-3]|[01][0-9]):[0-5][0-9]:[0-5][0-9]$
{
"status": "string",
"rejectCode": 0,
"reason": "string",
"orderNumber": "string",
"orderId": "string",
"originalOrderId": "string",
"exchange": "string",
"symbol": "string",
"accountNumber": "string",
"orderSide": "1",
"orderType": "1",
"orderStatus": "string",
"averagePrice": 0,
"orderQty": 0,
"filledQty": 0,
"orderValue": 0,
"orderNetValue": 0,
"orderNetSettle": 0,
"filledOrderValue": 0,
"commission": 0,
"vat": 0,
"cumulativeQty": 0,
"cumulativeOrderValue": 0,
"cumulativeOrderNetValue": 0,
"cumulativeOrderNetSettle": 0,
"cumulativeCommission": 0,
"cumulativeVat": 0,
"date": "string",
"rejectReason": "string"
}
{
"status": "SUCCESS",
"rejectCode": 0,
"orderNumber": "24K081000016",
"originalOrderId": "",
"rejectReason": "",
"orderId": "24K081000016",
"exchange": "NSDQ",
"symbol": "AAPL",
"accountNumber": "P000246603",
"orderSide": "1",
"orderType": "2",
"averagePrice": 0,
"orderQty": 100,
"filledQty": 0,
"orderValue": 200,
"orderNetValue": 0,
"orderNetSettle": 215.1,
"filledOrderValue": 0,
"commission": 10,
"vat": 5.1,
"cumulativeQty": 0,
"cumulativeOrderValue": 0,
"cumulativeOrderNetValue": 0,
"cumulativeOrderNetSettle": 0,
"cumulativeCommission": 0,
"cumulativeVat": 0,
"date": "2024/05/08-03:24:26",
"orderStatus": "M"
}