> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# Ordem

> Use 6MM endpoints de pedidos para criar, consultar, cancelar e gerenciar ordens perpétuas enquanto lida com permissões, identificadores e estados do ciclo de vida.

> **Nota**
>
> endpoints de ordens exigem permissão comercial.

<h2 id="place-order">
  Ordem de Colocação
</h2>

```http
POST /v1/private/order/place
Content-Type: application/json
```

**Parâmetros de solicitação:**

| Parâmetro       | Tipo   | Obrigatório              | Descrição                                                                                                                                        |
| --------------- | ------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `symbol`        | string | Sim                      | Símbolo                                                                                                                                          |
| `type`          | string | Sim                      | `LIMIT` / `MARKET`                                                                                                                               |
| `side`          | string | Sim                      | `BUY` / `SELL`                                                                                                                                   |
| `positionSide`  | string | Não                      | `BOTH` / `LONG` / `SHORT`, `BOTH` padrão                                                                                                         |
| `price`         | string | Exigido condicionalmente | Exigido para ordens limitadas                                                                                                                    |
| `quantity`      | string | Exigido condicionalmente | Quantidade. Pode ser omitida quando `closePosition=true`                                                                                         |
| `timeInForce`   | string | Não                      | `GTC` / `IOC` / `FOK`, `GTC` padrão                                                                                                              |
| `reduceOnly`    | bool   | Não                      | Apenas reduzir, padrão `false`                                                                                                                   |
| `makerOnly`     | bool   | Não                      | Apenas para o maker, `false` padrão                                                                                                              |
| `closePosition` | bool   | Não                      | Feche toda a posição, padrão `false`                                                                                                             |
| `clientOrderId` | string | Não                      | ID de ordem definido pelo cliente                                                                                                                |
| `placeType`     | string | Não                      | Marcador de tipo de colocação de ordem                                                                                                           |
| `priceType`     | int32  | Não                      | BBO tipo de preço: `0` preço especificado, `1` preço do oponente 1, `2` preço do oponente 5, `3` preço do mesmo lado 1 `4` preço do mesmo lado 5 |

**Exemplo de solicitação:**

```json
{
  "symbol": "BTCUSDT",
  "type": "LIMIT",
  "side": "BUY",
  "price": "85000",
  "quantity": "0.1",
  "timeInForce": "GTC",
  "makerOnly": true,
  "clientOrderId": "ext-1772710377808-001"
}
```

**Campos de resposta:**

| Campo           | Tipo   | Descrição                         |
| --------------- | ------ | --------------------------------- |
| `orderId`       | string | ID da ordem do servidor           |
| `clientOrderId` | string | ID de ordem definido pelo cliente |
| `status`        | string | Status da ordem                   |
| `timestamp`     | int64  | Carimbo de data e hora            |

<h2 id="batch-place-orders">
  Pedidos de Lote
</h2>

```http
POST /v1/private/order/batch-place
Content-Type: application/json
```

**Solicitar corpo:**

```json
{
  "orders": [
    {
      "symbol": "BTCUSDT",
      "type": "LIMIT",
      "side": "BUY",
      "price": "85000",
      "quantity": "0.1",
      "clientOrderId": "ext-buy-001"
    }
  ]
}
```

**Campos de resposta:**

| Campo          | Tipo  | Descrição                      |
| -------------- | ----- | ------------------------------ |
| `successCount` | int32 | Número de ordens bem-sucedidas |
| `failedCount`  | int32 | Número de pedidos falhados     |
| `results[]`    | array | Resultado para cada ordem      |

<h2 id="place-condition-order">
  Ordem de Condição de Lugar
</h2>

```http
POST /v1/private/order/place-condition
Content-Type: application/json
```

**Parâmetros de solicitação:**

