# One spread order

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

API: Nexus.

One of your spread orders, whatever its status. Someone else's id answers `404 order_not_found`, as an unknown one does.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/spreads/orders/7da49596-592e-48ff-b257-e39109e1fd62" \
  -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. |
| `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/7da49596-592e-48ff-b257-e39109e1fd62" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The order.

The filled open (the order 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"
  },
  "meta": {
    "account": "main"
  }
}
```

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

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