Giao dịch

Hủy lệnh

Cancellation is free, best-effort, and idempotent. Today you can cancel one order at a time per request. Bulk cancel — by ID list, by market, or account-wide — is planned; see the workaround below until it ships. A race window exists in all modes: in-flight fills committed before your cancel reaches the matcher will still complete.

Hủy một lệnh đơn lẻ

Dùng phương thức DELETE khi bạn có ID lệnh. Phản hồi xác nhận việc hủy; gọi DELETE hai lần là an toàn.

POST /api/v1/orders/:id/cancel
Authorization: Bearer $SATORIEX_TOKEN

202 Accepted  -> { "code": 0, "data": { ...full order object with status "cancelled" } }

Hủy hàng loạt

Đang lên kế hoạch

Ba mẫu hủy hàng loạt được hỗ trợ: danh sách ID, tất cả lệnh trên một thị trường hoặc nút hoảng loạn — mọi lệnh đang mở trên tài khoản.

Trong lúc chờ, hãy lặp endpoint hủy đơn lẻ ở phía client. Hủy miễn phí và nhanh, vì vậy một vòng lặp chặt chẽ trên danh sách lệnh đang mở hoạt động tốt để thu hẹp khẩn cấp.

# Today: cancel one order at a time.
for id in "${ORDER_IDS[@]}"; do
  curl -X POST https://staging.satoriex.io/api/v1/orders/$id/cancel \
    -H "Authorization: Bearer $SATORIEX_TOKEN"
done

Hủy hoảng loạn bị giới hạn tốc độ một lần mỗi vài giây — đây là để thoát khẩn cấp, không phải luồng bình thường.

Những gì có thể hủy

Trạng thái lệnh	Có thể hủy?	Ghi chú
pending	Có	Flagged for cancel; the matcher skips it on next processing — the order has not yet been added to the book.
open	Có	Resting in the book; cancel removes it immediately. This is the common cancel case.
partial	Có (chỉ phần còn lại)	Cổ phần đã khớp vẫn còn trong vị thế của bạn; chỉ phần chưa khớp bị hủy.
filled	Không	Đã quyết toán — không có hành động nào có thể.
cancelled	Idempotent	Các lệnh gọi lặp lại trả về cùng phản hồi thành công.

Hủy không có hiệu lực ngược

Nếu lệnh hủy của bạn đến một mili giây sau khi khớp, bạn đã giao dịch. Xây dựng chiến lược của bạn để chịu được khoảng thời gian đó — sử dụng IOC hoặc FOK hiệu lực thời gian khi điều này quan trọng.