Orden

Nota

los endpoints de órdenes requieren permiso comercial.

Orden de los lugares

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

Parámetros de solicitud:

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:

Pedidos por lotes

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

Solicitar 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:

Orden de Condición de Lugar

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

Parámetros de solicitud:

Campos de respuesta:

Colocar Estrategia Ordenar

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

Parámetros de solicitud:

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:

Campos de respuesta:

Consulta en un solo orden

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

Parámetros de solicitud:

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

Órdenes normales actuales

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

Parámetros de solicitud:

Campos de respuesta:

Órdenes de Estado Actual

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

Parámetros de solicitud:

Órdenes Normales Históricas

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

Parámetros de solicitud:

Órdenes de Condición Histórica

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

Parámetros de solicitud:

Récords de traspasos

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

Parámetros de solicitud:

Campos de respuesta:

Cancelar pedido

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

Solicitar cuerpo:

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

clientOrderId también puede usarse para cancelar un pedido.

Orden de enmienda

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

Solicitar cuerpo:

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

quantity es la cantidad total final del pedido tras la modificación, no la cantidad restante.

Órdenes de enmienda por lotes

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

Solicitar cuerpo:

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

Cancelación de pedidos por lote

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

Solicitar cuerpo:

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

Cancelar todo

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

Parámetros de solicitud:

La cancelación total para pedidos normales se acepta de forma asíncrona. El estado final debe determinarse mediante WebSocket ORDER_TRADE_UPDATE o por los endpoints de consulta.

Cancelar Orden de Condición

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

Solicitar cuerpo:

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

Detalle del orden de la estrategia

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

Campos de respuesta:

Documentación relacionada

• Tipos de Orden
• Enums comunes
• Canal de usuario privado
• Recomendaciones de integración