Ordem

Nota

endpoints de ordens exigem permissão comercial.

Ordem de Colocação

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

Parâmetros de solicitação:

Exemplo de solicitação:

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

Pedidos de Lote

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

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

Campos de resposta:

Ordem de Condição de Lugar

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

Parâmetros de solicitação:

Campos de resposta:

Ordem de Estratégia de Colocação

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

Parâmetros de solicitação:

Campos em subOrderList[] são em sua maioria os mesmos que ordens normais e ordens de condição, com campos de dependência adicionais:

Campos de resposta:

Consulta de ordem única

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

Parâmetros de solicitação:

Pelo menos um dos orderId e clientOrderId deve ser fornecido. Se ambos forem fornecidos, o servidor executa uma correspondência exata em ambas as condições.

Ordens Normais Atuais

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

Parâmetros de solicitação:

Campos de resposta:

Ordens de Condição Atual

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

Parâmetros de solicitação:

Ordens Normais Históricas

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

Parâmetros de solicitação:

Ordens de Condição Histórica

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

Parâmetros de solicitação:

Recordes de troca

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

Parâmetros de solicitação:

Campos de resposta:

Cancelar Pedido

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

Solicitar corpo:

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

clientOrderId também podem ser usados para cancelar um pedido.

Ordem de Alteração

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

Solicitar corpo:

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

quantity é a quantidade total final do pedido após a alteração, não a quantidade restante.

Ordens de Correção em Lote

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

Solicitar corpo:

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

Cancelamento de Pedidos em Lote

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

Solicitar corpo:

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

Cancelar Tudo

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

Parâmetros de solicitação:

Cancelar tudo para ordens normais é aceito de forma assíncrona. O status final deve ser determinado por endpoints WebSocket ORDER_TRADE_UPDATE ou de consulta.

Cancelar Ordem de Condição

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

Solicitar corpo:

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

Detalhe da Ordem da Estratégia

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

Campos de resposta:

Documentação relacionada

• Tipos de Ordem
• Enums Comum
• Canal de Usuário Privado
• Recomendações de Integração