# Vixcentral — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time and historical VIX futures curves along with key market indicators like VIX, VIX9D, VIX3M, and VIX6M to analyze volatility term structure and market sentiment. Track how these volatility metrics have changed over time with customizable historical date ranges for comprehensive market analysis.

**Category:** Finance & Markets | **Website:** [vixcentral.com/](https://vixcentral.com/) | **Docs:** [parse.bot/marketplace/13ec11b7-b3ef-49b8-a3d4-7bbd51009074/vixcentral-com-api](https://parse.bot/marketplace/13ec11b7-b3ef-49b8-a3d4-7bbd51009074/vixcentral-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-vixcentral-com-api-13ec11b7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_current_vix_curve

Retrieves the current VIX futures term structure including month labels, Last prices, Settle prices, and major VIX indices (VIX, VIX9D, VIX3M, VIX6M). Returns a snapshot timestamped at retrieval time. Each curve entry represents one futures contract month. Indicators may be null outside trading hours.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vixcentral-com-api-13ec11b7/get_current_vix_curve \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_historical_range

Retrieves a time series of VIX index and futures prices for a range of dates. Limited to 31 calendar days per request. Only trading days with available data are included in results. Weekend and holiday dates are skipped. The truncated flag indicates whether the range exceeded the 31-day limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | Yes | End date in YYYY-MM-DD format. Must be on or after start_date. |
| `start_date` | string | Yes | Start date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vixcentral-com-api-13ec11b7/get_historical_range \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","start_date":"<string>"}'
```

### get_historical_vix_curve

Retrieves the VIX futures term structure for a specific historical date. Returns the VIX index closing value and the price of each futures contract month (1-based index). Data available from 2007 onwards. Non-trading days return no data (upstream_error).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Date in YYYY-MM-DD format. Data available from 2007 onwards. Must be a trading day (weekday, non-holiday). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vixcentral-com-api-13ec11b7/get_historical_vix_curve \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```