Pesanan

View as Markdown

Catatan

Endpoint Order memerlukan izin perdagangan.

Pesan Tempat

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringYaSimbol
typestringYaLIMIT / MARKET
sidestringYaBUY / SELL
positionSidestringTidakBOTH / LONG / SHORT, BOTH default
pricestringPersyaratan bersyaratDiperlukan untuk pesanan batas
quantitystringPersyaratan bersyaratKuantitas. Dapat dihilangkan saat closePosition=true
timeInForcestringTidakGTC / IOC / FOK, GTC default
reduceOnlyboolTidakHanya pengurangan, false default
makerOnlyboolTidakHanya pembuat, false default
closePositionboolTidakTutup seluruh posisi, false default
clientOrderIdstringTidakID pesanan yang didefinisikan klien
placeTypestringTidakPenanda tipe penempatan pesanan
priceTypeint32TidakBBO jenis harga: harga 0 yang ditentukan, harga lawan 1 1, harga lawan 2 5, harga sisi 3 1, harga sisi sama 4 5

Contoh permintaan:

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}

Kolom respons:

LapanganTipeDeskripsi
orderIdstringID pesanan server
clientOrderIdstringID pesanan yang didefinisikan klien
statusstringStatus pesanan
timestampint64Cap waktu

Melakukan Pemesanan Batch

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

Badan permintaan:

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}

Kolom respons:

LapanganTipeDeskripsi
successCountint32Jumlah pesanan yang berhasil
failedCountint32Jumlah pesanan yang gagal
results[]arrayHasil untuk setiap pesanan

Pesan Kondisi

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringYaSimbol
typestringYaSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringYaBUY / SELL
positionSidestringTidakBOTH / LONG / SHORT
pricestringPersyaratan bersyaratDiperlukan untuk STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringPersyaratan bersyaratKuantitas. Dapat dihilangkan saat closePosition=true
timeInForcestringTidakGTC / IOC / FOK / GTE_GTC
reduceOnlyboolTidakHanya reduksi
clientOrderIdstringTidakID pesanan yang didefinisikan klien
stopPricestringPersyaratan bersyaratHarga pelatuk
workingTypestringTidakMARK_PRICE / CONTRACT_PRICE, CONTRACT_PRICE default
priceProtectboolTidakApakah perlindungan harga diaktifkan
activatePricestringPersyaratan bersyaratHarga aktivasi pesanan trailing
callbackRatestringPersyaratan bersyaratTingkat panggilan balik pesanan terlambat
closePositionboolTidakTutup seluruh posisi

Kolom respons:

LapanganTipeDeskripsi
conditionIdstringID pesanan kondisi
conditionStatusstringStatus urutan kondisi
timestampint64Cap waktu

Pesan Strategi

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
strategyTypestringYaOTOCO / OTO / OCO
subOrderListarrayYaDaftar sub-urutan

Medan dalam subOrderList[] sebagian besar sama dengan orde normal dan perintah kondisi, dengan medan ketergantungan tambahan:

ParameterTipeDeskripsi
strategySubIdint64Sub-order ID
firstDrivenIdint64Nomor Kartu Pesanan Mengemudi pertama. 0 berarti tidak ada ketergantungan
firstDrivenOnstringKondisi pemicu pertama
firstTriggerstringAksi pemicu pertama
secondDrivenIdint64ID pesanan mengemudi kedua
secondDrivenOnstringKondisi pemicu kedua
secondTriggerstringAksi pemicu kedua

Kolom respons:

LapanganTipeDeskripsi
strategyIdstringID Strategi
strategyStatusstringStatus strategi
timestampint64Cap waktu

Query Pesanan Tunggal

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringYaSimbol
orderIdstringTidakID pesanan server
clientOrderIdstringTidakID pesanan yang didefinisikan klien

Setidaknya satu dari orderId dan clientOrderId harus disediakan. Jika keduanya disediakan, server melakukan kecocokan yang tepat pada kedua kondisi tersebut.

Perintah Normal Saat Ini

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringTidakSimbol
limitint32TidakBatas jumlah pengembalian
lastOrderIdint64TidakBidang kursor

Kolom respons:

LapanganTipeDeskripsi
list[]arrayDaftar urutan normal saat ini
totalint32Hitung

Pesanan Kondisi Saat Ini

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringTidakSimbol

Ordo Normal Historis

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringTidakSimbol
orderIdstringTidakFilter ID pesanan yang tepat
clientOrderIdstringTidakFilter ID pesanan klien yang tepat
typeint32TidakFilter tipe pesanan: batas 1, pasar 2
sideint32TidakFilter samping: 1 beli, 2 jual
statusint32TidakFilter status
startTimeint64TidakWaktu mulai
endTimeint64TidakWaktu akhir
pageint64TidakNomor halaman, 1 default
pageSizeint64TidakItem per halaman, 20 default

Perintah Kondisi Historis

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringTidakSimbol
sideint32TidakFilter samping: 1 beli, 2 jual
statusint32TidakFilter status
startTimeint64TidakWaktu mulai
endTimeint64TidakWaktu akhir
pageint64TidakNomor halaman, 1 default
pageSizeint64TidakItem per halaman, 20 default

Rekor Perdagangan

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringTidakSimbol
orderIdstringTidakFilter ID Pesanan
startTimeint64TidakWaktu mulai
endTimeint64TidakWaktu akhir
pageint64TidakNomor halaman, 1 default
pageSizeint64TidakItem per halaman, 20 default

Kolom respons:

LapanganTipeDeskripsi
list[].fillIdstringID detail isi
list[].tradeIdstringID catatan perdagangan
list[].orderIdstringID Pesanan
list[].symbolstringSimbol
list[].sidestringSisi
list[].roleTypestringmaker / taker
list[].pricestringHarga penuh
list[].quantitystringJumlah yang terisi
list[].tradeValuestringNilai perdagangan
list[].handlingFeestringBiaya penanganan
list[].realizedPnlstringTerwujud PnL
list[].positionSidestringSisi posisi
list[].createdAtint64Waktu perdagangan
totalint64Total jumlah

Batalkan Pesanan

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

Badan permintaan:

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

clientOrderId juga dapat digunakan untuk membatalkan pesanan.

Amandemen Perintah

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

Badan permintaan:

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

quantity adalah jumlah total pesanan akhir setelah perubahan, bukan jumlah yang tersisa.

Pesanan Amandemen Batch

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

Badan permintaan:

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

Batalkan Pesanan secara Batch

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

Badan permintaan:

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

Batalkan Semua

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

Parameter permintaan:

ParameterTipeWajibDeskripsi
symbolstringTidakSimbol
cancelTypeint32Tidak0 semua pesanan normal, hanya pesanan batas 1 , 2 semua pesanan kondisi. Default 0

Cancel-all untuk pesanan normal diterima secara asinkron. Status akhir harus ditentukan oleh endpoint WebSocket ORDER_TRADE_UPDATE atau query.

Membatalkan Pesanan Kondisi

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

Badan permintaan:

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

Detail Perintah Strategi

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

Kolom respons:

LapanganTipeDeskripsi
strategyIdstringID Strategi
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Waktu penciptaan
subOrders[]arrayDetail sub-order
updateTimeint64Waktu pembaruan