Cancel Order

Cancel a futures order on PointPay Exchange.

Details

POST https://api.pointpay.io/fapi/v1/private/trade/cancel-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

symbol is required. Send either orderId or orderLinkId.

CURL Example

curl -X POST "https://api.pointpay.io/fapi/v1/private/trade/cancel-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"
  }'

200: OK Successful

Empty array returned when the request 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.