Skip to content

Cancel Order ​

POST /api/v1.0/sim-trade/{acc_id}/orders/{order_id}/cancel

Cancel an unfilled order. Only orders with status=2 (Submitted) can be cancelled.

Parameters ​

ParameterTypeLocationRequiredDescription
acc_idstringpathYesBusiness account ID
order_idstringpathYesOrder ID to cancel
marketintbodyYesAccount market ID (the account's market_id from the account list, e.g. 1=HK stocks 100=US margin); must match the account of acc_id

Request Example ​

bash
curl -s -X POST "https://webapi.futunn.com/api/v1.0/sim-trade/80306537/orders/1294505/cancel" \
  -H "Authorization: Bearer <AccessToken>" \
  -H "Content-Type: application/json" \
  -d '{"market":100}' | jq

Response Fields ​

FieldTypeDescription
order_idstringCancelled order ID (echo of the path parameter)

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "order_id": "1294505"
  }
}

Error response ​

HTTP status remains 200. A failed request returns ret_code != 0 and an error object.

json
{
  "ret_code": -3,
  "ret_msg": "invalid request",
  "error": {"code": "invalid_parameter", "message": "invalid request"}
}