Skip to content
Optionomics
Get started

API & MCP · Built for your workflow

Stock & options API and MCP server.

Bring market intelligence into your own apps and AI assistants. Optionomics connects options analytics, flow research, company filings and trade ideas to the tools you already use.

Explore the API reference Compare plans

REST API and MCP access are included with the Developer plan. Documentation is open to everyone.

Model Context Protocol

Your question. Connected to the research.

“What stands out in this stock’s options activity?”
01Your assistantTurns the question into a tool call
02OptionomicsReturns the available research
03Your answerContext you can investigate
REST API
Structured JSON for your application
MCP server
26 read-only research tools
Developer
$99 USD / month
An example research workflow. Your assistant requests the available data; you evaluate the answer.

01 / Model Context Protocol

Give your AI a source to work with.

The Optionomics MCP server lets a compatible assistant retrieve stock and options research while you stay in the conversation. Ask about a stock's gamma exposure, compare its options activity, or inspect a published trade idea and its track record.

Connect over Streamable HTTP at https://optionomics.ai/mcp. The developer console provides configurations for Claude Desktop, Claude Code, Cursor, VS Code. Each connection uses your account's credentials — a free key reads the previous session, Developer the live one.

Every external MCP tool is read-only. Your assistant can inspect the research without placing trades or changing your account.

Read the MCP setup guide
Example prompts

Start with a research question

  • “How is SPY's gamma exposure distributed by strike?”
  • “Compare NVDA's net call and put premium flow.”
  • “Summarize the latest MSFT earnings-filing analysis.”
Available readings depend on the symbol and session. Follow the dates and sources in the response.

02 / REST API

Build the workflow you want to use.

Request structured stock and options data over HTTPS and receive JSON for your Python notebooks, dashboards or research applications. Use the endpoint reference and published OpenAPI specification to choose the data and parameters your integration needs.

Authenticate with your account email in X-USER-EMAIL and its API key in X-USER-TOKEN. The public reference includes request examples and a playground for authenticated requests. Response dates and timestamps let you keep the research in its proper session context.

Read the REST API reference
REST API · cURL

A stock quote in one request

curl "https://optionomics.ai/api/v1/stocks/SPY/quote" \
  -H "X-USER-EMAIL: [email protected]" \
  -H "X-USER-TOKEN: $OPTIONOMICS_API_KEY"
Method
GET
Response
JSON with symbol, session date and quote
Access
Your account email, API key and Developer plan for the live session
Use your account email and set OPTIONOMICS_API_KEY to a key issued by that account. This example makes a read-only request.

Research you can build on

From an options chain
to the context around it.

The MCP server exposes 26 research tools and 2 resources for available symbols and trading days. Explore the tool names below; use the API reference for REST endpoint coverage and parameters.

Options flow and unusual activity

Compare aggregated call and put activity, net premium flow and unusual-activity research.

  • options_flow
  • net_flow
  • unusual_activity

The readings

How far a stock is priced to move and the odds of reaching it, earnings moves against the straddle, the volatility premium, the cheapest contract to trade, the live 0DTE read and today's list ranked by repricing — each with the study behind it.

  • expected_move
  • earnings_move
  • vol_premium
  • contract_chooser
  • zero_dte_read
  • session_list
  • pulse

Options chains and volatility

Inspect option chains, Greeks, gamma exposure and implied-volatility term structure.

  • options_chain
  • option_metrics
  • gamma_exposure
  • iv_term_structure

Price history and levels

Historical prices beside options-derived support and resistance and dark-pool levels.

  • price_history
  • support_resistance_levels
  • dark_pool_levels

Filings and disclosed trades

Read earnings-filing analysis alongside reported insider and congressional transactions.

  • earnings_analyses
  • insider_trades
  • politician_trades

Trade ideas and their record

Inspect published ideas and their historical outcomes, each rate beside its control.

  • trade_ideas
  • track_record

Market and news context

Connect stock quotes and market overviews with news and market-moving events.

  • stock_quote
  • market_overview
  • news
  • events

03 / Developer console

Keep your connections in view.

Create and revoke API keys, connect your MCP clients, and enable request and tool-call logging to inspect how your integration is used. The browser MCP console helps you try a research tool before wiring it into your own workflow.

For event-driven workflows, configure alert delivery from Optionomics and inspect webhook delivery logs in the developer console. API, MCP and alert delivery have distinct jobs: requests retrieve research, assistants call tools, and webhooks deliver matching notifications.

Connect an MCP client

Keys, requests and deliveries

API keyYour research integrationActive
Quote requestGET /api/v1/stocks/SPY/quote200 OK
Webhook deliveryInspect the responseFailed
Manage credentials and inspect your enabled logs from the developer console.

Start with one connection

From a question to a working integration.

API and MCP access are included with the Developer plan at $99 USD per month with monthly billing. Yearly billing is available.

  1. Choose Developer

    Review the included research and billing options.

    See Developer pricing

  2. Create an API key

    Sign in and issue a key from your developer console.

    Manage API keys

  3. Make your first request

    Use the REST reference or connect an MCP client.

    Open the reference

Before you connect

API & MCP,
explained.

Talk to us
What is the Optionomics API and MCP server?

Optionomics provides a REST API for stock and options research, plus a Model Context Protocol (MCP) server that lets compatible AI assistants request that research through named tools. Use REST for code you control and MCP for a connected assistant's research workflow.

Which plan includes API and MCP access?

Any account can create a free MCP key, which reads the previous session's expected move, earnings moves, pulse, today's list, track record, quotes, price history and events. The live session, every other tool and the REST API require the Developer plan. Developer is $99 USD per month with monthly billing; yearly billing is also available. Developer Pro, at $249 USD per month, adds a websocket that pushes the readings live and a higher request ceiling. The public API reference and setup documentation can be read without an account.

Which AI clients can connect through MCP?

The developer console provides setup configurations for Claude Desktop, Claude Code, Cursor, VS Code. Other clients need Streamable HTTP support and a way to send the required authentication headers. Check the setup guide for your client's configuration.

Can the MCP server place trades or change my account?

No. The external MCP server exposes read-only research tools. It cannot place brokerage orders, change your account or create alerts. You decide how to use the research.

Is every response live, and can I redistribute the data?

Availability and freshness depend on the endpoint, symbol and dataset. Read the session dates and timestamps in the response; do not assume every reading is live. API access does not grant redistribution rights. Review the API reference and terms for the data you intend to use.

Put the next piece in place.

All features

Alerts

Keep an eye on the conditions that matter to you.

Options flow

Find unusual activity and understand what is behind it.

Insiders & Congress

Follow reported trades with the person, timing, and source in view.

Your next move

Make market intelligence part of your workflow.

Connect your application or AI assistant to the research with the Developer plan.

Get API & MCP access REST API and read-only MCP tools included.