# Your spread orders

`GET https://app.skylit.ai/api/nexus/v1/spreads/orders`

API: Nexus.

Without `date`: the spread orders resting now, whatever day you placed them. With `date` (a New York day): every spread order of that day, whatever its status. Orders you placed on the Spreads ticket in Nexus are here too. Main account only.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/spreads/orders?date=2026-11-18" \
  -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 |
| --- | --- | --- | --- | --- |
| `date` | query | string (date) | no | `YYYY-MM-DD`, a New York day: that day's spread orders, whatever their status. Leave it out for the orders resting now, whatever day they were placed. |
| `account` | query | string | no | `main` or left out. Spreads are on your main account only. (one of `main`) |

## Example request

```bash
curl "https://app.skylit.ai/api/nexus/v1/spreads/orders" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The orders, with how many.

A day with an open and its close (the orders from a local run of the place route).:

```json
{
  "data": [
    {
      "account": "main",
      "averageFillPrice": 1.9,
      "cancellable": false,
      "clientOrderId": "da4f696b-acbc-47a8-a906-43bec1db4915",
      "fees": 0,
      "filledQuantity": 2,
      "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.9,
      "message": null,
      "netEffect": "DEBIT",
      "orderId": "7da49596-592e-48ff-b257-e39109e1fd62",
      "orderType": "LIMIT",
      "positionEffect": "OPEN",
      "quantity": 2,
      "realizedPnl": null,
      "receivedAt": "2026-11-19T02:49:01.671794Z",
      "status": "FILLED",
      "strategy": "VERTICAL",
      "timeInForce": "DAY",
      "underlying": "SPY"
    },
    {
      "account": "main",
      "averageFillPrice": 1.7,
      "cancellable": false,
      "clientOrderId": "1ed8dfd4-d6cb-4c2b-a4e3-ae548085a357",
      "fees": 0,
      "filledQuantity": 2,
      "legs": [
        {
          "assetClass": "options",
          "direction": "call",
          "expiration": "2030-12-31",
          "ratio": 1,
          "side": "SELL",
          "strike": 775,
          "ticker": "SPY"
        },
        {
          "assetClass": "options",
          "direction": "call",
          "expiration": "2030-12-31",
          "ratio": 1,
          "side": "BUY",
          "strike": 780,
          "ticker": "SPY"
        }
      ],
      "limitPrice": 1.7,
      "message": null,
      "netEffect": "CREDIT",
      "orderId": "600e1471-0a62-4613-b754-c5dc61c7af0a",
      "orderType": "LIMIT",
      "positionEffect": "CLOSE",
      "quantity": 2,
      "realizedPnl": -40,
      "receivedAt": "2026-11-19T02:49:01.686513Z",
      "status": "FILLED",
      "strategy": "VERTICAL",
      "timeInForce": "DAY",
      "underlying": "SPY"
    }
  ],
  "meta": {
    "account": "main",
    "total": 2
  }
}
```

### 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."
  }
}
```

### 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."
  }
}
```
