Modify Order

When working at the market, one often needs to modify or delete the placed pending order.

While an order remains open or pending in the system, certain elements of it can be adjusted.

Method: POST​

https://connect-go.thefirstock.tech/api/V5/modify-order

Request details

Key	Value	Type	Mandatory
userId	NP2997	String	Yes
jKey	abc123	String	Yes
norenordno	24121300015194	Integer	Yes
ret	DAY	String	Yes
prctyp	LMT	String	Yes
gui_order_id	b924ef7d-9c7b-4599-834b-583023ce04b0	String	No
tsym		String	Yes
prc	418	Integer	No
trgprc	0	Integer	Yes
qty	1	Integer	No
dscqty	0	Integer	No
mkt_protection	0.5	Float	No
ordersource	CAPI01	String	Yes
prd	C	String	Yes
handlinst		String	No
channel	MacOS	String	No
usr_agent	BrowserAgent.Chrome	String	No
app_inst_id	8195b6ff-1ba3-423a-9298-fb0e4e095bcd	String	No
ip_address	1.1.1.1	String	No

Libraries and SDKs

Success response details

Parameter	Description	Example
status string	Indicates the success of the API request	success
data.orderNumber string	Unique identifier for the modified order	1234567890111
data.requestTime string	Timestamp indicating when the response was received	14:51:30 15-02-2023

{
    "status": "success",
    "message": "Order details",
    "data": {
        "ExternalRemarks": "(null)",
        "GuiOrdId": "b924ef7d-9c7b-4599-834b-583023ce04b0",
        "NorenOrdNum": 24121300015194,
        "RejReason": "Trying to modify an order number that does not exist.",
        "ReqStatus": "NOT_OK"
    }
}

Failure response details

Parameter	Description	Example
status String	Indicates the result status of the API operation	failed
code String	HTTP status code associated with the error	400
name String	Specifies the type or category of the error encountered	BAD REQUEST
error.field String	Type of order pricing	priceType
error.message String	Detailed message describing the error	priceType cannot be undefined or NULL

{  
  "status": "failed",
  "code": "400",
  "name": "BAD_REQUEST", 
  "error": {   
    "field": "priceType",     
    "message": "priceType cannot be undefined or NULL"
  }
}