| Parâmetro       | Tipo   | Obrigatório              | Descrição                                                                                   |
| --------------- | ------ | ------------------------ | ------------------------------------------------------------------------------------------- |
| `symbol`        | string | Sim                      | Símbolo                                                                                     |
| `type`          | string | Sim                      | `STOP_MARKET` / `TAKE_PROFIT_MARKET` / `STOP_LIMIT` / `TAKE_PROFIT_LIMIT` / `TRAILING_STOP` |
| `side`          | string | Sim                      | `BUY` / `SELL`                                                                              |
| `positionSide`  | string | Não                      | `BOTH` / `LONG` / `SHORT`                                                                   |
| `price`         | string | Exigido condicionalmente | Obrigatório para `STOP_LIMIT` / `TAKE_PROFIT_LIMIT`                                         |
| `quantity`      | string | Exigido condicionalmente | Quantidade. Pode ser omitida quando `closePosition=true`                                    |
| `timeInForce`   | string | Não                      | `GTC` / `IOC` / `FOK` / `GTE_GTC`                                                           |
| `reduceOnly`    | bool   | Não                      | Somente reduzir-se                                                                          |
| `clientOrderId` | string | Não                      | ID de ordem definido pelo cliente                                                           |
| `stopPrice`     | string | Exigido condicionalmente | Preço de gatilho                                                                            |
| `workingType`   | string | Não                      | `MARK_PRICE` / `CONTRACT_PRICE`, padrão `CONTRACT_PRICE`                                    |
| `priceProtect`  | bool   | Não                      | Se a proteção de preços é habilitada                                                        |
| `activatePrice` | string | Exigido condicionalmente | Preço de ativação da ordem móvel                                                            |
| `callbackRate`  | string | Exigido condicionalmente | Taxa de retorno de chamadas em ordem final                                                  |
| `closePosition` | bool   | Não                      | Feche toda a posição                                                                        |

**Campos de resposta:**

| Campo             | Tipo   | Descrição                   |
| ----------------- | ------ | --------------------------- |
| `conditionId`     | string | ID de ordem de condição     |
| `conditionStatus` | string | Status da ordem de condição |
| `timestamp`       | int64  | Carimbo de data e hora      |

<h2 id="place-strategy-order">
  Ordem de Estratégia de Colocação
</h2>

```http
POST /v1/private/order/place-strategy
Content-Type: application/json
```

**Parâmetros de solicitação:**

| Parâmetro      | Tipo   | Obrigatório | Descrição               |
| -------------- | ------ | ----------- | ----------------------- |
| `strategyType` | string | Sim         | `OTOCO` / `OTO` / `OCO` |
| `subOrderList` | array  | Sim         | Lista de subordens      |

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

| Parâmetro        | Tipo   | Descrição                                                               |
| ---------------- | ------ | ----------------------------------------------------------------------- |
| `strategySubId`  | int64  | ID de subordem                                                          |
| `firstDrivenId`  | int64  | Primeira identidade de ordem de trânsito. `0` significa sem dependência |
| `firstDrivenOn`  | string | Primeira condição gatilho                                               |
| `firstTrigger`   | string | Primeira ação de gatilho                                                |
| `secondDrivenId` | int64  | Segunda ordem de condução ID                                            |
| `secondDrivenOn` | string | Segunda condição gatilho                                                |
| `secondTrigger`  | string | Segunda ação de gatilho                                                 |

**Campos de resposta:**

| Campo            | Tipo   | Descrição              |
| ---------------- | ------ | ---------------------- |
| `strategyId`     | string | ID de Estratégia       |
| `strategyStatus` | string | Status da estratégia   |
| `timestamp`      | int64  | Carimbo de data e hora |

<h2 id="query-single-order">
  Consulta de ordem única
</h2>

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

**Parâmetros de solicitação:**

| Parâmetro       | Tipo   | Obrigatório | Descrição                         |
| --------------- | ------ | ----------- | --------------------------------- |
| `symbol`        | string | Sim         | Símbolo                           |
| `orderId`       | string | Não         | ID da ordem do servidor           |
| `clientOrderId` | string | Não         | ID de ordem definido pelo cliente |

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.

