Lệnh

View as Markdown

Lưu ý

Các điểm cuối đơn hàng yêu cầu quyền giao dịch.

đặt hàng

1POST /v1/private/order/place
2Content-Type: application/json

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringĐúng vậyBiểu tượng
typestringĐúng vậyLIMIT / MARKET
sidestringĐúng vậyBUY / SELL
positionSidestringKhôngBOTH / LONG / SHORT, BOTH mặc định
pricestringYêu cầu có điều kiệnYêu cầu cho lệnh giới hạn
quantitystringYêu cầu có điều kiệnSố lượng. Có thể bỏ qua khi closePosition=true
timeInForcestringKhôngGTC / IOC / FOK, GTC mặc định
reduceOnlyboolKhôngChỉ giảm, false mặc định
makerOnlyboolKhôngChỉ dành cho nhà sản xuất, false mặc định
closePositionboolKhôngĐóng toàn bộ vị trí, mặc định false
clientOrderIdstringKhôngID đơn hàng do khách hàng định nghĩa
placeTypestringKhôngDấu hiệu loại đặt hàng
priceTypeint32KhôngBBO loại giá: 0 giá xác định, 1 đối thủ là 1, 2 đối thủ 5, 3 cùng 1, 4 cùng đội 5

Yêu cầu ví dụ:

1{
2 "symbol": "BTCUSDT",
3 "type": "LIMIT",
4 "side": "BUY",
5 "price": "85000",
6 "quantity": "0.1",
7 "timeInForce": "GTC",
8 "makerOnly": true,
9 "clientOrderId": "ext-1772710377808-001"
10}

Trường phản hồi:

Lĩnh vựcLoạiMô tả
orderIdstringID đơn hàng máy chủ
clientOrderIdstringID đơn hàng do khách hàng định nghĩa
statusstringTình trạng đơn hàng
timestampint64dấu thời gian

Đặt hàng theo lô

1POST /v1/private/order/batch-place
2Content-Type: application/json

Yêu cầu nội dung:

1{
2 "orders": [
3 {
4 "symbol": "BTCUSDT",
5 "type": "LIMIT",
6 "side": "BUY",
7 "price": "85000",
8 "quantity": "0.1",
9 "clientOrderId": "ext-buy-001"
10 }
11 ]
12}

Trường phản hồi:

Lĩnh vựcLoạiMô tả
successCountint32Số lượng đơn hàng thành công
failedCountint32Số lượng đơn hàng thất bại
results[]arrayKết quả cho mỗi đơn hàng

Lệnh Điều kiện Đặt hàng

1POST /v1/private/order/place-condition
2Content-Type: application/json

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringĐúng vậyBiểu tượng
typestringĐúng vậySTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringĐúng vậyBUY / SELL
positionSidestringKhôngBOTH / LONG / SHORT
pricestringYêu cầu có điều kiệnBắt buộc cho STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringYêu cầu có điều kiệnSố lượng. Có thể bỏ qua khi closePosition=true
timeInForcestringKhôngGTC / IOC / FOK / GTE_GTC
reduceOnlyboolKhôngChỉ giảm
clientOrderIdstringKhôngID đơn hàng do khách hàng định nghĩa
stopPricestringYêu cầu có điều kiệnGiá kích hoạt
workingTypestringKhôngMARK_PRICE / CONTRACT_PRICE, CONTRACT_PRICE mặc định
priceProtectboolKhôngViệc bảo vệ giá có được kích hoạt hay không
activatePricestringYêu cầu có điều kiệnGiá kích hoạt lệnh theo dõi
callbackRatestringYêu cầu có điều kiệnTỷ lệ gọi lại theo lệnh cuối cùng
closePositionboolKhôngĐóng toàn bộ vị trí

Trường phản hồi:

Lĩnh vựcLoạiMô tả
conditionIdstringMã lệnh điều kiện
conditionStatusstringTình trạng đơn hàng tình trạng
timestampint64dấu thời gian

Đặt lệnh Chiến lược

1POST /v1/private/order/place-strategy
2Content-Type: application/json

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
strategyTypestringĐúng vậyOTOCO / OTO / OCO
subOrderListarrayĐúng vậyDanh sách các đơn vị phụ

Các trường trong subOrderList[] phần lớn giống với lệnh chuẩn và lệnh điều kiện, với các trường phụ thuộc bổ sung:

Tham sốLoạiMô tả
strategySubIdint64ID đơn hàng con
firstDrivenIdint64ID lệnh lái xe đầu tiên. 0 nghĩa là không phụ thuộc
firstDrivenOnstringĐiều kiện kích hoạt đầu tiên
firstTriggerstringHành động kích hoạt đầu tiên
secondDrivenIdint64ID lệnh lái xe thứ hai
secondDrivenOnstringĐiều kiện kích hoạt thứ hai
secondTriggerstringHành động kích hoạt thứ hai

Trường phản hồi:

Lĩnh vựcLoạiMô tả
strategyIdstringID Chiến lược
strategyStatusstringTình trạng chiến lược
timestampint64dấu thời gian

Truy vấn Đơn hàng Đơn lẻ

1GET /v1/private/order?symbol=BTCUSDT&orderId=2022543809547603968

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringĐúng vậyBiểu tượng
orderIdstringKhôngID đơn hàng máy chủ
clientOrderIdstringKhôngID đơn hàng do khách hàng định nghĩa

Ít nhất một trong hai orderIdclientOrderId phải được cung cấp. Nếu cả hai đều được cung cấp, máy chủ sẽ thực hiện sự trùng khớp chính xác với cả hai điều kiện.

