# Your closed and settled spreads

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

API: Nexus.

Every spread you closed or that settled at expiry, newest closed first: each leg's open and close price, the realized P&L in dollars and as a percent, why it closed (`MEMBER` you closed it, `DESK` the desk closed it for you, `EXPIRY` it settled) and when. Main account only, as above. Your history is yours to read whenever spreads are open or not.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/spreads/history?limit=50&offset=0" \
  -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 |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | no | How many to return, 1 to 200 (more is read as 200). (default `50`; min 1; max 200) |
| `offset` | query | integer | no | How many to skip first. (default `0`; min 0) |
| `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/history" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

Your closed and settled spreads, newest closed first.

One closed vertical spread (a local run of the route).:

```json
{
  "data": [
    {
      "spreadId": "9f9f4ef2-a05d-41b1-89fe-356631e9b7d5",
      "account": "main",
      "strategy": "VERTICAL",
      "underlying": "SPY",
      "netEffect": "DEBIT",
      "status": "CLOSED",
      "quantity": 2,
      "openPrice": 1.9,
      "closePrice": 1.7,
      "closeEffect": "CREDIT",
      "realizedPnl": -40,
      "realizedPnlPercent": -10.53,
      "closeReason": "MEMBER",
      "openedAt": "2026-11-18T17:05:51.484272Z",
      "closedAt": "2026-11-18T17:05:51.489415Z",
      "legs": [
        {
          "assetClass": "options",
          "ticker": "SPY",
          "expiration": "2030-12-31",
          "strike": 775,
          "direction": "call",
          "side": "BUY",
          "ratio": 1,
          "openPrice": 3.1,
          "closePrice": 3
        },
        {
          "assetClass": "options",
          "ticker": "SPY",
          "expiration": "2030-12-31",
          "strike": 780,
          "direction": "call",
          "side": "SELL",
          "ratio": 1,
          "openPrice": 1.2,
          "closePrice": 1.3
        }
      ]
    }
  ],
  "meta": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}
```

### 400

`bad_request`: limit or offset out of range.

### 401

Missing or invalid key.

### 422

`port_unsupported`: spreads are on your main account only.

### 503

`unavailable`: spreads are not available on this server right now.
