# Read live option quotes

`GET https://app.skylit.ai/api/nexus/v1/trading/quotes`

API: Nexus.

The live bid, ask and mid of up to 20 option contracts, by OCC symbol. These are the quotes your simulated fills use, read by the same rules, so a `live` quote is what a market order would get right now: a buy at the ask, a sell at the bid.

- When a quote isn't live (the market's shut, the quote's more than 15 seconds old, no quote, or no such contract) you get `live: false`, a `reason`, and no prices at all. Hold off rather than guess.
- A live quote with no bid or no ask has no `mark` (`reason: one_sided`).
- For your own open trades you don't need this: `GET /api/nexus/v1/trades?status=open` gives each one its live `mark` and P/L.

Symbols are OCC: the root, the expiration as YYMMDD, `C` or `P`, then the strike times 1000 in 8 digits. `SPXW261016C07800000` is the SPXW 7800 call expiring 2026-10-16, and `QQQ261016P00740000` the QQQ 740 put. Lowercase, the padded 21 character form and an `O:` prefix work too. One call counts as one read.

## Authentication

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `symbols` | query | string | yes | One or more OCC option symbols, comma separated (at most 20). |

## Example request

```bash
curl "https://app.skylit.ai/api/nexus/v1/trading/quotes?symbols=SPXW261016C07800000,QQQ261016P00740000" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

One quote per symbol, in the order you sent them.

One live quote and one that's gone quiet.:

```json
{
  "data": [
    {
      "symbol": "SPXW261016C07800000",
      "ticker": "SPXW",
      "expiration": "2026-10-16",
      "strike": 7800,
      "direction": "call",
      "live": true,
      "bid": 41.1,
      "ask": 41.7,
      "mark": 41.4,
      "underlyingPrice": 7812.25,
      "quoteTime": "2026-10-14T15:31:02Z",
      "ageMs": 640
    },
    {
      "symbol": "QQQ261016P00740000",
      "ticker": "QQQ",
      "expiration": "2026-10-16",
      "strike": 740,
      "direction": "put",
      "live": false,
      "reason": "stale_quote",
      "underlyingPrice": 738.9,
      "quoteTime": "2026-10-14T15:30:21Z",
      "ageMs": 41640
    }
  ],
  "meta": {
    "asOf": "2026-10-14T15:31:02.64Z",
    "maxQuoteAgeSeconds": 15
  }
}
```

### 400

The request was refused before anything was traded. Codes: `bad_request`, `bad_contract`, `invalid_quantity`, `invalid_price`, `unsupported_asset_class`, `unsupported_order_type`, `only_market_orders`, `limit_price_required` (a limit with no `limitPrice`), `invalid_limit_price` (not in cents, or outside 0.01 to 99,999.99 for options or 999,999.99 for stocks), `stop_price_required` (a stop with no `stopPrice`), `invalid_stop_price` (not in cents, or outside 0.01 to 999,999.99), `invalid_take_profit`, `test_orders_unavailable`, `test_modify_unavailable`, `bad_symbol` (a quotes symbol that isn't OCC).

A typo in the body.:

```json
{
  "error": {
    "code": "bad_request",
    "message": "Unknown field \"quantitty\". See the trades API docs for the fields you can send."
  }
}
```

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

### 403

The key works but the account can't do this. Codes: `account_suspended`, `nexus_access_denied`, `futures_access_denied`.

The account doesn't include Nexus.:

```json
{
  "error": {
    "code": "nexus_access_denied",
    "message": "This Skylit account doesn't include Nexus, so it can't place Nexus trades."
  }
}
```

### 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 (honour `Retry-After` when it's sent). Codes: `stale_quote` (the quote, or a stock's last trade, is more than 15 seconds old, so nothing filled), `no_live_price`, `rules_pending`, `unavailable`, `auth_unavailable`, `access_check_unavailable`, `api_keys_unavailable`, `trades_api_disabled`, `stream_unavailable` (the live stream isn't on, or the server is restarting: try again shortly, or poll the reads).

Headers: `Retry-After`.

No live price right now.:

```json
{
  "error": {
    "code": "no_live_price",
    "message": "There's no live price for this contract right now, so nothing was filled. Try again in a moment."
  }
}
```
