Düzen

Markdown olarak görüntüle

Not

Sipariş uç noktaları işlem izni gerektirir.

Yer Siparişi

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringEvetSembol
typestringEvetLIMIT / MARKET
sidestringEvetBUY / SELL
positionSidestringHayırBOTH / LONG / SHORT, varsayılan BOTH
pricestringKoşullu olarak gereklidirLimit emirleri için gerekli
quantitystringKoşullu olarak gereklidirMiktar. Atlandığında closePosition=true
timeInForcestringHayırGTC / IOC / FOK, varsayılan GTC
reduceOnlyboolHayırSadece azalt, varsayılan false
makerOnlyboolHayırSadece üretici için, varsayılan false
closePositionboolHayırTüm pozisyonu kapat, varsayılan false
clientOrderIdstringHayırİstemci tarafından tanımlanan sipariş kimliği
placeTypestringHayırSipariş yerleştirme tipi işaretleyici
priceTypeint32HayırBBO fiyat türü: 0 fiyat, 1 rakip fiyat 1, 2 rakip fiyat 5, 3 aynı taraf fiyatı 1 4 aynı taraf fiyatı 5

Örnek iste:

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}

Yanıt alanları:

SahaTipTanım
orderIdstringSunucu sipariş kimliği
clientOrderIdstringİstemci tarafından tanımlanan sipariş kimliği
statusstringSipariş durumu
timestampint64Zaman damgası

Toplu Siparişler

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

Talep bedeni:

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}

Yanıt alanları:

SahaTipTanım
successCountint32Başarılı sipariş sayısı
failedCountint32Başarısız emir sayısı
results[]arrayHer sipariş için sonuç

Yer Koşulu Sırası

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringEvetSembol
typestringEvetSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringEvetBUY / SELL
positionSidestringHayırBOTH / LONG / SHORT
pricestringKoşullu olarak gereklidirSTOP_LIMIT / TAKE_PROFIT_LIMIT için zorunlu
quantitystringKoşullu olarak gereklidirMiktar. Atlandığında closePosition=true
timeInForcestringHayırGTC / IOC / FOK / GTE_GTC
reduceOnlyboolHayırSadece azalt
clientOrderIdstringHayırİstemci tarafından tanımlanan sipariş kimliği
stopPricestringKoşullu olarak gereklidirTetikleyici fiyat
workingTypestringHayırMARK_PRICE / CONTRACT_PRICE, varsayılan CONTRACT_PRICE
priceProtectboolHayırFiyat korumasının mümkün olup olmadığı
activatePricestringKoşullu olarak gereklidirTakip eden emir aktivasyon fiyatı
callbackRatestringKoşullu olarak gereklidirTakip eden sipariş geri çağrı oranı
closePositionboolHayırTüm pozisyonu kapat

Yanıt alanları:

SahaTipTanım
conditionIdstringDurum Sırası Kimliği
conditionStatusstringDurum sırası durumu
timestampint64Zaman damgası

Yerleştirme Stratejisi Sırası

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

Talep parametreleri:

ParametreTipGerekliTanım
strategyTypestringEvetOTOCO / OTO / OCO
subOrderListarrayEvetAlt sıralar listesi

subOrderList[]’daki alanlar çoğunlukla normal mertebeler ve koşul sıralarıyla aynıdır, ek bağımlılık alanları içerir:

ParametreTipTanım
strategySubIdint64Alt sıra ID’si
firstDrivenIdint64İlk sürüş emri kimliği. 0 bağımlılık yok demektir
firstDrivenOnstringİlk tetikleme durumu
firstTriggerstringİlk tetikleme eylemi
secondDrivenIdint64İkinci sürüş emri kimliği
secondDrivenOnstringİkinci tetikleyici koşulu
secondTriggerstringİkinci tetikleme eylemi

Yanıt alanları:

SahaTipTanım
strategyIdstringStrateji Kimliği
strategyStatusstringStrateji durumu
timestampint64Zaman damgası

