trade-order-batch-cancel

Hủy nhiều lệnh trong một request (Batch Order).

Áp dụng cùng quy tắc chung với API đặt lệnh batch (tối đa 50 lệnh, validation all-or-nothing, chống replay 30 giây, idempotency theo batchRequestId, chữ ký trên toàn bộ body). Mỗi lệnh trong orders áp dụng cùng quy tắc với API hủy lệnh đơn trade-order-cancel (xác định lệnh qua clientRequestId hoặc orderId).

Scope yêu cầu: trading:order:delete.

Authorization

Bearer

AuthorizationBearer <token>

Nhập JWT token theo định dạng Bearer <token>.

In: header

Header Parameters

Content-Typestringrequired

Định dạng nội dung request body. Chủ yếu là application/json.

User-Agentstringoptional

Thông tin client gửi request.

Accept-Languagestringoptional

Ngôn ngữ phản hồi mong muốn. Nếu không có header này, hệ thống sẽ mặc định là en

X-Signaturestringrequired

Chữ ký RSA + SHA256 để xác thực tính toàn vẹn của request. Input bao gồm SecretKey + JSON body.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bodyobjectrequired

batchRequestIdstringrequired

Định danh batch do client tạo ra, phải duy nhất theo từng API Key và từng loại thao tác (đặt/hủy) trong ngày. Dùng làm khóa idempotency.

batchRequestTimeintegerrequired

Thời điểm client tạo batch, tính bằng epoch milliseconds (UTC). Phải lệch không quá 30 giây so với thời gian máy chủ.

ordersarrayrequired

Danh sách lệnh cần hủy, tối đa 50 lệnh. Mỗi phần tử có cấu trúc như request của API hủy lệnh đơn.

orders[]objectrequired

clientCancelIdstring | nulloptional

Định danh hủy lệnh do client tạo ra, dùng để đối chiếu trong các phản hồi sau này. Trường này không bắt buộc nhưng nếu có thì nên đảm bảo tính duy nhất để tránh nhầm lẫn khi xử lý phản hồi. Khi để trống thì hệ thống sẽ tự sinh định danh hủy lệnh cho khách hàng và trả về response & streaming.

clientRequestIdstring | nulloptional

Định danh lệnh gốc do client tạo ra khi đặt lệnh. Khi để trống thì hệ thống sẽ không đối chiếu dựa trên định danh lệnh gốc mà sẽ dựa vào `orderId` để xác định lệnh cần hủy.

orderIdstring | nulloptional

Định danh lệnh gốc sinh ra bởi hệ thống SSI. Đây là một trong hai trường (cùng với `clientRequestId`) được sử dụng để xác định lệnh cần hủy. Nếu cả hai trường đều có giá trị, hệ thống sẽ ưu tiên đối chiếu dựa trên `clientRequestId`. Nếu chỉ có `orderId` có giá trị thì hệ thống sẽ đối chiếu dựa trên `orderId`. Nếu cả hai trường đều không có giá trị thì yêu cầu hủy lệnh sẽ bị từ chối do thiếu thông tin xác định lệnh cần hủy.

accountNostringrequired

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

deviceIdstringrequired

Định danh thiết bị thực hiện gửi yêu cầu hủy lệnh. Thông thường dùng MAC address hoặc IMEI của thiết bị.

userAgentstring | nulloptional

Thông tin về trình duyệt hoặc ứng dụng gửi yêu cầu hủy lệnh.

ipAddressstring | nulloptional

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

Response Headers

X-RATELIMIT-LIMITstringoptional

Giới hạn số request trong chu kỳ.

X-RATELIMIT-REMAININGstringoptional

Số request còn lại trong chu kỳ hiện tại.

X-RATELIMIT-RESETstringoptional

Thời điểm reset giới hạn request.

Response Body

`application/json`

curl -X DELETE "https://api.ssi.com.vn/api/v3/trading/order/batch" \  -H "Content-Type: application/json" \  -H "X-Signature: sha256=abc123..." \  -H "Content-Type: application/json" \  -d '{    "batchRequestId": "string",    "batchRequestTime": 1760400000000,    "orders": [      {        "accountNo": "string",        "deviceId": "string"      }    ]  }'

Request hợp lệ và đã được xử lý. Kết quả từng lệnh nằm trong results.

{
  "batchRequestId": "string",
  "results": [
    {
      "clientRequestId": "string",
      "clientCancelId": "string",
      "orderId": "string",
      "orderStatus": "string",
      "success": true,
      "errorCode": "string",
      "errorMessage": "string"
    }
  ]
}

Yêu cầu không hợp lệ.

{
  "code": "400",
  "msg": "Invalid request"
}

Authorization

Header Parameters

Request Body

Response Headers

Response Body

200application/json

400application/json

`application/json`

`application/json`