TraderDaddy Pro API
Access real-time institutional options flow, gamma exposure, sector analytics, and 15+ endpoints via a simple REST API. Build trading tools, alerts, and dashboards powered by the same data your subscribers see.
Quick Start
Authenticate with your API key and start fetching data in minutes.
Authentication
Pass your API key in the X-API-Key request header on every request.
GET https://api.traderdaddy.pro/api/v1/unusual-activity X-API-Key: td_live_your_key_here
Base URL
All endpoints are served over HTTPS. Include the versioned prefix on every request.
https://api.traderdaddy.pro/api/v1
curl -H "X-API-Key: td_live_your_key_here" \ "https://api.traderdaddy.pro/api/v1/unusual-activity?minScore=85&timeFrame=today"
Rate Limits
Rate limits are applied per API key to ensure fair access across all integrations.
30 requests per minute per API key. Headers are returned with every response.
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetWhen the limit is exceeded the API returns HTTP 429. Check X-RateLimit-Reset for the Unix timestamp at which your quota resets.
MCP Server
Connect TraderDaddy Pro directly to your AI assistant. Our Model Context Protocol (MCP) server lets Claude Desktop, Cursor, and Claude Code query live market data using your existing API key.
MCP Endpoint
A single streamable HTTP endpoint. Authenticate with the same td_live_ key you use for the REST API.
https://api.traderdaddy.pro/api/v1/mcp
Compatible Clients
Works with any MCP-capable client that supports remote servers with custom auth headers.
Client configuration
Cursor / Claude Code (remote server with headers) — add to Cursor's ~/.cursor/mcp.json or your Claude Code MCP config. Replace td_live_your_key_here with your own key. Auth is also accepted as an X-API-Key header.
{
"mcpServers": {
"traderdaddy-pro": {
"url": "https://api.traderdaddy.pro/api/v1/mcp",
"headers": {
"Authorization": "Bearer td_live_your_key_here"
}
}
}
}Claude Desktop — Claude Desktop can't connect to a remote HTTP MCP server directly, so bridge it with mcp-remote. Add this to claude_desktop_config.json (Node.js required):
{
"mcpServers": {
"traderdaddy-pro": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://api.traderdaddy.pro/api/v1/mcp",
"--header", "Authorization: Bearer td_live_your_key_here"
]
}
}
}Available tools
Nine read-only market-data tools your assistant can call.
- get_market_stats
Index put/call ratios, sentiment, and overall market health metrics.
- get_gex_overview
Gamma exposure across tracked symbols — flip points and key walls.
- get_gex_ticker
Gamma exposure analysis for any single ticker.
- get_unusual_activity
Real-time unusual options activity feed with scoring and sentiment.
- run_screener
Run a named screener and return matching tickers with scoring.
- get_sector_flow
Options flow aggregated by GICS sector ETF with sentiment breakdown.
- get_put_call_ratios
Put/call ratios for SPY, QQQ, IWM, and the broader CBOE index.
- get_earnings_flow
Pre-earnings unusual options positioning for tickers reporting soon.
- get_economic_calendar
Macroeconomic events — FOMC, CPI, NFP — with consensus estimates.
- get_iv_rank
Self-relative IV rank & percentile — is a ticker's premium rich or cheap vs its own history?
- get_strategy_ideas
Ranked, auto-assembled multi-leg option structures priced off the live chain.
- get_edge_xray
Whole-chain rich/cheap grade for one expiration, with optional trade-archetype lens.
td_live_ key and shares the same 30 requests per minute rate limit as the REST API — tool calls count against the same quota.Endpoints Reference
Click any endpoint to expand its parameters. All requests require the X-API-Key header.
Options Flow
Market Data
Gamma Exposure (GEX)
Sector Analysis
Signals & Scanners
Earnings & Events
Intelligence
Ticker Search
Long Term & Dividends
Error Handling
All errors return a JSON body with a consistent shape.
Error response format
{
"error": "Unauthorized",
"message": "API key is missing or invalid."
}HTTP status codes
Getting Started
Four steps from zero to live data.
- 1
Subscribe to Premium
API access requires an active Premium subscription ($34.99/mo). View pricing
- 2
Add Developer API access
From your account, go to Settings → Developer tab and add the API add-on ($29.99/mo).
- 3
Generate an API key
Once the add-on is active, click "Generate API Key" on the Developer tab. Keys are prefixed
td_live_. Store it securely — it will not be shown again. - 4
Start making requests
Pass your key in the
X-API-Keyheader. All endpoints return JSON. See the Endpoints Reference above for the full list.
Code Examples
Drop-in snippets for popular languages.
import requests
API_KEY = "td_live_your_key_here"
BASE_URL = "https://api.traderdaddy.pro/api/v1"
response = requests.get(
f"{BASE_URL}/unusual-activity",
headers={"X-API-Key": API_KEY},
params={"minScore": 85, "timeFrame": "today"}
)
data = response.json()
for flow in data["data"][:5]:
print(f"{flow['ticker']} {flow['sentiment']} ${flow['premium']:,.0f}")const API_KEY = "td_live_your_key_here";
const BASE_URL = "https://api.traderdaddy.pro/api/v1";
const response = await fetch(
`${BASE_URL}/unusual-activity?minScore=85&timeFrame=today`,
{ headers: { "X-API-Key": API_KEY } }
);
const { data } = await response.json();
data.slice(0, 5).forEach(flow => {
console.log(`${flow.ticker} ${flow.sentiment} $${flow.premium.toLocaleString()}`);
});curl -H "X-API-Key: td_live_your_key_here" \ "https://api.traderdaddy.pro/api/v1/unusual-activity?minScore=85&timeFrame=today"
Ready to build?
Add Developer API access from your account settings and start pulling live options flow data into your own tools.