Skip to main content

POST Cancel and Bracket

Cancel and Bracket NT8​

Cancel all working orders on an instrument and immediately place new OCO bracket orders (take profit and stop loss) to protect an existing position. This is an atomic operation designed for algo workflows that need to replace protective orders without leaving the position exposed.

Endpoint​

POST /v1/api/accounts/{account}/orders/cancel_and_bracket

Headers​

NameValue
Content-Typeapplication/json
AuthorizationBearer <token>

Path parameters​

NameTypeRequiredDescription
accountstringRequiredAccount name in NT8

Body parameters​

NameTypeRequiredDescription
instrumentstringRequiredInstrument name (e.g., "ES 09-26")
actionstringRequiredDirection of the position being protected: Buy or Sell
quantityintRequiredNumber of contracts for each bracket leg
takeProfitnumberOptionalLimit price for the take profit order
stopLossnumberOptionalStop price for the stop loss order
ocoIdstringOptionalCustom OCO ID. If omitted, one is generated automatically

At least one of takeProfit or stopLoss must be provided, or no orders will be placed.

Code examples​

import requests

token = 'my-secret-token'
url = "https://app.crosstrade.io/v1/api/accounts/Sim101/orders/cancel_and_bracket"
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}

data = {
    "instrument": "ES 09-26",
    "action": "Buy",
    "quantity": 1,
    "takeProfit": 5550.00,
    "stopLoss": 5450.00
}

try:
    response = requests.post(url, headers=headers, json=data)
    print(f"Response Code: {response.status_code}, Response Text: {response.text}")
except Exception as e:
    print(f"An error occurred: {e}")

Response​

On normal success, cancelled is the number of existing orders cancelled, placed contains the full newly submitted protection-order objects, and ocoId is their shared OCO identifier.

{
  "success": true,
  "cancelled": 2,
  "placed": [
    {
      "orderId": "ddc3f4c244b047fda3f4d9f8f44bc8f3",
      "orderType": "Limit",
      "orderAction": "Sell",
      "quantity": 1,
      "limitPrice": 5550.0,
      "ocoId": "a1b2c3d4e5"
    },
    {
      "orderId": "b415488f31ff454682a947684e871a90",
      "orderType": "StopMarket",
      "orderAction": "Sell",
      "quantity": 1,
      "stopPrice": 5450.0,
      "ocoId": "a1b2c3d4e5"
    }
  ],
  "ocoId": "a1b2c3d4e5"
}

Platform nuances​

How It Works​

The command executes in three phases: first, it cancels all non-terminal orders for the specified instrument on the account. After a configurable delay to allow the broker to process the cancellations, it places a new take profit (limit) and stop loss (stop market) as an OCO pair. The two new orders share an OCO ID, meaning if one fills, the other is automatically cancelled by NinjaTrader.

The action field represents the direction of the position you are protecting, not the direction of the exit orders. If you are long and pass "action": "Buy", the command will place Sell limit and stop market orders to protect the long position. The action is inverted internally.

An open position is required. A flat position is rejected before existing orders are cancelled, and action must match the live position side. A side mismatch is also rejected before cancellation.

If a position in the underlying instrument already exists and the position is smaller than the requested quantity, the bracket is automatically clamped to match the actual position size. If the position goes flat during the cancel window (e.g., a stop was hit while orders were being cancelled), the bracket placement is aborted entirely to prevent accidental naked entry orders.

info

If a protective stop fills during the cancel phase and the position goes flat before the bracket is placed, bracket placement is automatically aborted. The response will include success: true alongside a warning field. No new orders are placed, preventing an accidental naked entry.

WebSocket API​

This request can also be made over the WebSocket API. The account path parameter and request body fields are all passed inside args.

{
  "action": "rpc",
  "id": "my-request-id",
  "api": "CancelAndBracket",
  "args": {
    "account": "Sim101",
    "instrument": "ES 09-26",
    "action": "Buy",
    "quantity": 1,
    "takeProfit": 5550.00,
    "stopLoss": 5450.00
  }
}