Place Order
The Place Order API provides a seamless and efficient way for you to submit your orders directly into our system.
You will receive an immediate confirmation of your order with a unique order number.
Method: POST
https://connect-go.thefirstock.tech/api/V5/place-order
Request details
| KEY | VALUE | MANDATORY |
|---|---|---|
| userId | {{userId}} | Yes |
| jKey | {{jkey}} | Yes |
| exch | NSE | Yes |
| ret | DAY | Yes |
| customer_firm | C | Yes |
| prd | C | Yes |
| prctyp | MKT | Yes |
| tsym | IDEA-EQ | Yes |
| trantype | B | Yes |
| gui_order_id | ASDFG1398713 | No |
| prc | 0 | Yes |
| trgprc | 0 | Yes |
| qty | 1 | Yes |
| dscqty | 0 | No |
| remarks | Test | Yes |
| ordersource | WEB | Yes |
| handlinst | test235 | No |
| channel | MacOS | No |
| usr_agent | BrowserAgent.Chrome | No |
| app_inst_id | 8195b6ff-1ba3-423a-9298-fb0e4e095bcd | No |
| ip_address | 1.1.1.1 | No |
Libraries and SDKs
curl --location 'https://connect-go.thefirstock.tech/api/V5
/place-order' \
--header 'Content-Type: application/json' \
--data '{
"userId": "NP2997",
"jKey": "1478b9b71707210d8851258599b23a6a73d31b19809ac5068560f38dad493d35",
"exch": "NSE",
"ret": "DAY",
"customer_firm": "C",
"prd": "C",
"prctyp": "MKT",
"tsym": "IDEA-EQ",
"trantype": "B",
"gui_order_id": "ASDFG1398713",
"prc": 0,
"trgprc": 0,
"qty": 1,
"dscqty": 0,
"remarks": "Test",
"ordersource": "WEB",
"handlinst": "test235",
"channel": "MacOS",
"usr_agent": "BrowserAgent.Chrome",
"app_inst_id": "8195b6ff-1ba3-423a-9298-fb0e4e095bcd",
"ip_address": "1.1.1.1"
}'
Success response details
| Parameter | Description | Example |
|---|---|---|
|
status String |
Indicates the outcome of the API request | success |
|
data.requestTime String |
Timestamp indicating when the response was received |
14:10:13 15-02-2023 |
|
data.orderNumber String |
Unique identifier for the order, provided upon successful placement |
1234567890111 |
{
"status": "success",
"message": "Order details",
"data": {
"actid": "NP2997",
"dscqty": "0",
"exch": "NSE",
"handlinst": "test235",
"kidid": "1",
"ls": "1",
"mult": "1",
"norenordno": "25031200027615",
"ntm": "268223943",
"pcode": "C",
"pp": "2",
"prc": "0.00",
"prcftr": "1.000000",
"prctyp": "MKT",
"qty": "1",
"rejreason": "YEL:Yel not ready for transaction",
"remarks": "Test",
"reporttype": "Rejected",
"ret": "DAY",
"status": "REJECTED",
"ti": "0.01",
"tm": "1741784498",
"token": "14366",
"trantype": "B",
"tsym": "IDEA-EQ",
"uid": "NP2997"
}
}
Failure response details
| Parameter | Description | Example |
|---|---|---|
|
status String |
Indicates the result status of the operation | failed |
|
code String |
HTTP status code associated with the error | 400 |
|
name String |
Describes the type of error encountered | BAD_REQUEST |
|
error.field String |
Field in the request that triggered the error | transactionType |
|
error.message String |
Detailed message describing the nature of the error |
transactionType cannot be undefined or NULL |
{
"status": "failed",
"code": "400",
"name": "BAD_REQUEST",
"error": {
"field": "transactionType",
"message": "transactionType cannot be undefined or NULL"
}
}