# Cancel a resting spread order

`POST https://app.skylit.ai/api/nexus/v1/spreads/orders/{orderId}/cancel`

API: Nexus.

Cancels a resting spread order and gives back what it held. Always allowed: spreads switched off, Simulated paused or your agent's main account setting never stop a cancel. An order that already filled, expired, or was cancelled or rejected answers `409 order_not_working`.

```bash
curl -s -X POST "https://app.skylit.ai/api/nexus/v1/spreads/orders/7f7ef4d3-0ed3-4bef-9daa-a6ae9cd05bd3/cancel" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Authentication

Send your Skylit API key as a bearer token: `Authorization: Bearer <key>`. No other header is accepted.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orderId` | path | string (uuid) | yes | The spread order's `orderId`, from the place or the order list. |

## Request body

`application/json`

```json
{
  "account": "main",
  "port": "string"
}
```

## Example request

```bash
curl "https://app.skylit.ai/api/nexus/v1/spreads/orders/7da49596-592e-48ff-b257-e39109e1fd62/cancel" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The order, cancelled.

The resting vertical, cancelled (a local run of the route).:

```json
{
  "data": {
    "account": "main",
    "averageFillPrice": null,
    "cancellable": false,
    "clientOrderId": "6553af6c-ed2c-4f11-bb03-16972d4874ff",
    "fees": null,
    "filledQuantity": 0,
    "legs": [
      {
        "assetClass": "options",
        "direction": "call",
        "expiration": "2030-12-31",
        "ratio": 1,
        "side": "BUY",
        "strike": 775,
        "ticker": "SPY"
      },
      {
        "assetClass": "options",
        "direction": "call",
        "expiration": "2030-12-31",
        "ratio": 1,
        "side": "SELL",
        "strike": 780,
        "ticker": "SPY"
      }
    ],
    "limitPrice": 1.6,
    "message": null,
    "netEffect": "DEBIT",
    "orderId": "7f7ef4d3-0ed3-4bef-9daa-a6ae9cd05bd3",
    "orderType": "LIMIT",
    "positionEffect": "OPEN",
    "quantity": 1,
    "realizedPnl": null,
    "receivedAt": "2026-11-19T07:53:44.98834Z",
    "status": "CANCELLED",
    "strategy": "VERTICAL",
    "timeInForce": "DAY",
    "underlying": "SPY"
  },
  "meta": {
    "account": "main"
  }
}
```

### 400

Refused before anything was sent. Codes: `bad_request` (an unknown field, a leg that isn't `options` or `stocks`, legs that don't form the `strategy`, a missing `limitPrice` on a limit, a market order with one, a quantity over 100, a modify with neither `quantity` nor `limitPrice`, a `date` that isn't `YYYY-MM-DD`), `expiry_day_cutoff` (on a leg's expiration day, new spread opens stop at 3:00 PM ET; closes are never refused).

An open on its expiration day after 3:00 PM ET.:

```json
{
  "error": {
    "code": "expiry_day_cutoff",
    "message": "On its expiration day, Simulated takes new spread orders until 3:00 PM ET. You can still close."
  }
}
```

A modify with nothing to change.:

```json
{
  "error": {
    "code": "bad_request",
    "message": "Send a new quantity, a new limitPrice or both. To change anything else, cancel the order and place a new one."
  }
}
```

### 401

No key, or a key that isn't valid. Codes: `missing_api_key`, `invalid_api_key`.

No key sent.:

```json
{
  "error": {
    "code": "missing_api_key",
    "message": "Send your Skylit API key in the Authorization header: Authorization: Bearer YOUR_SKYLIT_API_KEY."
  }
}
```

### 404

Not on your account. Codes: `order_not_found` (no spread order of yours with that id), `spread_not_found` (no open spread of yours with that id).

Not your spread order, or no such order.:

```json
{
  "error": {
    "code": "order_not_found",
    "message": "No spread order with that id."
  }
}
```

### 409

It clashes with what you hold or sent before. Codes: `preview_mismatch` (the ticket isn't what the preview priced: preview again), `spread_conflict` (closing a spread you don't hold, closing more than you hold or than your resting closes leave, or opening one you hold the other way round: close it instead), `working_order_limit` (your resting API orders, stops included, and every working spread order count together toward 50, spread orders placed on the Spreads ticket in Nexus included), `client_order_id_used`, `order_not_working` (it already filled, expired, or was cancelled or rejected), `exit_triggered` (the stop or target was reached and the spread is closing, so its exit can't change).

The place doesn't match its preview.:

```json
{
  "error": {
    "code": "preview_mismatch",
    "message": "This isn't what the preview priced, so nothing was placed. Preview it again and send that preview's confirmationToken and clientOrderId."
  }
}
```

50 resting orders already.:

```json
{
  "error": {
    "code": "working_order_limit",
    "message": "You have 46 orders resting through the API and 4 spread orders working (the limit is 50 together). Cancel some before placing more."
  }
}
```

### 422

Read fine, but the account says no. Codes: `port_unsupported` (any account but `main`, or any port), `insufficient_buying_power` (with `orderId` when the order was recorded as rejected), `order_rejected` (recorded as rejected as it was placed; `orderId` points to it), `contract_expired`.

Spreads on a port or the agent account.:

```json
{
  "error": {
    "code": "port_unsupported",
    "message": "Spreads are on your main account only. Send account \"main\" or leave account and port out."
  }
}
```

### 429

Over a rate limit. Wait `Retry-After` seconds, then retry. Codes: `rate_limited`, and `stream_limit_reached` (too many live streams open: 3 per key, 6 per account).

Headers: `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`.

Too many writes from this key.:

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests (limit 30). Slow down and retry in 12 seconds."
  }
}
```

### 500

Something went wrong on our side. If you sent a `clientOrderId`, retry with the same one. Code: `internal_error`.

Retry with the same clientOrderId.:

```json
{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side. If you sent a clientOrderId, retry with the same one (it can't fill twice). Otherwise check your account before retrying."
  }
}
```

### 503

Try again in a moment. Codes: `no_live_quote` (a leg, or the underlying, has no live quote; quotes older than 15 s never fill), `unavailable` (spreads aren't on this server, or a check couldn't be read).

A leg has no live quote.:

```json
{
  "error": {
    "code": "no_live_quote",
    "message": "No live quote for a leg right now (quotes older than 15 s never fill), so nothing was placed. Try again."
  }
}
```