Tek Sıra Sorgu

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringEvetSembol
orderIdstringHayırSunucu sipariş kimliği
clientOrderIdstringHayırİstemci tarafından tanımlanan sipariş kimliği

En az orderId ve clientOrderId biri sağlanmalıdır. Her ikisi de sağlanırsa, sunucu her iki koşulda da tam bir eşleşme gerçekleştirir.

Mevcut Normal Siparişler

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringHayırSembol
limitint32HayırDönüş sayısı sınırı
lastOrderIdint64Hayırİmleç alanı

Yanıt alanları:

SahaTipTanım
list[]arrayMevcut normal sıralar listesi
totalint32Kont

Mevcut Durum Emirleri

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringHayırSembol

Tarihsel Normal Emirler

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringHayırSembol
orderIdstringHayırTam sıra ID filtresi
clientOrderIdstringHayırKesin müşteri siparişi ID filtresi
typeint32HayırSipariş tipi filtre: 1 limiti, 2 piyasa
sideint32HayırYan filtre: 1 al, 2 sat
statusint32HayırDurum filtresi
startTimeint64HayırBaşlama zamanı
endTimeint64HayırSon zaman
pageint64HayırSayfa numarası, varsayılan 1
pageSizeint64HayırSayfa başına öğeler, varsayılan 20

Tarihi Durum Emirleri

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringHayırSembol
sideint32HayırYan filtre: 1 al, 2 sat
statusint32HayırDurum filtresi
startTimeint64HayırBaşlama zamanı
endTimeint64HayırSon zaman
pageint64HayırSayfa numarası, varsayılan 1
pageSizeint64HayırSayfa başına öğeler, varsayılan 20

Ticaret Kayıtları

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringHayırSembol
orderIdstringHayırSipariş Kimliği filtresi
startTimeint64HayırBaşlama zamanı
endTimeint64HayırSon zaman
pageint64HayırSayfa numarası, varsayılan 1
pageSizeint64HayırSayfa başına öğeler, varsayılan 20

Yanıt alanları:

SahaTipTanım
list[].fillIdstringDolgu detayı kimliği
list[].tradeIdstringTicari kayıt kimliği
list[].orderIdstringSipariş Kimliği
list[].symbolstringSembol
list[].sidestringYan Takım
list[].roleTypestringmaker / taker
list[].pricestringDoldurulmuş fiyat
list[].quantitystringDoldurulan miktar
list[].tradeValuestringTicaret değeri
list[].handlingFeestringTaşıma ücreti
list[].realizedPnlstringGerçekleşen PnL
list[].positionSidestringPozisyon tarafı
list[].createdAtint64Takas süresi
totalint64Toplam sayım

İptal Siparişi

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

Talep bedeni:

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

clientOrderId ayrıca bir siparişi iptal etmek için de kullanılabilir.

Değişiklik Emri

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

Talep bedeni:

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

quantity , değişiklikten sonraki nihai toplam sipariş miktarıdır, kalan miktar değil.

Parti Değişikliği Emirleri

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

Talep bedeni:

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

Parti İptal Emirleri

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

Talep bedeni:

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

Her Şeyi İptal Et

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

Talep parametreleri:

ParametreTipGerekliTanım
symbolstringHayırSembol
cancelTypeint32Hayır0 tüm normal emirler, 1 limit emirleri 2 tüm koşul emirleri. Varsayılan 0

Normal siparişler için iptal etme asenkron olarak kabul edilir. Nihai durum WebSocket ORDER_TRADE_UPDATE veya sorgu uç noktalarına göre belirlenmelidir.

Şart İptal Emiri

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

Talep bedeni:

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

Strateji Siparişi Detayı

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

Yanıt alanları:

SahaTipTanım
strategyIdstringStrateji Kimliği
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Yaratım zamanı
subOrders[]arrayAlt sipariş detayları
updateTimeint64Güncelleme zamanı