# Optioncharts — 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 options trading data including full option chains, strike prices, expiration dates, and market flow analytics for any ticker symbol. Analyze trending options, get detailed ticker overviews, and monitor the most active options to make informed trading decisions.

**Category:** Finance & Markets | **Website:** [optioncharts.io/](https://optioncharts.io/) | **Docs:** [parse.bot/marketplace/97915842-89de-4347-91be-b10717d0a1ae/optioncharts-io-api](https://parse.bot/marketplace/97915842-89de-4347-91be-b10717d0a1ae/optioncharts-io-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/optioncharts/`
**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 call options by strike

Returns only call options data for each strike price for a given ticker. Equivalent to get_option_chain with option_type set to 'calls'. Each contract includes strike price, bid/ask/mid prices, volume, open interest, implied volatility, and Greeks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `expiration` | string | No | Expiration date to filter by, as shown in get_expiration_dates results |
| `ticker` | string | Yes | Stock ticker symbol (e.g., AAPL, SPY, TSLA) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/optioncharts/get-call-options-by-strike \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"expiration":"<string>","ticker":"<string>"}'
```

### Get expiration dates

Returns available expiration dates for a ticker with summary statistics including volume, open interest, implied volatility, expected move, and max pain for each expiration. Use these expiration values as the expiration parameter in get_option_chain or get_call_options_by_strike.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | Stock ticker symbol (e.g., AAPL, SPY, TSLA) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/optioncharts/get-expiration-dates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### Get most active by ticker

Returns trending most active stock options ranked by total option volume. Includes call/put volume breakdown and put-call ratio for each ticker. No parameters required; returns the current day's most active options tickers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/optioncharts/get-most-active-by-ticker \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get option chain

Returns the full options chain (calls and puts) for a ticker symbol. Uses the nearest expiration date by default unless a specific expiration is provided. Results include strike price, bid/ask/mid prices, volume, open interest, implied volatility, and Greeks (Delta, Gamma, Theta, Vega). Filter by option_type to see only calls, only puts, or both.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `expiration` | string | No | Expiration date to filter by, as shown in get_expiration_dates results (e.g., 'Jun 12, 2026 (1 days) (w)') |
| `option_type` | string | No | Option type filter: 'calls', 'puts', or 'both' |
| `ticker` | string | Yes | Stock ticker symbol (e.g., AAPL, SPY, TSLA) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/optioncharts/get-option-chain \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"expiration":"<string>","option_type":"<string>","ticker":"<string>"}'
```

### Get options flow

Returns options flow data showing the largest recent option trades across all tickers. Each trade includes contract details, trade type (large/block), sentiment (bullish/bearish/neutral), total value, size, and execution timestamp. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/optioncharts/get-options-flow \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get ticker overview

Returns overview information for a ticker including the company name, ticker symbol, and current stock price. Use this to get the current price context before analyzing options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | Stock ticker symbol (e.g., AAPL, SPY, TSLA) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/optioncharts/get-ticker-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```

### Search ticker

Search for a ticker symbol or company name. Returns matching tickers and their full company names. Useful for finding the correct ticker symbol before querying option data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `term` | string | Yes | Search term (ticker symbol or company name, e.g., 'AAPL' or 'Apple') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/optioncharts/search-ticker \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"term":"<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.