<h2 id="current-normal-orders">
  Ordens Normais Atuais
</h2>

```http
GET /v1/private/order/current?symbol=BTCUSDT
```

**Parâmetros de solicitação:**

| Parâmetro     | Tipo   | Obrigatório | Descrição                     |
| ------------- | ------ | ----------- | ----------------------------- |
| `symbol`      | string | Não         | Símbolo                       |
| `limit`       | int32  | Não         | Limite de contagem de retorno |
| `lastOrderId` | int64  | Não         | Campo cursor                  |

**Campos de resposta:**

| Campo    | Tipo  | Descrição                   |
| -------- | ----- | --------------------------- |
| `list[]` | array | Lista atual de ordem normal |
| `total`  | int32 | Conde                       |

<h2 id="current-condition-orders">
  Ordens de Condição Atual
</h2>

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

**Parâmetros de solicitação:**

| Parâmetro | Tipo   | Obrigatório | Descrição |
| --------- | ------ | ----------- | --------- |
| `symbol`  | string | Não         | Símbolo   |

<h2 id="historical-normal-orders">
  Ordens Normais Históricas
</h2>

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

**Parâmetros de solicitação:**

| Parâmetro       | Tipo   | Obrigatório | Descrição                                         |
| --------------- | ------ | ----------- | ------------------------------------------------- |
| `symbol`        | string | Não         | Símbolo                                           |
| `orderId`       | string | Não         | Filtro ID de ordem exata                          |
| `clientOrderId` | string | Não         | Filtro exato de ID de pedido de cliente           |
| `type`          | int32  | Não         | Filtro de tipo de pedido: limite `1`, mercado `2` |
| `side`          | int32  | Não         | Filtro lateral: `1` comprar, `2` vender           |
| `status`        | int32  | Não         | Filtro de status                                  |
| `startTime`     | int64  | Não         | Horário de início                                 |
| `endTime`       | int64  | Não         | Fim dos tempos                                    |
| `page`          | int64  | Não         | Número da página, `1` padrão                      |
| `pageSize`      | int64  | Não         | Itens por página, padrão `20`                     |

<h2 id="historical-condition-orders">
  Ordens de Condição Histórica
</h2>

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

**Parâmetros de solicitação:**

| Parâmetro   | Tipo   | Obrigatório | Descrição                               |
| ----------- | ------ | ----------- | --------------------------------------- |
| `symbol`    | string | Não         | Símbolo                                 |
| `side`      | int32  | Não         | Filtro lateral: `1` comprar, `2` vender |
| `status`    | int32  | Não         | Filtro de status                        |
| `startTime` | int64  | Não         | Horário de início                       |
| `endTime`   | int64  | Não         | Fim dos tempos                          |
| `page`      | int64  | Não         | Número da página, `1` padrão            |
| `pageSize`  | int64  | Não         | Itens por página, padrão `20`           |

<h2 id="trade-records">
  Recordes de troca
</h2>

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

**Parâmetros de solicitação:**

| Parâmetro   | Tipo   | Obrigatório | Descrição                     |
| ----------- | ------ | ----------- | ----------------------------- |
| `symbol`    | string | Não         | Símbolo                       |
| `orderId`   | string | Não         | Filtro de ID de ordem         |
| `startTime` | int64  | Não         | Horário de início             |
| `endTime`   | int64  | Não         | Fim dos tempos                |
| `page`      | int64  | Não         | Número da página, `1` padrão  |
| `pageSize`  | int64  | Não         | Itens por página, padrão `20` |

**Campos de resposta:**

