Stock, Options Gamma & WallStreetBets Sentiment API
Unified REST v1 JSON endpoints and remote Model Context Protocol (MCP) server for WallStreetBets & Reddit crowd velocity, ranked support & resistance levels, put/call options gamma walls, 12-sector domino phases, cross-asset macro rates, AI silicon economics, RSI divergence scans, and Black-Scholes Greeks.
Try Live API in Browser & Instant Code Generator
Select any live endpoint and ticker below to execute a real HTTP request from your browser and generate copy-ready Python, TypeScript, cURL, or Claude/Cursor MCP snippets.
Click "Send Live Request" to execute GET /api/v1/quant/reddit-sentiment/?window=24h right in your browser...
3-Tier Developer Access & Rate Limits
Start immediately with zero key in the browser, claim a free developer key in 10 seconds, or scale to full-universe Pro + MCP.
Anonymous Sandbox
No Key Needed- Top-5 sample rows across Quant & Scanner REST endpoints
- Try live right in browser or terminal with zero signup
- Full access to
/openapi.json(OpenAPI 3.1) &/llms.txt - CORS-enabled public ticker & preview responses
Free Developer Key
10-Second Setup- Dedicated
X-Api-Key& JWT Bearer authentication - Top-15 rows + daily
24hReddit & WallStreetBets buzz - Nearest
S1 / R1support & resistance levels per ticker - Top-5 RSI(14) divergence signals & Black-Scholes Greeks calculator
Tradestie Pro API + MCP
Institutional Depth- Full US Stock & ETF Universe (100+ scanner signals, unclipped datasets)
- 7d & 30d Reddit Velocity + Institutional Confluence scoring
- Complete Ranked S/R Zones + Put/Call OI Gamma Walls, Max Pain & Net GEX
- All 12 Sector Domino Phases & 16 Supply-Chain Sub-Layers (
L1โL5,S1โS5,A1โA6) - Full Claude, Cursor & ChatGPT MCP Connector at
/apps/mcp/
API Catalogue
Authentication & Rate-Limit Headers
Stateless REST + Session CompatibleEvery Tradestie v1 endpoint supports two stateless authentication mechanisms for automated trading scripts, research notebooks, and server-side pipelines, alongside browser session cookies.
Method 1: Developer API Key (Recommended โ 10 Seconds)
Generate or rotate your 32-character hex key at /apps/api/keys/ and pass it either via the X-Api-Key request header (preferred so keys stay out of server URL logs) or the ?apikey= query parameter.
# Preferred: HTTP Header
curl -sS -H "X-Api-Key: YOUR_API_KEY" \
"https://tradestie.com/api/v1/quant/levels/NVDA/"
# Alternative: Query Parameter (convenient for spreadsheets & webhooks)
curl -sS "https://tradestie.com/api/v1/quant/reddit-sentiment/?window=24h&apikey=YOUR_API_KEY"
Method 2: JWT Bearer Token (Backward Compatible)
Obtain a stateless JWT access token via POST /api/auth/login/ (refresh via POST /api/auth/refresh/) and pass Authorization: Bearer <TOKEN>. OAuth users can set an API password anytime via password reset.
# 1. Exchange credentials for JWT token pair (refresh via POST /api/auth/refresh/)
curl -X POST https://tradestie.com/api/auth/login/ \
-H "Content-Type: application/json" \
-d '{"username": "[email protected]", "password": "YOUR_PASSWORD"}'
# 2. Authenticate requests with Authorization: Bearer <TOKEN>
curl -sS -H "Authorization: Bearer YOUR_JWT_ACCESS_TOKEN" \
"https://tradestie.com/apps/scanner/api/v1/rsi-divergence/?format=json"
Standard Response Headers & Tier Envelope
| Header / JSON Key | Example | Description |
|---|---|---|
X-Tradestie-Tier | anonymous | free | pro | Resolved caller tier based on API key, JWT token, or session. |
X-Tradestie-RateLimit | 10/m ยท 30/m ยท 300/m | Per-minute request ceiling for the resolved tier (paired with X-Tradestie-Tier). |
pro_locked_fields | ["gamma_walls", "net_gex"] | Present on Anonymous/Free responses to indicate institutional fields unlocked by Pro. |
HTTP 429 | {"error": "Rate limit exceeded..."} | Returned as structured JSON (never an HTML error page) with direct upgrade instructions. |
1. Reddit & WallStreetBets Crowd Velocity + Institutional Confluence API
Pack 1 ยท LIVE
Tracks real-time retail mention velocity, bullish/bearish crowd polarity across r/WallStreetBets and equity communities, and cross-checks crowd surges against institutional technical & options alignment.
Legacy endpoints /api/v1/apps/reddit, /v1/apps/reddit, and /apps/reddit/api/ remain fully active for existing integrations.
| Parameter | Type | Required | Description |
|---|---|---|---|
window | string | No | Lookback window: 24h (default, all tiers), 7d (Pro), or 30d (Pro). |
ticker | string | No | Optional single-ticker filter (e.g. NVDA, TSLA, GME; symbol also supported as alias). |
limit | integer | No | Max rows returned (capped by tier: 5 Anonymous, 15 Free, Full Universe Pro). |
24h comment count ยท Net sentiment polarity (BULLISH / BEARISH) & sentiment score.7d & 30d mention velocity z-scores ยท Institutional Confluence alignment ยท Crowd trap vs smart-money confirmation flags.2. Unified Support, Resistance & Options Gamma/OI Walls API
Pack 2 ยท LIVEFuses multi-timeframe structural price pivots, volume-at-price shelves, moving-average clusters, and options open-interest Put/Call Gamma Walls into ranked actionable levels for any US equity or ETF.
| Parameter | Type | Required | Description |
|---|---|---|---|
SYMBOL (path) | string | Yes | Uppercase ticker symbol such as NVDA, SPY, GOOGL, SMH, or MU. |
spot (query) | float | No | Optional pre-market/post-gap spot override to re-center support & resistance ladder. |
S1) and primary resistance (R1) level with percentage distance.S1โS4 / R1โR4 confluence zones ยท Call Wall & Put Wall strikes ยท Max Pain ยท Expected Move band ยท Net Gamma Exposure (GEX) regime.3. 12-Sector Domino Phase & 3-Stack Supply-Chain Dispersion API
Pack 3 ยท LIVE
Detects stealth breadth fractures beneath calm sector ETFs across all 12 market sectors (Phase 1: Healthy Participation through Phase 4: Capitulation Washout) and maps upstream-to-downstream lead/lag across Industrial Buildout (L1โL5), Semiconductor Compute (S1โS5), and AI/SaaS (A1โA6).
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | No | Ticker or sector ETF (e.g. NVDA, SMH, XLK). Omit for the macro sector summary. |
0โ100) ยท Stealth Top & Overbought Holdout risk flags ยท All 16 value-chain sub-layers ยท First-In First-Out (FIFO) recovery leaders.4. 10Y Real/Nominal Yield & 5-Pillar Cross-Asset Regime API
Pack 4 ยท LIVEDelivers 10-Year nominal Treasury yields, TIPS real yields, breakeven inflation, yield-curve slope, and Tradestie's 5-pillar cross-asset risk regime for systematic position sizing and duration hedging.
5. AI GPU Rental, LLM Token Pricing & Silicon Economics Dataset API
Pack 5 ยท LIVEPhysical-layer AI infrastructure telemetry tracking datacenter GPU spot/on-demand hourly rental curves (B200, H200, H100, MI300X), frontier LLM per-million token inference pricing, and leading-edge wafer/CoWoS unit economics.
6. RSI(14) & Technical Divergence Scanner API
Pack 6 ยท LIVE
Returns US equities printing confirmed Bullish or Bearish 14-period RSI price-momentum divergences during the active market session, sorted by signal strength. Also accessible via shorthand alias /v1/scanner/rsi-divergence.
| Field | Type | Description |
|---|---|---|
format (query) | string | Pass ?format=json when calling from a browser so JSON is returned instead of HTML. |
symbol | string | Equity ticker symbol (e.g., NVDA). |
strength | integer | Divergence signal confidence score (0โ100). |
direction | string | BULLISH or BEARISH divergence classification. |
rsi / rsi_zone | float / string | Current 14-period RSI reading and zone (oversold, neutral, overbought). |
{
"success": true,
"count": 5,
"access_level": "free",
"results": [
{
"symbol": "NVDA",
"price": 135.40,
"change_pct": 2.15,
"strength": 92,
"direction": "BULLISH",
"rsi": 32.5,
"rsi_zone": "oversold"
}
]
}
7. Options Pricing API (Black-Scholes & Multi-Leg Payoffs)
Pack 7 ยท LIVE
European Black-Scholes option valuation, complete first-order Greeks (Delta, Gamma, Theta, Vega, Rho), Newton-Raphson implied volatility solver, and multi-leg strategy payoff & theta decay curves. Both /apps/options-dashboard/api/options/bs/* and shorthand /v1/options/* routes are supported.
10 Pre-Built Multi-Leg Strategy Templates
long_call
long_put
covered_call
cash_secured_put
bull_call_spread
bear_put_spread
straddle
strangle
iron_condor
butterfly
7a. Price Single Option & Greeks
Alias: POST /v1/options/price
| Field | Type | Required | Description |
|---|---|---|---|
type | string | Yes | "call" or "put" |
stock_price | float | Yes | Underlying spot price (> 0) |
strike | float | Yes | Option strike price (> 0) |
days_to_expiry | float | Yes | Calendar days until expiration |
volatility | float | Yes | Annualized implied volatility decimal (0.25 = 25%) |
risk_free_rate | float | No | Annualized risk-free rate decimal (default 0.05) |
curl -X POST https://tradestie.com/apps/options-dashboard/api/options/bs/price/ \
-H "Content-Type: application/json" \
-d '{"type":"call","stock_price":100,"strike":105,"days_to_expiry":30,"volatility":0.25}'
7b. Price Multi-Leg Strategy
Compute net debit/credit, max profit, max loss, breakeven points, aggregate portfolio Greeks, and expiration payoff curve using either template + strikes or custom legs. Alias: POST /v1/options/strategy.
curl -X POST https://tradestie.com/apps/options-dashboard/api/options/bs/strategy/ \
-H "Content-Type: application/json" \
-d '{"stock_price":100,"days_to_expiry":30,"volatility":0.25,"template":"iron_condor","strikes":[90,95,105,110]}'
7c. Calculate Implied Volatility (IV Solver)
Solves annualized implied volatility from observed option midpoint price. Alias: POST /v1/options/iv.
curl -X POST https://tradestie.com/apps/options-dashboard/api/options/bs/iv/ \
-H "Content-Type: application/json" \
-d '{"type":"call","stock_price":100,"strike":100,"days_to_expiry":30,"market_price":5.0}'
7d. Multi-Horizon Time Decay Analysis
Simulates strategy value across custom time_points from entry to expiration. Alias: POST /v1/options/time-decay.
curl -X POST https://tradestie.com/apps/options-dashboard/api/options/bs/time-decay/ \
-H "Content-Type: application/json" \
-d '{"stock_price":100,"days_to_expiry":30,"volatility":0.25,"legs":[{"type":"call","strike":100,"action":"buy","quantity":1}],"time_points":[0,7,14,21,30]}'
AI Agent Discovery, OpenAPI 3.1 & Financial MCP Server
Agent-NativeConnect Claude Desktop, Claude Code CLI, Cursor, Windsurf, or custom LangChain / OpenAI SDK agents directly to Tradestie's live market intelligence without writing boilerplate HTTP wrappers.
| Spec / Endpoint | Format | Purpose |
|---|---|---|
GET /openapi.json | OpenAPI 3.1 JSON | Machine-validated schema for SDK generation, Postman/Insomnia import, and GPT Actions. |
GET /llms.txt | Markdown / Plaintext | Concise index of Tradestie quantitative APIs, tools, and research routes for LLM crawlers. |
/apps/mcp/ | MCP Remote SSE | Interactive MCP pack manager & 1-line setup for Claude Desktop, Claude Code, and Cursor. |
# 1-Line Claude Code CLI registration
claude mcp add tradestie --transport sse "https://tradestie.com/mcp/sse?api_key=YOUR_MCP_KEY"
# Claude Desktop (claude_desktop_config.json) or Cursor (.cursor/mcp.json)
{
"mcpServers": {
"tradestie": {
"url": "https://tradestie.com/mcp/sse?api_key=YOUR_MCP_KEY"
}
}
}
Frequently Asked Questions
How do I authenticate with the Tradestie WallStreetBets & Options Gamma API?
Pass your developer key in the X-Api-Key HTTP header or ?apikey= query parameter (generated in 10 seconds at /apps/api/keys/), or authenticate with a JWT Bearer token via Authorization: Bearer <TOKEN> obtained from POST /api/auth/login/ (and refreshed via POST /api/auth/refresh/).
Can I test the Reddit Stock Sentiment and Support/Resistance APIs without an API key?
Yes. Anonymous requests receive 10 req/min with top-5 sample rows right in the browser sandbox above or via cURL. Registering a free developer key increases throughput to 30 req/min and top-15 rows, while Tradestie Pro unlocks 300 req/min, full universe depth, options gamma walls, and MCP access.
Does Tradestie offer a Financial MCP Server for Claude Desktop, Claude Code, and Cursor?
Yes. Tradestie hosts a remote SSE Model Context Protocol (MCP) server at /apps/mcp/ alongside machine-readable /openapi.json (OpenAPI 3.1) and /llms.txt specs so Claude, Cursor, and autonomous research agents can query live options gamma walls, support/resistance levels, Reddit crowd velocity, and sector domino phases.
Is the legacy /api/v1/apps/reddit WallStreetBets API endpoint still supported?
Yes. Both /api/v1/apps/reddit and /v1/apps/reddit remain fully supported for backward compatibility, while /api/v1/quant/reddit-sentiment/?window=24h adds multi-window (24h, 7d, 30d) mention velocity and Institutional Confluence enrichment.