# Vixcentral — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/vixcentral/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/vixcentral/get-current-vix-curve \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vixcentral/get-historical-range \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vixcentral/get-historical-vix-curve \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.