order.cancel

Hủy lệnh hiện có. Xác định lệnh cần hủy qua orderId HOẶC clientRequestId (bắt buộc truyền đúng một trong hai). Cùng luồng ack nhanh PD như order.place. Yêu cầu chữ ký signature.

Scope bắt buộc: tradingws:order:delete.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bodyobjectrequired

idstringrequired

methodstringrequired

paramsobjectrequired

Bắt buộc truyền đúng một trong hai trường `orderId`/`clientRequestId` để xác định lệnh cần hủy.

clientCancelIdstring | nulloptional

Định danh hủy lệnh do client tạo ra. Khi để trống, hệ thống tự sinh.

clientRequestIdstring | nulloptional

Định danh lệnh gốc do client tạo ra khi đặt lệnh. Dùng XOR với `orderId`.

orderIdstring | nulloptional

Định danh lệnh gốc sinh bởi hệ thống SSI. Dùng XOR với `clientRequestId`.

accountNostringrequired

Số tài khoản giao dịch.

deviceIdstringrequired

Định danh thiết bị gửi yêu cầu hủy lệnh.

userAgentstring | nulloptional

Thông tin trình duyệt/ứng dụng gửi yêu cầu.

signaturestringrequired

Chữ ký RSA+SHA256 (base64). Bắt buộc.

timestampintegerrequired

Response Body

`application/json`

Sample Request

wscat -c wss://api.ssi.com.vn/ws/v3/trading -x '{
  "id": "req-0003",
  "method": "order.cancel",
  "params": {
    "orderId": "ORD123456",
    "accountNo": "0901351",
    "deviceId": "MAC-AABBCCDDEEFF"
  },
  "signature": "base64(RSA-SHA256(...))",
  "timestamp": 1755000002000
}'

Sample Response

{
  "id": "req-0003",
  "method": "order.cancel",
  "status": 200,
  "result": {
    "clientRequestId": "req-0001",
    "orderId": "ORD123456",
    "orderStatus": "PD",
    "clientCancelId": "req-0003"
  },
  "rateLimit": {
    "limit": 50,
    "remaining": 45,
    "resetMs": 860
  }
}

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`