Delete Copier

Delete a trade copier. Copying stops and the copier no longer appears in lists.

Elite

The Management API requires an Elite subscription. See Authentication.

NT8

Endpoint

DELETE https://app.crosstrade.io/v1/api/manage/nt8/copiers/{id}

Headers

Name	Required	Value
Authorization	Yes	Bearer <your API token>
If-Match	No	ETag from a previous read. The request fails with 412 if the copier changed since then

Path parameters

Name	Type	Description
id	string	The copier id

Code examples

Python

import requests

resp = requests.delete(
    "https://app.crosstrade.io/v1/api/manage/nt8/copiers/4b1f0c9e2d7a4c55b1e0",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
print(resp.status_code, resp.json())

cURL

curl -X DELETE "https://app.crosstrade.io/v1/api/manage/nt8/copiers/4b1f0c9e2d7a4c55b1e0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Responses

200

{
  "success": true,
  "changed": true,
  "changedFields": [
    "active",
    "autoSync.enabled",
    "autoSync.intervalSeconds",
    "fillsOnly",
    "followers",
    "id",
    "instruments",
    "inverse",
    "leader",
    "mode",
    "reconnectDelayMs",
    "sizing.method",
    "sizing.ratio",
    "stealth",
    "strategyTagMode",
    "syncCorrection.cooldownSeconds",
    "syncCorrection.maxAttempts",
    "tandem",
    "type"
  ],
  "delivery": {
    "status": "queued",
    "target": "nt8_addon"
  },
  "warnings": [],
  "meta": {
    "requestId": "req_9f2c1a0b7d3e4f51"
  }
}

Other errors

Status	error	When
400	invalid_path	The id in the path is not valid
400	unexpected_body	A body was sent
401	unauthorized	Missing or invalid token
403	elite_required, not_available	See Authentication
404	not_found	No such copier on your login
409	concurrent_modification	Another change to your copiers is in progress
412	precondition_failed	If-Match did not match
429	rate_limited, too_many_concurrent_requests	See Rate limits
503	management_read_only, management_busy, storage_unavailable, outcome_unknown	See Errors

Tradovate

Endpoint

DELETE https://app.crosstrade.io/v1/api/manage/tradovate/copiers/{id}

Headers

Name	Required	Value
Authorization	Yes	Bearer <your API token>
If-Match	No	ETag from a previous read. The request fails with 412 if the copier changed since then

Path parameters

Name	Type	Description
id	string	The copier id

Code examples

Python

import requests

resp = requests.delete(
    "https://app.crosstrade.io/v1/api/manage/tradovate/copiers/9c3e5a7b1d2f4e6a8b0c",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
print(resp.status_code, resp.json())

cURL

curl -X DELETE "https://app.crosstrade.io/v1/api/manage/tradovate/copiers/9c3e5a7b1d2f4e6a8b0c" \
  -H "Authorization: Bearer YOUR_TOKEN"

Responses

200

{
  "success": true,
  "changed": true,
  "changedFields": [
    "active",
    "autoSync.enabled",
    "fillsOnly",
    "followers",
    "id",
    "instruments",
    "inverse",
    "leader",
    "mode",
    "sizing.method",
    "sizing.ratio",
    "stealth",
    "syncCorrection.cooldownSeconds",
    "syncCorrection.maxAttempts",
    "tandem",
    "type"
  ],
  "delivery": {
    "status": "automatic",
    "target": "tradovate_engine"
  },
  "warnings": [],
  "meta": {
    "requestId": "req_9f2c1a0b7d3e4f51"
  }
}

Other errors

Status	error	When
400	invalid_path	The id in the path is not valid
400	unexpected_body	A body was sent
401	unauthorized	Missing or invalid token
403	elite_required, not_available	See Authentication
404	not_found	No such copier on your login
409	concurrent_modification	Another change to your copiers is in progress
412	precondition_failed	If-Match did not match
429	rate_limited, too_many_concurrent_requests	See Rate limits
503	management_read_only, management_busy, storage_unavailable, outcome_unknown	See Errors

When it takes effect

NinjaTrader: sent to the add-on right after the delete, or when it next connects. Tradovate: right away.

Notes

• changedFields lists every field of the deleted copier that had a value (fields that were null or empty are left out), and the change history keeps their last values.