POST Place Order

Place an order

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

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	Required	Name of underlying instrument (e.g., "ES 12-25")
action	string	Required	BUY, SELL
quantity	integer	Required	Contract quantity of new order
orderType	string	Required	MARKET, LIMIT, STOPMARKET, STOPLIMIT
timeInForce	string	Required	DAY, GTC
limitPrice	float	Optional	Limit price when submitting limit order type
stopPrice	float	Optional	Stop price when submitting stop order type
ocoId	string	Optional	Create or append to OCO order by ID
strategy	string	Optional	ATM strategy name if opening with ATM template
orderId	string	Optional	Custom order ID to assign at placement. If provided, this ID can be used to look up or cancel the order later.
requireMarketPosition	string	Optional	Comma-separated list of position states that must be true for the order to be accepted: "flat", "long", "short". Example: "flat" blocks the order if a position is already open. "flat,long" allows entry from flat or adding to a long. If the condition is not met, a 400 error is returned and no order is placed.
maxPositions	integer	Optional	Blocks the order if the account already has this many or more open positions across all instruments. Only applies when opening a new position, not adding to an existing one.

Code Examples

Python

import requests

token = 'my-secret-token'

url = "https://app.crosstrade.io/v1/api/accounts/Sim101/orders/place"
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}
data = {
    "instrument": "MES 12-25",
    "action": "BUY",
    "orderType": "MARKET",
    "quantity": 1,
    "timeInForce": "DAY"
    # "limitPrice": 5500
    # "stopPrice": 0,
    # "ocoId": "abc123",
    # "strategy": "MyAtmStrategy"
}

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/place";
const data = {
  instrument: "MES 12-25",
  action: "BUY",
  orderType: "MARKET",
  quantity: 1,
  timeInForce: "DAY"
  // limitPrice: 5500,
  // stopPrice: 0,
  // ocoId: "abc123",
  // strategy: "MyAtmStrategy"
};

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/place" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "instrument": "MES 12-25",
    "action": "BUY",
    "orderType": "MARKET",
    "quantity": 1,
    "timeInForce": "DAY"
  }'

---

Response

200

{
    "orderId": "cb1fc8d4e1a84d29ae38fea964aaac8c",
    "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",
  "api": "PlaceOrder",
  "args": {
    "account": "Sim101",
    "instrument": "ES 09-26",
    "action": "Buy",
    "orderType": "Market",
    "quantity": 1,
    "timeInForce": "Gtc"
  }
}