Đơn hàng bình thường hiện tại

1GET /v1/private/order/current?symbol=BTCUSDT

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringKhôngBiểu tượng
limitint32KhôngGiới hạn số lần trả về
lastOrderIdint64KhôngTrường con trỏ

Trường phản hồi:

Lĩnh vựcLoạiMô tả
list[]arrayDanh sách đơn hàng bình thường hiện tại
totalint32Count

Đơn hàng tình trạng hiện tại

1GET /v1/private/order/current-condition?symbol=BTCUSDT

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringKhôngBiểu tượng

Lệnh Bình thường Lịch sử

1GET /v1/private/order/history?symbol=BTCUSDT&page=1&pageSize=20

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringKhôngBiểu tượng
orderIdstringKhôngBộ lọc ID đơn hàng chính xác
clientOrderIdstringKhôngBộ lọc ID đơn hàng khách hàng chính xác
typeint32KhôngBộ lọc loại lệnh: giới hạn 1 , 2 thị trường
sideint32KhôngBộ lọc bên: 1 mua, 2 bán
statusint32KhôngBộ lọc trạng thái
startTimeint64KhôngThời gian bắt đầu
endTimeint64KhôngThời gian kết thúc
pageint64KhôngSố trang, 1 mặc định
pageSizeint64KhôngSố lượng mục trên mỗi trang, 20 mặc định

Đơn hàng tình trạng lịch sử

1GET /v1/private/order/history-condition?symbol=BTCUSDT&page=1&pageSize=20

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringKhôngBiểu tượng
sideint32KhôngBộ lọc bên: 1 mua, 2 bán
statusint32KhôngBộ lọc trạng thái
startTimeint64KhôngThời gian bắt đầu
endTimeint64KhôngThời gian kết thúc
pageint64KhôngSố trang, 1 mặc định
pageSizeint64KhôngSố lượng mục trên mỗi trang, 20 mặc định

Hồ sơ Thương mại

1GET /v1/private/order/trades?symbol=BTCUSDT&page=1&pageSize=20

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringKhôngBiểu tượng
orderIdstringKhôngBộ lọc Order ID
startTimeint64KhôngThời gian bắt đầu
endTimeint64KhôngThời gian kết thúc
pageint64KhôngSố trang, 1 mặc định
pageSizeint64KhôngSố lượng mục trên mỗi trang, 20 mặc định

Trường phản hồi:

Lĩnh vựcLoạiMô tả
list[].fillIdstringID chi tiết điền
list[].tradeIdstringMã hồ sơ thương mại
list[].orderIdstringMã đơn hàng
list[].symbolstringBiểu tượng
list[].sidestringBên hông
list[].roleTypestringmaker / taker
list[].pricestringGiá đã hoàn thành
list[].quantitystringSố lượng đã được điền
list[].tradeValuestringGiá trị thương mại
list[].handlingFeestringPhí xử lý
list[].realizedPnlstringPnL đã thực hiện
list[].positionSidestringPhía vị trí
list[].createdAtint64Thời gian giao dịch
totalint64Tổng số lượng

Hủy đơn hàng

1POST /v1/private/order/cancel
2Content-Type: application/json

Yêu cầu nội dung:

1{
2 "symbol": "BTCUSDT",
3 "orderId": "2022543809547603968"
4}

clientOrderId cũng có thể được sử dụng để hủy đơn hàng.

Sửa đổi Lệnh

1POST /v1/private/order/move
2Content-Type: application/json

Yêu cầu nội dung:

1{
2 "symbol": "BTCUSDT",
3 "orderId": "2022543809547603968",
4 "price": "85100",
5 "quantity": "0.2"
6}

quantity là tổng số lượng đặt hàng cuối cùng sau khi sửa đổi, không phải số lượng còn lại.

Đơn hàng sửa đổi theo lô

1POST /v1/private/order/batch-move
2Content-Type: application/json

Yêu cầu nội dung:

1{
2 "symbol": "BTCUSDT",
3 "orders": [
4 {
5 "orderId": "2022543809547603968",
6 "price": "85100",
7 "quantity": "0.2"
8 }
9 ]
10}

Hủy đơn hàng theo lô

1POST /v1/private/order/batch-cancel
2Content-Type: application/json

Yêu cầu nội dung:

1{
2 "orders": [
3 {
4 "symbol": "BTCUSDT",
5 "orderId": "2022543809547603968"
6 }
7 ]
8}

Hủy tất cả

1POST /v1/private/order/batch-cancel-all
2Content-Type: application/json

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
symbolstringKhôngBiểu tượng
cancelTypeint32Không0 tất cả các lệnh thông thường, chỉ 1 lệnh giới hạn 2 tất cả các lệnh điều kiện. 0 mặc định

Cancel-all cho các đơn hàng bình thường được chấp nhận không đồng bộ. Trạng thái cuối cùng nên được xác định bởi các WebSocket ORDER_TRADE_UPDATE hoặc điểm cuối truy vấn.

Hủy Đơn Hàng Điều Kiện

1POST /v1/private/order/cancel-condition
2Content-Type: application/json

Yêu cầu nội dung:

1{
2 "symbol": "BTCUSDT",
3 "conditionId": "2022543809547603968"
4}

Chi tiết lệnh chiến lược

1GET /v1/private/order/strategy?strategyId=2022543809547603968

Trường phản hồi:

Lĩnh vựcLoạiMô tả
strategyIdstringID Chiến lược
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Thời gian sáng tạo
subOrders[]arrayChi tiết đơn hàng phụ
updateTimeint64Thời gian cập nhật