{"openapi":"3.1.0","jsonSchemaDialect":"https://spec.openapis.org/oas/3.1/dialect/base","info":{"title":"Tradestie Quantitative Market, Options Gamma & Retail Sentiment API","version":"1.1.0","summary":"Sub-50ms quantitative equity levels, dealer gamma walls, 12-sector domino cascades, Treasury real-yield regimes, AI silicon economics, and verified Reddit sentiment.","description":"Unified 3-tier REST v1 API by Tradestie.\n\n- **Anonymous Tier (`10 req/min`)**: Zero-friction evaluation directly from browser, curl, or AI agents.\n- **Free Registered Key (`30 req/min`)**: Generate an instant key at `https://tradestie.com/apps/api/keys/`.\n- **Tradestie Pro (`300 req/min`)**: Full institutional confluence ladders, dealer GEX/OI walls, 12-sector + 16-sublayer Domino Radar, 2-year macro yield curves, semiconductor/hyperscaler beneficiaries, and Claude/Cursor MCP Server access (`https://tradestie.com/pricing/`).","termsOfService":"https://tradestie.com/terms-of-service/","contact":{"name":"Tradestie Quantitative Developer Portal","url":"https://tradestie.com/apps/scanner/developers/"}},"servers":[{"url":"https://tradestie.com","description":"Tradestie Production API Server"}],"security":[{},{"ApiKeyHeader":[]},{"ApiKeyQuery":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Tradestie API Key (`30/m` Free or `300/m` Pro). Generate at https://tradestie.com/apps/api/keys/"},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"apikey","description":"Tradestie API Key passed via `?apikey=` query string."},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Tradestie JWT Bearer authentication token."}},"schemas":{"RateLimitError":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string","enum":["anonymous","free","pro"]},"rate_limit":{"type":"string"},"solution":{"type":"string"},"get_free_key_url":{"type":"string","format":"uri"},"upgrade_to_pro_url":{"type":"string","format":"uri"},"docs":{"type":"string","format":"uri"}},"required":["error","tier","solution"]},"OptionLegInput":{"type":"object","properties":{"type":{"type":"string","enum":["call","put"]},"action":{"type":"string","enum":["buy","sell"],"default":"buy"},"strike":{"type":"number"},"quantity":{"type":"integer","default":1},"days_to_expiry":{"type":"number"},"volatility":{"type":"number"}},"required":["type","strike"]}}},"paths":{"/api/v1/quant/reddit-sentiment/":{"get":{"operationId":"getQuantRedditSentiment","tags":["Quant v1"],"summary":"Verified Retail Crowd Sentiment, Velocity & Options Wall Confluence","description":"Returns verified US equity Reddit sentiment. Anonymous returns up to 5 (24h); Free Key returns up to 15 with velocity & price; Pro unlocks 24h/7d/30d windows, up to 30 stocks, confluence regimes, put/call walls, 7d sparklines, and 14d history.","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["24h","7d","30d"],"default":"24h"},"description":"Aggregation window (`7d` and `30d` require Tradestie Pro)."},{"name":"ticker","in":"query","required":false,"schema":{"type":"string"},"description":"Optional US stock or ETF ticker filter (e.g. `NVDA`)."},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Optional alias for `ticker` (e.g. `NVDA`)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":30},"description":"Optional row count clamped to `[1, tier_max]` (`5` Anonymous, `15` Free, `30` Pro)."}],"responses":{"200":{"description":"Tier-shaped JSON payload (Anonymous / Free Key / Tradestie Pro).","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit exceeded with actionable Free Key / Pro upgrade links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}}},"/api/v1/quant/levels/{symbol}/":{"get":{"operationId":"getQuantSupportResistanceLevels","tags":["Quant v1"],"summary":"Unified Support, Resistance & Options Gamma/OI Walls Engine","description":"Multi-factor institutional support/resistance clusters combining technicals, volume profile shelves, Fibonacci retracements, and dealer option gamma/OI walls. Free/Anon returns spot, volatility, and #1 nearest floor/ceiling; Pro unlocks full ladders, put/call OI walls, net GEX, moving averages, and Sector Domino gate.","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"US stock or ETF ticker symbol (e.g. `NVDA`, `SPY`, `TSLA`)."},{"name":"spot","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1000000},"description":"Optional live or post-gap spot price override (`> 0` and `< 1e6`) to dynamically re-anchor support/resistance ladders."}],"responses":{"200":{"description":"Tier-shaped JSON payload (Anonymous / Free Key / Tradestie Pro).","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit exceeded with actionable Free Key / Pro upgrade links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"400":{"description":"Invalid symbol or spot query parameter."},"404":{"description":"Unknown ticker or insufficient market history."}}}},"/api/v1/quant/sector-domino/":{"get":{"operationId":"getQuantSectorDomino","tags":["Quant v1"],"summary":"12-Sector Domino Cascade & 3-Stack (16-Sublayer) Dispersion Radar","description":"Detects stealth institutional sector tops, constituent casualty breadth, holdout air-pockets, and capitulation washouts across 12 US sectors and 16 value-chain sub-layers (`L1-L5`, `S1-S5`, `A1-A6`).","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Optional ticker for single-stock Domino phase, buy-gate & trailing-stop context."}],"responses":{"200":{"description":"Tier-shaped JSON payload (Anonymous / Free Key / Tradestie Pro).","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit exceeded with actionable Free Key / Pro upgrade links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}}},"/api/v1/quant/macro-rates/":{"get":{"operationId":"getQuantMacroRates","tags":["Quant v1"],"summary":"10Y Nominal/Real Treasury Yield & 5-Pillar Cross-Asset Regime","description":"T+0 bond-implied 10Y Treasury nominal & real yields, deterministic 4-regime macro classifier, 5 cross-asset tape pillars, credit OAS spreads, and 2-year daily yield history.","responses":{"200":{"description":"Tier-shaped JSON payload (Anonymous / Free Key / Tradestie Pro).","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit exceeded with actionable Free Key / Pro upgrade links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}}},"/api/v1/quant/ai-compute-index/":{"get":{"operationId":"getQuantAiComputeIndex","tags":["Quant v1"],"summary":"AI GPU Spot Rental ($/GPU-hr), LLM Token Deflation & Silicon Economics Index","description":"Tracks cloud cluster GPU rental rates (B200, H200, H100 SXM, A100, RTX 5090), Frontier vs Open-Weight LLM token pricing ($/1M tokens), neocloud credit spreads, and Physical Silicon vs AI Application equity rotation.","responses":{"200":{"description":"Tier-shaped JSON payload (Anonymous / Free Key / Tradestie Pro).","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit exceeded with actionable Free Key / Pro upgrade links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}}},"/api/v1/apps/reddit":{"get":{"operationId":"getLegacyRedditWsbsentiment","tags":["Retail Sentiment"],"summary":"Daily Top 50 WallStreetBets Stock Mentions & Sentiment","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string"},"description":"Optional historical snapshot date (`YYYY-MM-DD` or `MM-DD-YYYY`)."}],"responses":{"200":{"description":"Tier-shaped JSON payload (Anonymous / Free Key / Tradestie Pro).","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit exceeded with actionable Free Key / Pro upgrade links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}}},"/apps/scanner/api/v1/rsi-divergence/":{"get":{"operationId":"getScannerRsiDivergence","tags":["Technical Scanners"],"summary":"Bullish & Bearish RSI Divergence Stock Scanner","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","html"],"default":"json"}}],"responses":{"200":{"description":"Tier-shaped JSON payload (Anonymous / Free Key / Tradestie Pro).","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit exceeded with actionable Free Key / Pro upgrade links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}}},"/v1/options/":{"get":{"operationId":"getOptionsApiInfo","tags":["Options Pricing"],"summary":"Black-Scholes Options Pricing & Strategy Templates Discovery","description":"Lists supported Black-Scholes endpoints and strategy templates (also available under `/apps/options-dashboard/api/options/bs/*`).","responses":{"200":{"description":"Options API capabilities and supported multi-leg strategy templates.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/options/price":{"post":{"operationId":"postOptionsPriceSingle","tags":["Options Pricing"],"summary":"Price a Single Call/Put Option & Full Greeks (Delta, Gamma, Theta, Vega, Rho)","description":"Black-Scholes single-option valuation and Greeks (alias: `/apps/options-dashboard/api/options/bs/price/`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["call","put"]},"stock_price":{"type":"number"},"strike":{"type":"number"},"days_to_expiry":{"type":"number"},"volatility":{"type":"number"},"risk_free_rate":{"type":"number","default":0.045}},"required":["type","stock_price","strike","days_to_expiry","volatility"]}}}},"responses":{"200":{"description":"Theoretical option price, intrinsic/extrinsic split, and Greeks.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/options/strategy":{"post":{"operationId":"postOptionsPriceStrategy","tags":["Options Pricing"],"summary":"Price Multi-Leg Option Spreads, Net Greeks & Breakeven Curve","description":"Prices multi-leg option strategies via explicit `legs` array or named `template` + `strikes` (e.g. `bull_call_spread`, `bear_put_spread`, `iron_condor`, `straddle`, `strangle`, `butterfly`). Also mounted at `/apps/options-dashboard/api/options/bs/*` (`/apps/options-dashboard/api/options/bs/strategy/`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stock_price":{"type":"number"},"days_to_expiry":{"type":"number"},"volatility":{"type":"number"},"risk_free_rate":{"type":"number","default":0.045},"template":{"type":"string","enum":["long_call","long_put","covered_call","cash_secured_put","bull_call_spread","bear_put_spread","straddle","strangle","butterfly","iron_condor"]},"strikes":{"type":"array","items":{"type":"number"}},"legs":{"type":"array","items":{"$ref":"#/components/schemas/OptionLegInput"}}},"required":["stock_price","days_to_expiry","volatility"]}}}},"responses":{"200":{"description":"Net debit/credit, aggregate Greeks, max profit/loss, and payoff curve.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/options/iv":{"post":{"operationId":"postOptionsImpliedVolatility","tags":["Options Pricing"],"summary":"Solve Implied Volatility from Market Option Price","description":"Newton-Raphson / Brent implied volatility solver (alias: `/apps/options-dashboard/api/options/bs/iv/`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["call","put"]},"stock_price":{"type":"number"},"strike":{"type":"number"},"days_to_expiry":{"type":"number"},"market_price":{"type":"number"},"risk_free_rate":{"type":"number","default":0.045}},"required":["type","stock_price","strike","days_to_expiry","market_price"]}}}},"responses":{"200":{"description":"Annualized implied volatility solution.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/options/time-decay":{"post":{"operationId":"postOptionsTimeDecay","tags":["Options Pricing"],"summary":"Simulate Multi-Day Theta Decay Schedule Across Expiration Horizon","description":"Projects multi-leg payoff and theta across expiration checkpoints (alias: `/apps/options-dashboard/api/options/bs/time-decay/`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stock_price":{"type":"number"},"days_to_expiry":{"type":"number"},"volatility":{"type":"number"},"risk_free_rate":{"type":"number","default":0.045},"legs":{"type":"array","items":{"$ref":"#/components/schemas/OptionLegInput"}},"time_points":{"type":"array","items":{"type":"number"}}},"required":["stock_price","days_to_expiry","volatility","legs"]}}}},"responses":{"200":{"description":"Projected strategy value and theta curve across DTE checkpoints.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}