POST Cancel Orders

Cancel orders by account and/or instrument

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

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Path Parameters

Name	Type	Required	Description
account	string	Required	Name of account in NT8

Body

Name	Type	Required	Description
instrument	string	Optional	Optional name of instrument

info

When instrument is omitted, all working orders across the entire account are cancelled. When instrument is provided, only orders for that instrument are affected. Use the instrument filter when you want to cancel protective orders on a specific position without touching orders on other instruments in the same account.

Code Examples

Python

import requests

token = 'my-secret-token'

url = "https://app.crosstrade.io/v1/api/accounts/Sim101/orders/cancel"
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}
data = {
    # "instrument": "MES 12-25"
}

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}")

JavaScript

const token = 'my-secret-token';

const url = "https://app.crosstrade.io/v1/api/accounts/Sim101/orders/cancel";
const data = {
  // instrument: "MES 12-25"
};

fetch(url, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify(data)
})
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

cURL

TOKEN="my-secret-token"

curl -X POST "https://app.crosstrade.io/v1/api/accounts/Sim101/orders/cancel" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

---

Response

200

{
    "orderIds": [
        "adb3868865de4b59b0e147b8300e4a29",
        "2141df9fc0254ba9b34c8a5e38722249",
        "16f6774e302748ce962f2d60b58b2eb1"
    ],
    "success": true
}

400

{
  "error": "Invalid request"
}

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": "CancelOrders",
  "args": {
    "account": "Sim101",
    "instrument": "ES 09-26"
  }
}