Ordine

Visualizza come Markdown

Nota

endpoint degli ordini richiedono permesso di commercio.

Ordine di posta

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringSimbolo
typestringLIMIT / MARKET
sidestringBUY / SELL
positionSidestringNoBOTH / LONG / SHORT, BOTH predefinito
pricestringRichiesto a condizioneRichiesto per gli ordini limitati
quantitystringRichiesto a condizioneQuantità. Può essere omesso quando closePosition=true
timeInForcestringNoGTC / IOC / FOK, GTC predefinito
reduceOnlyboolNoSolo riduce, predefinito false
makerOnlyboolNoSolo creatore, false predefinita
closePositionboolNoChiudi tutta la posizione, predefinito false
clientOrderIdstringNoID ordine definito dal client
placeTypestringNoMarcatore di tipo di posizionamento dell’ordine
priceTypeint32NoBBO tipo di prezzo: 0 prezzo specificato, 1 prezzo dell’avversario 1, 2 prezzo dell’avversario 5, 3 prezzo dello stesso lato 1, 4 prezzo dello stesso lato 5

Richiesta esempio:

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}

Campi di risposta:

CampoTipoDescrizione
orderIdstringID ordine del server
clientOrderIdstringID ordine definito dal client
statusstringStato dell’ordine
timestampint64Timestamp

Ordini di Lotti

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

Richiesta di corpo:

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}

Campi di risposta:

CampoTipoDescrizione
successCountint32Numero di ordini riusciti
failedCountint32Numero di ordini falliti
results[]arrayRisultato per ogni ordine

Ordine Condizione del Luogo

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringSimbolo
typestringSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringBUY / SELL
positionSidestringNoBOTH / LONG / SHORT
pricestringRichiesto a condizioneRichiesto per STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringRichiesto a condizioneQuantità. Può essere omesso quando closePosition=true
timeInForcestringNoGTC / IOC / FOK / GTE_GTC
reduceOnlyboolNoSolo riduzione
clientOrderIdstringNoID ordine definito dal client
stopPricestringRichiesto a condizionePrezzo di innesco
workingTypestringNoMARK_PRICE / CONTRACT_PRICE, CONTRACT_PRICE predefinito
priceProtectboolNoSe la protezione dei prezzi è abilitata
activatePricestringRichiesto a condizionePrezzo di attivazione degli ordini finali
callbackRatestringRichiesto a condizioneTasso di callback degli ordini finali
closePositionboolNoChiudi tutta la posizione

Campi di risposta:

CampoTipoDescrizione
conditionIdstringID dell’ordine delle condizioni
conditionStatusstringStato dell’ordine di condizione
timestampint64Timestamp

Posiziona Strategia Ordine

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
strategyTypestringOTOCO / OTO / OCO
subOrderListarrayElenco dei sottoordini

I campi in subOrderList[] sono per lo più uguali agli ordini normali e agli ordini di condizione, con campi di dipendenza aggiuntivi:

ParametroTipoDescrizione
strategySubIdint64ID sottoordine
firstDrivenIdint64Primo documento di autorizzazione di guida. 0 significa nessuna dipendenza
firstDrivenOnstringPrima condizione trigger
firstTriggerstringPrima azione di scatto
secondDrivenIdint64Secondo ID di guida
secondDrivenOnstringSeconda condizione trigger
secondTriggerstringSeconda azione di scatto

Campi di risposta:

CampoTipoDescrizione
strategyIdstringID Strategia
strategyStatusstringStato della strategia
timestampint64Timestamp

Consulta un ordine singolo

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringSimbolo
orderIdstringNoID ordine del server
clientOrderIdstringNoID ordine definito dal client

Deve essere fornito almeno uno dei orderId e clientOrderId . Se entrambi sono forniti, il server esegue una corrispondenza esatta su entrambe le condizioni.

Ordini normali attuali

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringNoSimbolo
limitint32NoLimite di conteggio dei ritorni
lastOrderIdint64NoCampo cursore

Campi di risposta:

CampoTipoDescrizione
list[]arrayElenco attuale dell’ordine normale
totalint32Conte

Ordini di condizioni attuali

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringNoSimbolo

Ordini Normali Storici

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringNoSimbolo
orderIdstringNoFiltro ID dell’ordine esatto
clientOrderIdstringNoFiltro esatto dell’ID ordine del cliente
typeint32NoFiltro tipo di ordine: limite 1 , 2 mercato
sideint32NoFiltro laterale: 1 comprare, 2 vendere
statusint32NoFiltro di stato
startTimeint64NoOrario di inizio
endTimeint64NoFine dei tempi
pageint64NoNumero di pagina, 1 predefinito
pageSizeint64NoElementi per pagina, 20 predefinita

Ordini di Condizioni Storiche

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringNoSimbolo
sideint32NoFiltro laterale: 1 comprare, 2 vendere
statusint32NoFiltro di stato
startTimeint64NoOrario di inizio
endTimeint64NoFine dei tempi
pageint64NoNumero di pagina, 1 predefinito
pageSizeint64NoElementi per pagina, 20 predefinita

Record di scambio

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringNoSimbolo
orderIdstringNoFiltro ID Ordine
startTimeint64NoOrario di inizio
endTimeint64NoFine dei tempi
pageint64NoNumero di pagina, 1 predefinito
pageSizeint64NoElementi per pagina, 20 predefinita

Campi di risposta:

CampoTipoDescrizione
list[].fillIdstringID dettaglio di riempimento
list[].tradeIdstringID record commerciale
list[].orderIdstringID dell’Ordine
list[].symbolstringSimbolo
list[].sidestringSide
list[].roleTypestringmaker / taker
list[].pricestringPrezzo coperto
list[].quantitystringQuantità riempita
list[].tradeValuestringValore commerciale
list[].handlingFeestringTariffa di gestione
list[].realizedPnlstringPnL realizzato
list[].positionSidestringLato posizione
list[].createdAtint64Ora di commercio
totalint64Conteggio totale

Annulla ordine

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

Richiesta di corpo:

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

clientOrderId può anche essere usato per annullare un ordine.

Ordine di modifica

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

Richiesta di corpo:

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

quantity è la quantità totale finale dell’ordine dopo la modifica, non la quantità rimanente.

Ordini di Modifica a Batch

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

Richiesta di corpo:

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

Ordini di Annullamento Lotto

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

Richiesta di corpo:

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

Annulla tutto

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
symbolstringNoSimbolo
cancelTypeint32No0 tutti gli ordini normali, 1 solo gli ordini limite, 2 tutti gli ordini di condizione. 0 predefinito

Il cancel-all per ordini normali viene accettato asincronamente. Lo stato finale dovrebbe essere determinato da endpoint WebSocket ORDER_TRADE_UPDATE o di query.

Annulla l’ordine di condizione

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

Richiesta di corpo:

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

Dettaglio dell’ordine strategico

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

Campi di risposta:

CampoTipoDescrizione
strategyIdstringID Strategia
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Tempo di creazione
subOrders[]arrayDettagli del sottoordine
updateTimeint64Tempo di aggiornamento