{"openapi":"3.1.0","info":{"title":"Rallies API","version":"1.0.0","description":"Behavioral market-intelligence APIs for retail intent, connected portfolio positioning, AI fund activity, SEC filings, and financial metrics."},"servers":[{"url":"https://api.rallies.ai/v1","description":"Production"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Retail Intent"},{"name":"Retail Positioning"},{"name":"AI Funds"},{"name":"Filings"},{"name":"Miscellaneous"}],"paths":{"/retail/intent/ask":{"post":{"tags":["Retail Intent"],"summary":"Ask a question over retail investor conversation signals","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetailAskRequest"},"example":{"question":"What are retail investors asking about Nvidia earnings?","tickers":["NVDA"],"days":7,"limit":20,"stream":false}}}},"responses":{"200":{"description":"Answer with supporting retail intent evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetailAskResponse"},"example":{"answer":"Retail investors are focused on Nvidia earnings quality, AI data-center demand, and whether valuation leaves room for upside.","related_tickers":[{"ticker":"NVDA","conversation_share_pct":100},{"ticker":"AMD","conversation_share_pct":22.5}],"themes":[{"label":"Earnings Setup","description":"Questions cluster around whether to buy, trim, or wait before the earnings print.","sentiment":"mixed"}],"insights":[{"title":"Attention is event-driven","detail":"Matched conversations are tied to earnings timing and forward guidance rather than long-term thesis building."}]}},"text/event-stream":{"schema":{"type":"string"}}}}}}},"/retail/intent/questions":{"get":{"tags":["Retail Intent"],"summary":"List aggregated question themes","parameters":[{"$ref":"#/components/parameters/Ticker"},{"$ref":"#/components/parameters/Topic"},{"$ref":"#/components/parameters/Sentiment"},{"$ref":"#/components/parameters/Days"},{"$ref":"#/components/parameters/Limit50"}],"responses":{"200":{"description":"Aggregated question themes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionThemesResponse"},"example":{"themes":[{"rank":1,"label":"Portfolio Allocation","question_share_pct":17.29,"sentiment":"neutral","sentiment_breakdown_pct":{"bullish":27.27,"mixed":18.18,"neutral":54.55},"related_tickers":[{"ticker":"GOOGL","question_share_pct":40},{"ticker":"MSFT","question_share_pct":35},{"ticker":"AVGO","question_share_pct":33.33}],"related_topics":[{"label":"AI Capex","question_share_pct":46.67},{"label":"Earnings Season","question_share_pct":25}]}]}}}}}}},"/retail/intent/topics":{"get":{"tags":["Retail Intent"],"summary":"List non-ticker topics retail investors are discussing","parameters":[{"$ref":"#/components/parameters/Ticker"},{"$ref":"#/components/parameters/Topic"},{"$ref":"#/components/parameters/Sentiment"},{"$ref":"#/components/parameters/Days"},{"$ref":"#/components/parameters/Limit50"}],"responses":{"200":{"description":"Aggregated retail topics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetailTopicsResponse"},"example":{"topics":[{"rank":1,"label":"Rate Cuts","conversation_share_pct":18.44,"sentiment":"mixed","sentiment_breakdown_pct":{"bullish":25,"bearish":20,"mixed":45,"neutral":10},"related_tickers":[{"ticker":"TLT","conversation_share_pct":34.62},{"ticker":"SPY","conversation_share_pct":26.92}],"related_themes":[{"label":"Macro Setup","conversation_share_pct":42.31},{"label":"Portfolio Risk","conversation_share_pct":19.23}]}]}}}}}}},"/retail/intent/movers":{"get":{"tags":["Retail Intent"],"summary":"Rank fast-moving retail attention by ticker, topic, or theme","parameters":[{"name":"dimension","in":"query","schema":{"type":"string","enum":["ticker","topic","theme"],"default":"ticker"}},{"$ref":"#/components/parameters/Days"},{"$ref":"#/components/parameters/BaselineDays"},{"$ref":"#/components/parameters/Sentiment"},{"$ref":"#/components/parameters/Limit100"}],"responses":{"200":{"description":"Retail intent movers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetailMoversResponse"},"example":{"movers":[{"rank":1,"dimension":"ticker","value":"NVDA","label":"NVDA","conversation_share_pct":11.2,"previous_share_pct":4.8,"change_pct":133.33,"trend":"surging","sentiment":"mixed","sentiment_breakdown_pct":{"bullish":38.46,"bearish":15.38,"mixed":34.62,"neutral":11.54}}]}}}}}}},"/retail/tickers/{ticker}":{"get":{"tags":["Retail Intent","Retail Positioning"],"summary":"Snapshot for one ticker","parameters":[{"$ref":"#/components/parameters/TickerPath"}],"responses":{"200":{"description":"Retail attention, positioning, and flow snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerSnapshotResponse"},"example":{"ticker":"NVDA","retail_interest":{"conversation_share_pct":8.42,"related_tickers":[{"ticker":"AMD","overlap_share_pct":18.75},{"ticker":"AVGO","overlap_share_pct":12.5}]},"positioning":{"snapshot_at":"2026-05-25 00:00:00","asset_class":"stock","ownership_share_pct":7.91,"market_value_usd":1842500.18,"portfolio_value_share_pct":3.44,"avg_position_market_value":8420.66,"avg_current_price":126.88,"open_pnl_usd":212450.44,"unrealized_return_pct":13.04},"flows":{"window_days":7,"active_trader_share_pct":4.68,"buy_trade_share_pct":62.5,"sell_trade_share_pct":37.5,"buy_value_usd":284500.12,"sell_value_usd":112900.44,"net_flow_value_usd":171599.68,"gross_flow_value_usd":397400.56,"net_flow_pct":43.18,"net_flow_pct_of_position_value":9.31,"flow_bias":"net_buying","latest_trade_at":"2026-05-25T10:38:44Z"}}}}}}}},"/screener":{"post":{"tags":["Miscellaneous"],"summary":"Run a natural-language stock screen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenerRequest"},"example":{"query":"Find profitable AI infrastructure stocks with strong revenue growth","limit":10}}}},"responses":{"200":{"description":"Ticker candidates with concise explanations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenerResponse"},"example":{"tickers":[{"ticker":"NVDA","explanation":"NVDA matches because it is a leading AI accelerator supplier with large data-center revenue exposure and strong recent growth."},{"ticker":"AMD","explanation":"AMD matches because it is scaling AI accelerator revenue while remaining tied to broader data-center compute demand."},{"ticker":"ANET","explanation":"ANET matches because high-speed cloud networking demand benefits from AI cluster buildouts."}]}}}}}}},"/retail/positioning/holdings":{"get":{"tags":["Retail Positioning"],"summary":"Aggregated current retail holdings","parameters":[{"name":"snapshot_date","in":"query","schema":{"type":"string","format":"date"}},{"$ref":"#/components/parameters/AssetClasses"},{"name":"min_market_value","in":"query","schema":{"type":"number","default":500}},{"name":"min_holders","in":"query","schema":{"type":"integer","default":3}},{"$ref":"#/components/parameters/Limit250"}],"responses":{"200":{"description":"Aggregated holdings without absolute user counts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositioningResponse"},"example":{"snapshot_at":"2026-05-25 00:00:00","positions":[{"ticker":"NVDA","asset_class":"stock","ownership_share_pct":7.91,"market_value_usd":1842500.18,"avg_entry_price":112.28,"avg_current_price":126.88,"open_pnl_usd":212450.44,"unrealized_return_pct":13.04}]}}}}}}},"/retail/positioning/flows":{"get":{"tags":["Retail Positioning"],"summary":"Aggregated portfolio flow by ticker","parameters":[{"$ref":"#/components/parameters/LookbackDays"},{"$ref":"#/components/parameters/Ticker"},{"$ref":"#/components/parameters/AssetClasses"},{"name":"min_trade_value","in":"query","schema":{"type":"number","default":500}},{"name":"min_unique_traders","in":"query","schema":{"type":"integer","default":3}},{"$ref":"#/components/parameters/Limit250"}],"responses":{"200":{"description":"Aggregated flow signals without absolute trader counts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowsResponse"},"example":{"flows":[{"ticker":"NVDA","asset_class":"stock","active_trader_share_pct":5.12,"buy_trade_share_pct":64.71,"sell_trade_share_pct":35.29,"buy_value_usd":922500.48,"sell_value_usd":506200.14,"net_flow_value_usd":416300.34,"gross_flow_value_usd":1428700.62,"net_flow_pct":29.14,"flow_bias":"net_buying","latest_trade_at":"2026-05-25T10:38:44Z"}]}}}}}}},"/retail/positioning/rotation":{"get":{"tags":["Retail Positioning"],"summary":"Ticker and asset-class rotation from connected portfolios","parameters":[{"$ref":"#/components/parameters/LookbackDays"},{"$ref":"#/components/parameters/AssetClasses"},{"name":"min_market_value","in":"query","schema":{"type":"number","default":500}},{"name":"min_holders","in":"query","schema":{"type":"integer","default":3}},{"$ref":"#/components/parameters/Limit250"}],"responses":{"200":{"description":"Portfolio rotation signals.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotationResponse"},"example":{"current_snapshot_at":"2026-05-25 00:00:00","previous_snapshot_at":"2026-05-18 00:00:00","rotations":[{"ticker":"NVDA","asset_class":"stock","direction":"increasing_exposure","ownership_share_pct":7.91,"ownership_share_change_pct":1.07,"portfolio_value_share_pct":3.44,"portfolio_value_share_change_pct":0.53,"unrealized_return_pct":13.04}]}}}}}}},"/retail/options/flows":{"get":{"tags":["Retail Positioning"],"summary":"Options flow by underlying","parameters":[{"$ref":"#/components/parameters/LookbackDays"},{"name":"underlying","in":"query","schema":{"type":"string","example":"NVDA"}},{"name":"min_trade_value","in":"query","schema":{"type":"number","default":0}},{"name":"min_unique_traders","in":"query","schema":{"type":"integer","default":3}},{"$ref":"#/components/parameters/Limit250"}],"responses":{"200":{"description":"Aggregated options flow.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionsFlowsResponse"},"example":{"flows":[{"underlying":"NVDA","active_trader_share_pct":3.76,"call_share_pct":64.29,"opening_share_pct":71.43,"short_dated_share_pct":42.86,"buy_premium_usd":182400.22,"sell_premium_usd":90450.1,"net_premium_usd":91950.12,"gross_premium_usd":272850.32,"net_premium_pct":33.7,"premium_bias":"net_buying","latest_trade_at":"2026-05-25T10:12:08Z"}]}}}}}}},"/aifunds/trades":{"get":{"tags":["AI Funds"],"summary":"List AI fund trades","parameters":[{"$ref":"#/components/parameters/AIFundSource"},{"$ref":"#/components/parameters/Ticker"},{"name":"action","in":"query","schema":{"type":"string","enum":["all","buy","sell","hold"],"default":"all"}},{"name":"include_holds","in":"query","schema":{"type":"boolean","default":false}},{"$ref":"#/components/parameters/LookbackDays"},{"$ref":"#/components/parameters/Limit250"}],"responses":{"200":{"description":"AI fund trades.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIFundTradesResponse"},"example":{"trades":[{"fund":{"id":"ai_growth_01","name":"AI Growth Alpha","strategy":"growth"},"ticker":"NVDA","side":"buy","asset_class":"stock","price":126.88,"notional_value_usd":1268.8,"realized_return_pct":0,"thesis":"The fund added exposure after stronger AI infrastructure demand.","executed_at":"2026-05-25T10:42:00Z"}]}}}}}}},"/aifunds/positions":{"get":{"tags":["AI Funds"],"summary":"Current AI fund holdings","parameters":[{"$ref":"#/components/parameters/AIFundSource"},{"$ref":"#/components/parameters/Ticker"},{"$ref":"#/components/parameters/Limit250"}],"responses":{"200":{"description":"Current model positions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIFundPositionsResponse"},"example":{"positions":[{"fund":{"id":"ai_growth_01","name":"AI Growth Alpha","strategy":"growth"},"ticker":"NVDA","asset_class":"stock","side":"long","avg_entry_price":121.4,"current_price":126.88,"market_value_usd":1268.8,"unrealized_return_pct":4.51,"opened_at":"2026-05-20T14:21:00Z","priced_at":"2026-05-25T12:00:00Z","thesis":"Holding while fund thesis remains constructive."}]}}}}}}},"/aifunds/leaderboard":{"get":{"tags":["AI Funds"],"summary":"AI fund performance leaderboard","parameters":[{"$ref":"#/components/parameters/AIFundSource"},{"name":"sort","in":"query","schema":{"type":"string","enum":["return","sharpe","win_rate","drawdown"],"default":"return"}},{"$ref":"#/components/parameters/Limit250"}],"responses":{"200":{"description":"Model performance metrics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIFundLeaderboardResponse"},"example":{"funds":[{"rank":1,"fund":{"id":"ai_growth_01","name":"AI Growth Alpha","strategy":"growth"},"performance":{"total_return_pct":12.4,"daily_return_pct":0.42,"win_rate_pct":58.3,"sharpe_ratio":1.21,"max_drawdown_pct":6.5},"activity":{"trade_count":42,"open_position_count":8,"last_trade_at":"2026-05-25T10:42:00Z"}}]}}}}}}},"/aifunds/ticker/{ticker}":{"get":{"tags":["AI Funds"],"summary":"AI fund consensus for one ticker","parameters":[{"$ref":"#/components/parameters/TickerPath"},{"$ref":"#/components/parameters/AIFundSource"},{"$ref":"#/components/parameters/LookbackDays"},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"minimum":1,"maximum":100}}],"responses":{"200":{"description":"Aggregate AI fund stance and recent reasoning.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIFundTickerResponse"},"example":{"ticker":"NVDA","consensus":{"stance":"net_long_and_buying","positioned_funds":4,"net_position_value_usd":250000,"long_market_value_usd":250000,"short_market_value_usd":0,"recent_buy_value_usd":75000,"recent_sell_value_usd":10000,"recent_net_trade_value_usd":65000},"funds":[{"fund":{"id":"ai_growth_01","name":"AI Growth Alpha","strategy":"growth"},"position":{"ticker":"NVDA","side":"long","market_value_usd":1268.8,"unrealized_return_pct":4.51},"latest_trade":{"ticker":"NVDA","side":"buy","notional_value_usd":1268.8,"thesis":"AI infrastructure demand remains constructive.","executed_at":"2026-05-25T10:42:00Z"}}]}}}}}}},"/filings/search":{"get":{"tags":["Filings"],"summary":"Search filing passages by semantic relevance","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":1200}},{"$ref":"#/components/parameters/Ticker"},{"name":"tickers","in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"filing_types","in":"query","schema":{"type":"array","items":{"type":"string"},"example":["10-K","10-Q"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10,"minimum":1,"maximum":50}}],"responses":{"200":{"description":"Relevant filing matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsSearchResponse"},"example":{"results":[{"ticker":"NVDA","filing":{"type":"10-Q","date":"2026-05-22","url":"https://www.sec.gov/Archives/edgar/data/0001045810/example.htm"},"passage":"Gross margin changed primarily due to product mix and data center demand..."}]}}}}}}},"/filings/ask":{"post":{"tags":["Filings"],"summary":"Ask a question over SEC filing passages","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsAskRequest"},"example":{"question":"What changed in Nvidia data center revenue and gross margin commentary?","tickers":["NVDA"],"filing_types":["10-K","10-Q"],"limit":12,"stream":false}}}},"responses":{"200":{"description":"LLM answer grounded in filing citations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsAskResponse"},"example":{"answer":"Nvidia's filing commentary points to data center revenue growth as the primary driver, while margin risk is mostly tied to product mix and supply costs.","key_findings":[{"title":"Data center remains the main growth driver","detail":"The cited filing passages emphasize demand from accelerated computing and AI infrastructure."}],"citations":[{"id":"c1","ticker":"NVDA","filing":{"type":"10-Q","date":"2026-05-22","url":"https://www.sec.gov/Archives/edgar/data/0001045810/example.htm"}}]}},"text/event-stream":{"schema":{"type":"string"}}}}}}},"/filings/summary":{"get":{"tags":["Filings"],"summary":"Retrieve stored filing summaries","parameters":[{"$ref":"#/components/parameters/Ticker"},{"name":"tickers","in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"filing_types","in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"limit","in":"query","schema":{"type":"integer","default":3,"minimum":1,"maximum":20}}],"responses":{"200":{"description":"Stored filing summaries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsSummaryResponse"},"example":{"filings":[{"ticker":"NVDA","filing":{"type":"10-Q","date":"2026-05-22","url":"https://www.sec.gov/Archives/edgar/data/0001045810/example.htm"},"summary":"Quarterly filing summary focused on data center growth, margin drivers, and inventory risk."}]}}}}}}},"/financials/metrics":{"get":{"tags":["Filings"],"summary":"Retrieve normalized financial metrics","parameters":[{"$ref":"#/components/parameters/Ticker"},{"name":"tickers","in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"include_history","in":"query","schema":{"type":"boolean","default":false}},{"name":"period","in":"query","schema":{"type":"string","enum":["quarterly","yearly"],"default":"quarterly"}},{"name":"metrics","in":"query","schema":{"type":"array","items":{"type":"string"},"example":["revenue","assets"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":12,"minimum":1,"maximum":60}}],"responses":{"200":{"description":"Normalized filing-derived metrics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsMetricsResponse"},"example":{"companies":[{"ticker":"NVDA","name":"NVIDIA Corporation","profile":{"exchange":"NASDAQ","sector":"Technology","industry":"Semiconductors"},"latest":{"updated_at":"2026-05-25T08:30:00Z","metrics":{"revenue":60922000000,"gross_profit":44301000000,"total_debt":9709000000,"free_cash_flow":27021000000,"gross_margin":72.8}},"history":[{"period":"2026-Q1","filing":{"type":"10-Q","date":"2026-05-22","url":"https://www.sec.gov/Archives/edgar/data/0001045810/example.htm"},"metrics":{"revenue":26044000000,"gross_profit":20406000000}}]}]}}}}}}},"/filings/metrics":{"get":{"tags":["Filings"],"summary":"Alias for /financials/metrics","parameters":[{"$ref":"#/components/parameters/Ticker"},{"name":"tickers","in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"include_history","in":"query","schema":{"type":"boolean","default":false}},{"name":"period","in":"query","schema":{"type":"string","enum":["quarterly","yearly"],"default":"quarterly"}},{"name":"metrics","in":"query","schema":{"type":"array","items":{"type":"string"},"example":["revenue","assets"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":12,"minimum":1,"maximum":60}}],"responses":{"200":{"description":"Normalized filing-derived metrics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsMetricsResponse"},"example":{"companies":[{"ticker":"NVDA","name":"NVIDIA Corporation","profile":{"exchange":"NASDAQ","sector":"Technology","industry":"Semiconductors"},"latest":{"updated_at":"2026-05-25T08:30:00Z","metrics":{"revenue":60922000000,"gross_profit":44301000000,"total_debt":9709000000,"free_cash_flow":27021000000,"gross_margin":72.8}},"history":[{"period":"2026-Q1","filing":{"type":"10-Q","date":"2026-05-22","url":"https://www.sec.gov/Archives/edgar/data/0001045810/example.htm"},"metrics":{"revenue":26044000000,"gross_profit":20406000000}}]}]}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Rallies-API-Key"}},"parameters":{"TickerPath":{"name":"ticker","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":24,"example":"NVDA"}},"Ticker":{"name":"ticker","in":"query","schema":{"type":"string","minLength":1,"maxLength":24,"example":"NVDA"}},"Topic":{"name":"topic","in":"query","schema":{"type":"string","minLength":1,"maxLength":80,"example":"earnings"}},"Sentiment":{"name":"sentiment","in":"query","schema":{"type":"string","enum":["bullish","bearish","mixed","neutral","unknown"]}},"Days":{"name":"days","in":"query","schema":{"type":"integer","enum":[1,3,7,14,30,90,365],"default":7,"description":"Allowed values: 1, 3, 7, 14, 30, 90, 365."}},"LookbackDays":{"name":"lookback_days","in":"query","schema":{"type":"integer","enum":[1,3,7,14,30,90,365],"default":7,"description":"Allowed values: 1, 3, 7, 14, 30, 90, 365."}},"BaselineDays":{"name":"baseline_days","in":"query","schema":{"type":"integer","enum":[1,3,7,14,30,90,365],"default":30,"description":"Allowed values: 1, 3, 7, 14, 30, 90, 365."}},"Limit50":{"name":"limit","in":"query","schema":{"type":"integer","default":20,"minimum":1,"maximum":50}},"Limit100":{"name":"limit","in":"query","schema":{"type":"integer","default":25,"minimum":1,"maximum":100}},"Limit250":{"name":"limit","in":"query","schema":{"type":"integer","default":100,"minimum":1,"maximum":250}},"AssetClasses":{"name":"asset_classes","in":"query","schema":{"type":"array","items":{"type":"string","enum":["stock","etf","option","crypto","other"]}}},"AIFundSource":{"name":"source","in":"query","schema":{"type":"string","enum":["all","arena","funds"],"default":"all"}}},"schemas":{"RetailAskRequest":{"type":"object","required":["question"],"properties":{"question":{"type":"string","minLength":1,"maxLength":1000},"tickers":{"type":"array","maxItems":20,"items":{"type":"string"}},"days":{"type":"integer","enum":[1,3,7,14,30,90,365],"default":7,"description":"Allowed values: 1, 3, 7, 14, 30, 90, 365."},"limit":{"type":"integer","default":20,"minimum":5,"maximum":50},"stream":{"type":"boolean","default":false}}},"RetailAskResponse":{"type":"object","properties":{"answer":{"type":"string"},"related_tickers":{"type":"array","items":{"type":"object","additionalProperties":true}},"themes":{"type":"array","items":{"type":"object","additionalProperties":true}},"insights":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"QuestionThemesResponse":{"type":"object","properties":{"themes":{"type":"array","items":{"$ref":"#/components/schemas/QuestionTheme"}}}},"QuestionTheme":{"type":"object","properties":{"rank":{"type":"integer"},"label":{"type":"string"},"question_share_pct":{"type":"number"},"sentiment":{"type":"string"},"sentiment_breakdown_pct":{"type":"object","additionalProperties":{"type":["number","null"]}},"related_tickers":{"type":"array","items":{"type":"object","additionalProperties":true}},"related_topics":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"RetailTopicsResponse":{"type":"object","properties":{"topics":{"type":"array","items":{"$ref":"#/components/schemas/RetailTopic"}}}},"RetailTopic":{"type":"object","properties":{"rank":{"type":"integer"},"label":{"type":"string"},"conversation_share_pct":{"type":"number"},"sentiment":{"type":"string"},"sentiment_breakdown_pct":{"type":"object","additionalProperties":{"type":["number","null"]}},"related_tickers":{"type":"array","items":{"type":"object","additionalProperties":true}},"related_themes":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"RetailMoversResponse":{"type":"object","properties":{"movers":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"TickerSnapshotResponse":{"type":"object","properties":{"ticker":{"type":"string"},"retail_interest":{"type":["object","null"],"additionalProperties":true},"positioning":{"type":["object","null"],"additionalProperties":true},"flows":{"type":["object","null"],"additionalProperties":true}}},"ScreenerRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":1200},"limit":{"type":"integer","default":10,"minimum":1,"maximum":25}}},"ScreenerResponse":{"type":"object","properties":{"tickers":{"type":"array","items":{"$ref":"#/components/schemas/ScreenerTicker"}}}},"ScreenerTicker":{"type":"object","properties":{"ticker":{"type":"string"},"explanation":{"type":"string"}}},"PositioningResponse":{"type":"object","properties":{"snapshot_at":{"type":["string","null"]},"positions":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"FlowsResponse":{"type":"object","properties":{"flows":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"RotationResponse":{"type":"object","properties":{"current_snapshot_at":{"type":["string","null"]},"previous_snapshot_at":{"type":["string","null"]},"rotations":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"OptionsFlowsResponse":{"type":"object","properties":{"flows":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"AIFundTradesResponse":{"type":"object","properties":{"trades":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"AIFundPositionsResponse":{"type":"object","properties":{"positions":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"AIFundLeaderboardResponse":{"type":"object","properties":{"funds":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"AIFundTickerResponse":{"type":"object","properties":{"ticker":{"type":"string"},"consensus":{"type":"object","additionalProperties":true},"funds":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"FilingsAskRequest":{"type":"object","required":["question","tickers"],"properties":{"question":{"type":"string","minLength":1,"maxLength":1200},"tickers":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string"}},"filing_types":{"type":"array","maxItems":6,"items":{"type":"string"}},"start_date":{"type":["string","null"],"format":"date"},"end_date":{"type":["string","null"],"format":"date"},"limit":{"type":"integer","default":12,"minimum":3,"maximum":30},"stream":{"type":"boolean","default":false}}},"FilingsAskResponse":{"type":"object","properties":{"answer":{"type":"string"},"key_findings":{"type":"array","items":{"type":"object","additionalProperties":true}},"citations":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"FilingsSearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"FilingsMetricsResponse":{"type":"object","properties":{"companies":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"FilingsSummaryResponse":{"type":"object","properties":{"filings":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"ListResponse":{"type":"object","additionalProperties":true}}}}