UnusualWhales API

Agent Instructions

API requests use the base URL https://api.unusualwhales.com and require a bearer token in the Authorization header (Authorization: Bearer <API_KEY>). Create and manage API tokens at https://unusualwhales.com/dashboard/api. For live market data inside an AI tool, use the Unusual Whales MCP server at https://unusualwhales.com/public-api/mcp. Instructions for agents using Unusual Whales tools: https://unusualwhales.com/skill.md

UnusualWhales API

The official Unusual Whales API and MCP Server gives you 100+ endpoints for options flow, dark pool, congressional trading, Greek exposure, volatility, and more. Connect via REST, WebSocket, Kafka, or MCP.

<Card title="Authentication">
  `Bearer YOUR_API_KEY`
</Card>

Resources

<Card title="MCP Server" href="https://unusualwhales.com/public-api/mcp" icon={AI}> Connect to Claude & AI tools

<Card title="Check API Usage" href="https://unusualwhales.com/information/how-to-check-your-api-usage" icon={?}> Monitor your quota

<Card title="Fix 404 Errors" href="https://unusualwhales.com/information/how-to-fix-404-errors-when-using-ai-tools-with-the-unusual-whales-api" icon={!}> Troubleshoot AI tools

<Card title="SKILL.md" href="https://unusualwhales.com/skill.md" icon={MD}> For AIs/Agents working with the API

Historical Option Trades

Tip

Historical option trades data is available at $250 per month for the full market. For more than 1 year we offer 10% discount on the full price.

Download example parquet file

Enterprise / Professional

Note

Prospective Enterprise/Professional subscribers can email us for more information about redistribution licenses or custom solutions.

dev@unusualwhales.com