Update Order

Update an existing futures order on PointPay Exchange.

Details

POST https://api.pointpay.io/fapi/v1/private/trade/update-order

Headers

Name	Type	Description
X-TXC-APIKEY*	STRING	Public API key
X-TXC-PAYLOAD*	STRING	Base64-encoded request body
X-TXC-SIGNATURE*	STRING	HmacSHA512 signature of the request body

Request Body

Name	Type	Description	Example
symbol*	STRING	Trading pair	BTCUSDT
orderId	STRING	Order ID. Required if orderLinkId is not set	6ac24069-2bd7-4ed4-8b4e-8d62fa564b3c
orderLinkId	STRING	System order ID. Required if orderId is not set	6ac24069-2bd7-4ed4-8b4e-8d62fa564b3c
triggerPrice	NUMERIC	Trigger price	64000
qty	NUMERIC	Updated order quantity	0.02
price	NUMERIC	Updated order price	65000
takeProfit	NUMERIC	Take-profit price	68000
stopLoss	NUMERIC	Stop-loss price	62000
tpLimitPrice	NUMERIC	Take-profit limit price	67950
slLimitPrice	NUMERIC	Stop-loss limit price	62050
tpslMode	STRING	TP/SL mode. Available values: Full, Partial	Full
tpTriggerBy	STRING	Take-profit trigger source. Available values: LastPrice, IndexPrice, MarkPrice	MarkPrice
slTriggerBy	STRING	Stop-loss trigger source. Available values: LastPrice, IndexPrice, MarkPrice	MarkPrice
triggerBy	STRING	Trigger price source. Available values: LastPrice, IndexPrice, MarkPrice	MarkPrice

symbol is required. Send either orderId or orderLinkId.

CURL Example

curl -X POST "https://api.pointpay.io/fapi/v1/private/trade/update-order" \
  -H "accept: application/json" \
  -H "X-TXC-APIKEY: <api-key>" \
  -H "X-TXC-PAYLOAD: <base64-payload>" \
  -H "X-TXC-SIGNATURE: <signature>" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTCUSDT",
    "orderId": "1736254849204",
    "price": 65000,
    "qty": 0.02,
    "takeProfit": 68000,
    "stopLoss": 62000
  }'

200: OK Successful

Empty array returned when the update succeeds

Response example:

{
    "notification": null,
    "warning": null,
    "variables": null,
    "status": "000000",
    "response": [],
    "errors": null
}

400: Bad Request

Response example

{
    "code": 400,
    "success": false,
    "message": "invalid input",
    "result": []
}

Returned when the request is invalid.

Common reasons:

• Invalid request format

• Invalid headers

401: Unauthorized

Response example

{"code":400,"success":false,"message":"authentication failure","result":[]}

Returned when authentication headers are missing / invalid or API Keys are not enabled.