Market data for AI assistants

Ask your assistant what the options market is showing.

Connect OptionWhales to ChatGPT, Claude, Codex or another MCP client. Your assistant can retrieve options flow, gamma exposure, volatility, earnings and market context from one source.

Market-data research software. OptionWhales does not execute trades; examples are informational, not investment recommendations.

Get Pro for $19/month Preview the connection

Free previews available · OAuth or API-key access

Try a real research question

The assistant chooses the relevant OptionWhales tools.

“What are the key SPY gamma levels today?”
“Show unusual NVDA options trades and explain the directional pressure.”
“How does QQQ implied volatility change across expirations?”
“Which earnings and macro events are scheduled this week?”
“Which tickers are having their selling absorbed today?”

What comes back

Market-data responses grounded in the same data as the dashboard

Use conversational prompts for a quick read, then open the dashboard or call the API when you want to inspect the underlying rows and charts.

Example MCP answer

“What are SPY's gamma levels?”

Gamma flip

772.57

Max pain

771.00

OptionWhales' structural GEX snapshot for SPY, computed at 11:31:46 UTC on October 22, 2026, placed the call wall at 770 and the put wall at 765. The front expiration was October 22, 2026.

A separate spot snapshot at 18:27 UTC showed SPY at 762.59. Because the structure and spot observations came from different times, this example does not infer pinning or proximity from their difference.

Dated historical research example based on OptionWhales MCP data. It is not a current market reading or investment recommendation.

OptionWhales options-flow data available to AI assistants, showing unusual trades, buyers, sellers and premium
Flow Intelligence product capture · session dated March 3, 2026 · Historical example; values are not live.

Connect in minutes

Choose your assistant

  1. 1

    Sign in

    Use your OptionWhales account or create a free one.

  2. 2

    Connect the URL

    Paste the matching OptionWhales connection URL below.

  3. 3

    Ask a question

    Try the SPY gamma-level question or one of the prompts above.

ChatGPT

https://api.optionwhales.io/mcp/chatgpt

Add a custom app with this URL, choose OAuth sign-in, then ask about options flow or market structure.

Claude

https://api.optionwhales.io/mcp/connect

In Settings → Connectors, add a custom connector and paste this URL. Claude prompts you to sign in when needed.

Claude Code

https://api.optionwhales.io/mcp/connect

claude mcp add --transport http optionwhales https://api.optionwhales.io/mcp/connect

Any MCP client with header support

Use https://api.optionwhales.io/mcp and send your key in X-API-Key or Authorization: Bearer. Never put a key in the URL.

Claude Code with API key
claude mcp add --transport http optionwhales https://api.optionwhales.io/mcp \
  --header "X-API-Key: YOUR_KEY"
VS Code / GitHub Copilot
{
  "servers": {
    "optionwhales": {
      "type": "http",
      "url": "https://api.optionwhales.io/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}
Codex
[mcp_servers.optionwhales]
url = "https://api.optionwhales.io/mcp"
http_headers = { "X-API-Key" = "YOUR_KEY" }
Cursor, Windsurf and other MCP clients
{
  "mcpServers": {
    "optionwhales": {
      "url": "https://api.optionwhales.io/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

No key yet? Create a free account, or let a compatible assistant call register_free_key. Confirm the emailed code to keep the key active.

Allowances

Preview with Free. Research the full market with Pro.

Capability
Free
Pro
Gamma levels
SPY and QQQ
Any supported ticker
Options-flow rankings
Top 3
Full feed
Unusual options trades
Latest 5
Full feed
Earnings and economic calendar
Economic calendar · limited earnings
Full access
Implied volatility
Selected tickers
Any supported ticker
OI, dark pool, tide and contracts
—
Full access
Absorption (microstructure)
—
Full access
Quotes, candles, technicals and news
—
Full access
API allowance
10 requests/min · 200/day
60 requests/min · 5,000/day
Price
$0
$19/month

Put market context inside the assistant you already use.

Get full tool access, every supported ticker and the Pro API allowance for $19 per month.

Get Pro for $19/month Read API docs

For research and education, not investment advice.