Orden

Ver como Markdown

Nota

los endpoints de órdenes requieren permiso comercial.

Orden de lugares

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringSímbolo
typestringLIMIT / MARKET
sidestringBUY / SELL
positionSidestringNoBOTH / LONG / SHORT, por defecto BOTH
pricestringRequerido condicionalmenteRequerida para órdenes límite
quantitystringRequerido condicionalmenteCantidad. Se puede omitir cuando closePosition=true
timeInForcestringNoGTC / IOC / FOK, por defecto GTC
reduceOnlyboolNoSolo reducir, por defecto false
makerOnlyboolNoSolo para creadores, false predeterminada
closePositionboolNoCierra toda la posición, por defecto false
clientOrderIdstringNoID de orden definido por el cliente
placeTypestringNoMarcador de tipo de colocación de orden
priceTypeint32NoBBO tipo de precio: 0 precio especificado, 1 precio del oponente 1, 2 precio del oponente 5, 3 precio del mismo lado 1, 4 precio del mismo lado 5

Solicito ejemplo:

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}

Campos de respuesta:

CampoTipoDescripción
orderIdstringID de orden del servidor
clientOrderIdstringID de orden definido por el cliente
statusstringEstado de la orden
timestampint64Marca de tiempo

Pedidos por lotes

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

Solicito cuerpo:

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}

Campos de respuesta:

CampoTipoDescripción
successCountint32Número de órdenes exitosas
failedCountint32Número de órdenes fallidas
results[]arrayResultado para cada orden

Orden de Condición de Lugar

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringSímbolo
typestringSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringBUY / SELL
positionSidestringNoBOTH / LONG / SHORT
pricestringRequerido condicionalmenteObligatorio para STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringRequerido condicionalmenteCantidad. Se puede omitir cuando closePosition=true
timeInForcestringNoGTC / IOC / FOK / GTE_GTC
reduceOnlyboolNoSolo reducir
clientOrderIdstringNoID de orden definido por el cliente
stopPricestringRequerido condicionalmentePrecio de disparo
workingTypestringNoMARK_PRICE / CONTRACT_PRICE, por defecto CONTRACT_PRICE
priceProtectboolNoSi la protección de precios está habilitada
activatePricestringRequerido condicionalmentePrecio de activación de órdenes posteriores
callbackRatestringRequerido condicionalmenteTasa de callback en el orden final
closePositionboolNoCierra toda la posición

Campos de respuesta:

CampoTipoDescripción
conditionIdstringID de orden de condición
conditionStatusstringEstado del orden de condición
timestampint64Marca de tiempo

Lugar Orden de Estrategia

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
strategyTypestringOTOCO / OTO / OCO
subOrderListarrayLista de subórdenes

Los campos en subOrderList[] son en su mayoría iguales a los órdenes normales y los órdenes de condición, con campos de dependencia adicionales:

ParámetroTipoDescripción
strategySubIdint64ID de suborden
firstDrivenIdint64Primer ID de orden de manejo. 0 significa sin dependencia
firstDrivenOnstringPrimera condición detonante
firstTriggerstringPrimera acción de disparo
secondDrivenIdint64Segunda identificación de orden de conducción
secondDrivenOnstringSegunda condición desencadenante
secondTriggerstringSegunda acción de gatillo

Campos de respuesta:

CampoTipoDescripción
strategyIdstringID de estrategia
strategyStatusstringEstado de la estrategia
timestampint64Marca de tiempo

Consulta en un solo orden

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringSímbolo
orderIdstringNoID de orden del servidor
clientOrderIdstringNoID de orden definido por el cliente

Al menos uno de orderId y clientOrderId debe ser proporcionado. Si ambos se proporcionan, el servidor realiza una coincidencia exacta en ambas condiciones.

Órdenes Normales Actuales

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringNoSímbolo
limitint32NoLímite de conteo de retorno
lastOrderIdint64NoCampo de cursor

Campos de respuesta:

CampoTipoDescripción
list[]arrayLista actual de orden normal
totalint32Conde

Órdenes de Condición Actual

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringNoSímbolo

Órdenes Normales Históricas

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringNoSímbolo
orderIdstringNoFiltro ID de orden exacto
clientOrderIdstringNoFiltro exacto de ID de pedido de cliente
typeint32NoFiltro de tipo de pedido: límite 1, mercado 2
sideint32NoFiltro lateral: 1 comprar, 2 vender
statusint32NoFiltro de estado
startTimeint64NoHora de inicio
endTimeint64NoFin del tiempo
pageint64NoNúmero de página, 1 predeterminado
pageSizeint64NoElementos por página, 20 predeterminado

Órdenes de Condición Histórica

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringNoSímbolo
sideint32NoFiltro lateral: 1 comprar, 2 vender
statusint32NoFiltro de estado
startTimeint64NoHora de inicio
endTimeint64NoFin del tiempo
pageint64NoNúmero de página, 1 predeterminado
pageSizeint64NoElementos por página, 20 predeterminado

Récords de intercambio

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringNoSímbolo
orderIdstringNoFiltro de ID de orden
startTimeint64NoHora de inicio
endTimeint64NoFin del tiempo
pageint64NoNúmero de página, 1 predeterminado
pageSizeint64NoElementos por página, 20 predeterminado

Campos de respuesta:

CampoTipoDescripción
list[].fillIdstringID de detalle de relleno
list[].tradeIdstringID de registro comercial
list[].orderIdstringID de la Orden
list[].symbolstringSímbolo
list[].sidestringSide
list[].roleTypestringmaker / taker
list[].pricestringPrecio de relleno
list[].quantitystringCantidad llena
list[].tradeValuestringValor comercial
list[].handlingFeestringCuota de manejo
list[].realizedPnlstringPnL realizado
list[].positionSidestringLado de posición
list[].createdAtint64Tiempo de intercambio
totalint64Conteo total

Cancelar Orden

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

Solicito cuerpo:

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

clientOrderId también puede usarse para cancelar un pedido.

Orden de enmienda

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

Solicito cuerpo:

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

quantity es la cantidad total final del pedido después de la enmienda, no la cantidad restante.

Órdenes de Enmienda por Lotes

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

Solicito cuerpo:

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

Cancelar pedidos por lotes

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

Solicito cuerpo:

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

Cancelar todo

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

Parámetros de solicitud:

ParámetroTipoObligatorioDescripción
symbolstringNoSímbolo
cancelTypeint32No0 todas las órdenes normales, 1 solo órdenes límite, 2 todas las órdenes de condición. Default 0

La cancelación total para órdenes normales se acepta de manera asíncrona. El estado final debe ser determinado por WebSocket ORDER_TRADE_UPDATE o por los endpoints de consulta.

Cancelar Orden de Condición

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

Solicito cuerpo:

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

Detalle del orden de estrategias

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

Campos de respuesta:

CampoTipoDescripción
strategyIdstringID de estrategia
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Tiempo de creación
subOrders[]arrayDetalles del suborden
updateTimeint64Hora de actualización