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

# Errors

Codes returned in the `code` field of an error response, what they mean, and how to resolve them.

| Code | Meaning | Scope | What to do |
| - | - | - | - |
| `advanced_tier_required` | The endpoint needs the Advanced tier | Plan | Upgrade to Advanced |
| `futures_access_required` | Futures access is not on this key | Plan | Advanced tier, or the futures data add-on |
| `*_scope_required` | Behind an exchange data license we are finalizing | Global | Not a purchase; access returns once the license is in place |
| `historic_data_access_missing` | Requested date is older than your plan's lookback | Plan | Use a more recent date, or the Data Shop for older history |
| `historical_data_not_supported` | Endpoint serves the latest trading day only | Endpoint | Use the full-tape or history endpoint for older data |
| `401` | No token reached us | Request | Send `Authorization: Bearer YOUR_API_KEY`; the key itself is usually fine |
| `404` | Route does not exist | Request | Check the path against the endpoint list; guessed route names 404 |