# Optioncharts — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/get_call_options_by_strike \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/get_expiration_dates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/get_most_active_by_ticker \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/get_option_chain \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/get_options_flow \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/get_ticker_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-optioncharts-io-api-97915842/search_ticker \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"term":"<string>"}'
```