Ordem

Nota

endpoints de ordens requerem permissão comercial.

Ordem de Colocação

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

Parâmetros de pedido:

Exemplo de pedido:

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:

Encomendas por Lote

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

Pedido de 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 pedido:

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

Os campos em subOrderList[] são maioritariamente iguais às ordens normais e ordens de condições, com campos de dependência adicionais:

Campos de resposta:

Consultar ordem única

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

Parâmetros de pedido:

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

Campos de resposta:

Ordens de Estado Atual

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

Parâmetros de pedido:

Ordens Normais Históricas

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

Parâmetros de pedido:

Ordens de Condição Histórica

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

Parâmetros de pedido:

Recordes de Troca

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

Parâmetros de pedido:

Campos de resposta:

Cancelar Ordem

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

Pedido de corpo:

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

clientOrderId também pode ser usado para cancelar uma encomenda.

Ordem de Alteração

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

Pedido de corpo:

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

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

Ordens de Emenda em Lote

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

Pedido de corpo:

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

Cancelamento de Encomendas por Lote

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

Pedido de 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 pedido:

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

Cancelar Ordem de Condição

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

Pedido de 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 Comuns
• Canal de Utilizador Privado
• Recomendações de Integração