> ## Documentation Index
> Fetch the complete documentation index at: https://api.unusualwhales.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## 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.

<div className="code_cards">
  <Columns cols={2}>
    <Card title="Base URL">
      `https://api.unusualwhales.com`
    </Card>

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

## Resources

<Columns cols={2}>
  <Card title="Kafka Streaming" href="/docs/kafka" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40"><rect width="40" height="40" rx="10" fill="#FFEDD5"/><text x="20" y="27" fontFamily="Arial, sans-serif" fontSize="18" fontWeight="700" fill="#EA580C" textAnchor="middle">K</text></svg>}>
    Real-time data streaming
  </Card>

  <Card title="MCP Server" href="https://unusualwhales.com/public-api/mcp" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40"><rect width="40" height="40" rx="10" fill="#F3E8FF"/><text x="20" y="26" fontFamily="Arial, sans-serif" fontSize="14" fontWeight="700" fill="#9333EA" textAnchor="middle">AI</text></svg>}>
    Connect to Claude & AI tools
  </Card>

  <Card title="Check API Usage" href="https://unusualwhales.com/information/how-to-check-your-api-usage" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40"><rect width="40" height="40" rx="10" fill="#DBEAFE"/><text x="20" y="27" fontFamily="Arial, sans-serif" fontSize="18" fontWeight="700" fill="#2563EB" textAnchor="middle">?</text></svg>}>
    Monitor your quota
  </Card>

  <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={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40"><rect width="40" height="40" rx="10" fill="#FEE2E2"/><text x="20" y="27" fontFamily="Arial, sans-serif" fontSize="18" fontWeight="700" fill="#DC2626" textAnchor="middle">!</text></svg>}>
    Troubleshoot AI tools
  </Card>

  <Card title="SKILL.md" href="https://unusualwhales.com/skill.md" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40"><rect width="40" height="40" rx="10" fill="#DCFCE7"/><text x="20" y="26" fontFamily="Arial, sans-serif" fontSize="13" fontWeight="700" fill="#16A34A" textAnchor="middle">MD</text></svg>}>
    For AIs/Agents working with the API
  </Card>
</Columns>

## 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](https://storage.googleapis.com/uwassets/2025-12-05-option_trades.parquet)
</Tip>

## Enterprise / Professional

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

  [dev@unusualwhales.com](mailto:dev@unusualwhales.com)
</Note>