# The S&P volatility complex

`GET https://api.skylit.ai/v1/vol/market`

API: Heatseeker.

The market-wide volatility read: VIX1D, VIX9D, VIX, VIX3M, VIX6M, VVIX
and SKEW (computed by Tempest from SPX and VIX option chains), their
ratios and one-year percentiles, the VIX-forward curve state and roll
(`vx_curve_state`, `vx_roll_pct`, `vx_m1_vs_vix_pct`; the curve's price
points are not served), regime and crowded-calm flags,
Mag-7 vs QQQ dispersion, a Fear & Greed score with its components, and
120 sessions of history for the main series. **Cost:** 1 credit.

## Authentication

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

## Example request

```bash
curl "https://api.skylit.ai/v1/vol/market" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

OK.

Shape (placeholder values):

```json
{
  "data": {},
  "meta": {
    "module": "string",
    "asOf": "string",
    "sessionDate": "string",
    "marketState": "pre_open",
    "frozen": false,
    "publishedAt": "string",
    "cached": false
  }
}
```

### 400

Request validation failed.

### 401

Missing API key (`unauthorized`), sent by the gateway.

### 402

Out of credits (`insufficient_credits`).

### 403

As `Forbidden`, or `not_entitled`: Tempest data is not enabled for this
account (it is in preview). Refunded.

### 404

Unknown symbol, no data available, or none of the requested
`expirations` exist for the symbol (`code: expiration_not_found`).

### 429

Per-minute rate limit exceeded.

Headers: `Retry-After`.

### 503

Tempest data is loading (`warming_up`, with `Retry-After`) or not configured (`unavailable`). Refunded.

### 504

The request did not finish in time (`gateway_timeout`). Refunded;
retry, or narrow the request.