TraderDaddy Pro API

30 requests per minute per API key. Headers are returned with every response.

When the limit is exceeded the API returns HTTP 429. Check X-RateLimit-Reset for the Unix timestamp at which your quota resets.

Client configuration

New to this? Read the step-by-step setup walkthrough — where to find your key, one numbered path per app, and how to tell it worked.

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": {
      "type": "http",
      "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"
      ]
    }
  }
}

Browser-based clients (for example AI Chart Copilot, the extension that adds an AI side panel to TradingView charts) — there's no config file. In the client's MCP-server settings, add https://api.traderdaddy.pro/api/v1/mcp and authenticate with either a Authorization: Bearer td_live_… header or OAuth, if the client offers it. OAuth lets you paste your key once on our consent page instead of storing it in the client's settings.

Available tools

29 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, including a gamma-pocket flag when the name's dealer gamma diverges from the broad-market regime.

• get_apex_levels

  Composite “magnet” strike ranking (OI walls + net gamma) with the gamma-flip level.

• 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 ratio for a ticker from its nearest weekly expiration. Null when there is no call volume to divide by.

• 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 — is a ticker's premium rich or cheap vs its own history? Labelled with its source; percentile accompanies a self-tracked reading.

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

• get_hedge_analysis

  Ranked downside-protection structures for a share position you specify — collars, puts, and spreads priced off the live chain.

• get_institutional_activity

  Most actively-traded tickers by institutional options-flow volume today, with directional bias.

• get_directional_flow

  The session's cumulative (from-open) delta-weighted flow lean per underlying — cumΔ, conviction, and a bullish/bearish/balanced bias. Pass a symbol or get the top-15 leaderboard.

• get_dark_pool

  Rolled-up off-exchange (“dark pool”) equity BLOCK flow for a ticker: print count, gross and net notional, accumulation vs distribution split, largest print. Aggregates only, individual prints are not served. The lean is inferred, not confirmed direction — it describes months of desk positioning, so distribution means a patient seller (stalling/sideways), not a short signal.

• get_politician_trades

  Congressional / political stock-disclosure leaderboard — the “Power Players” most-active names.

• get_politician_trades_by_ticker

  Every congressional / political stock-disclosure trade for a single ticker.

• get_insider_trades

  Form 4 insider trades of $25k+ filed with the SEC over the past 90 days, market-wide or filtered to one ticker. `direction` defaults to buy; pass sell, other or all.

• get_short_interest

  Official FINRA short data for a ticker — bi-monthly short interest (days-to-cover, current short position) plus the latest daily Reg SHO short-volume ratio. Short activity is squeeze/positioning context, not a bearish signal.

• get_bounce_signals

  Bounce Finder screener — recently detected oversold-bounce candidates with scoring.

• get_bounce_score

  On-demand oversold-bounce composite score for a single ticker.

• get_premarket_gappers

  Warrior “5 pillars” momentum gap scan (gapping hard, has-news, low float, $1–$100, and a derived premarket relative volume — premarket shares as a fraction of a normal full day), runnable on the pre-market or after-hours tape.

• get_conviction

  Community Conviction gauge — a 0..100 blended read of how TD Pro traders are leaning on a ticker.

• get_market_health

  Market Health confluence — 7 macro-regime detectors (risk appetite, breadth, volatility) rolled into one read.

• get_long_term_quality

  Fundamental quality + dividend screener across the optionable universe for long-term names.

• get_dividend_calendar

  Upcoming ex-dividend calendar across the optionable universe with yields and pay dates.

• get_ipo_scanner

  IPO Scanner — the pipeline from pre-IPO chatter to freshly-listed names.

1. 1

   Create an account

   A free account is all you need. The API is billed on its own and does not require a trading subscription. Sign up

2. 2

   Subscribe to the API

   From your account, go to Settings → Developer tab and add the API add-on — $29.99/mo while you hold a TraderDaddy Pro subscription, $49.99/mo standalone.

3. 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. 4

   Start making requests

   Pass your key in the X-API-Key header. All endpoints return JSON. See the Endpoints Reference above for the full list.

What you get. Unusual-activity scores and tiers, GEX and apex levels, conviction, sector and directional flow rollups, screener and quality scores, IV rank, hedge rankings, and edge X-ray grades. This is our own work product, and your key licenses you to use it in your application.

What you won't get, by design. Raw option chains and per-contract bid/ask/greeks or per-strike IV, and third-party news article text or links. We license our market data from providers (including Tradier, Alpaca, and Finnhub) whose terms don't permit us to redistribute their raw rows, so we serve the layer we built on top instead. get_edge_xray returns rich/cheap and execution grades per contract rather than the quotes behind them — no bid/ask/mid, no per-contract IV or greeks, no open interest or volume; get_premarket_gappers returns a hasNews boolean rather than headline text. If you need a raw chain or a live quote feed, license one directly from a market-data vendor — that's the correct and cheaper path.

The one quote you do get is the underlying's. GET /ticker/:symbol and GET /ticker/:symbol/fundamentals include vendor-sourced price and company data for the symbol you asked about, so the analytics on that response have a price to sit against. That is a single-symbol lookup, not a feed: it stays covered by the no-resell rule below, and it is not a substitute for a market-data subscription if what you need is streaming quotes.

Build on it, don't resell it. Per the Terms (§7), don't resell, sublicense, or redistribute what this API returns as a data product of your own. Building a tool, dashboard, bot, or research workflow on top of it is exactly what it's for. The public-source exemption follows the source, not the subject: short interest and short volume come straight from FINRA's own published files and carry no restriction, but insider Form 4 activity and congressional disclosures reach you as third-party compilations of public filings — the filings are yours to pull from SEC EDGAR or the House/Senate disclosure sites, our rows are not.

Attribution (“Powered by TraderDaddy Pro”) is appreciated but not required. Got a use case that doesn't fit — a partnership, white-label, or bulk arrangement? Ask us. Some of it we can license; some of it isn't ours to license.