| Campo                 | Tipo   | Descrição                      |
| --------------------- | ------ | ------------------------------ |
| `list[].fillId`       | string | ID de detalhe de preenchimento |
| `list[].tradeId`      | string | ID de registro comercial       |
| `list[].orderId`      | string | ID da Ordem                    |
| `list[].symbol`       | string | Símbolo                        |
| `list[].side`         | string | Side                           |
| `list[].roleType`     | string | `maker` / `taker`              |
| `list[].price`        | string | Preço preenchido               |
| `list[].quantity`     | string | Quantidade preenchida          |
| `list[].tradeValue`   | string | Valor comercial                |
| `list[].handlingFee`  | string | Taxa de manuseio               |
| `list[].realizedPnl`  | string | PnL realizado                  |
| `list[].positionSide` | string | Lado da posição                |
| `list[].createdAt`    | int64  | Hora da troca                  |
| `total`               | int64  | Contagem total                 |

<h2 id="cancel-order">
  Cancelar Pedido
</h2>

```http
POST /v1/private/order/cancel
Content-Type: application/json
```

**Solicitar corpo:**

```json
{
  "symbol": "BTCUSDT",
  "orderId": "2022543809547603968"
}
```

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

<h2 id="amend-order">
  Ordem de Alteração
</h2>

```http
POST /v1/private/order/move
Content-Type: application/json
```

**Solicitar corpo:**

```json
{
  "symbol": "BTCUSDT",
  "orderId": "2022543809547603968",
  "price": "85100",
  "quantity": "0.2"
}
```

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

<h2 id="batch-amend-orders">
  Ordens de Correção em Lote
</h2>

```http
POST /v1/private/order/batch-move
Content-Type: application/json
```

**Solicitar corpo:**

```json
{
  "symbol": "BTCUSDT",
  "orders": [
    {
      "orderId": "2022543809547603968",
      "price": "85100",
      "quantity": "0.2"
    }
  ]
}
```

<h2 id="batch-cancel-orders">
  Cancelamento de Pedidos em Lote
</h2>

```http
POST /v1/private/order/batch-cancel
Content-Type: application/json
```

**Solicitar corpo:**

```json
{
  "orders": [
    {
      "symbol": "BTCUSDT",
      "orderId": "2022543809547603968"
    }
  ]
}
```

<h2 id="cancel-all">
  Cancelar Tudo
</h2>

```http
POST /v1/private/order/batch-cancel-all
Content-Type: application/json
```

**Parâmetros de solicitação:**

| Parâmetro    | Tipo   | Obrigatório | Descrição                                                                                             |
| ------------ | ------ | ----------- | ----------------------------------------------------------------------------------------------------- |
| `symbol`     | string | Não         | Símbolo                                                                                               |
| `cancelType` | int32  | Não         | `0` todas as ordens normais, `1` apenas ordens de limite, `2` todas as ordens de condição. `0` padrã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.

<h2 id="cancel-condition-order">
  Cancelar Ordem de Condição
</h2>

```http
POST /v1/private/order/cancel-condition
Content-Type: application/json
```

**Solicitar corpo:**

```json
{
  "symbol": "BTCUSDT",
  "conditionId": "2022543809547603968"
}
```

<h2 id="strategy-order-detail">
  Detalhe da Ordem da Estratégia
</h2>

```http
GET /v1/private/order/strategy?strategyId=2022543809547603968
```

**Campos de resposta:**

| Campo            | Tipo   | Descrição                            |
| ---------------- | ------ | ------------------------------------ |
| `strategyId`     | string | ID de Estratégia                     |
| `strategyType`   | string | `OTOCO` / `OTO` / `OCO`              |
| `strategyStatus` | string | `WORKING` / `ALL_DONE` / `CANCELLED` |
| `bookTime`       | int64  | Tempo de criação                     |
| `subOrders[]`    | array  | Detalhes da subordem                 |
| `updateTime`     | int64  | Hora da atualização                  |

<h2 id="related-documentation">
  Documentação relacionada
</h2>

* [Tipos de Ordem](/pt-BR/trading/order-types)
* [Enums Comum](/pt-BR/developer-api/common-enums)
* [Canal de Usuário Privado](/pt-BR/developer-api/websocket/private-user-channel)
* [Recomendações de Integração](/pt-BR/developer-api/integration-recommendations)