allocate_committee_risk
ChatGPTDeterministic position-sizing: turns committee stances + risk metrics into illustrative allocation weights (max 20% per position, not investment advice). Pure computation, zero LLM tokens. Typically fed the outputs of get_committee_report and compute_committee_risk for the same symbols. Requires api_pro.
cancel_committee
ChatGPTCancel a running Investment Committee job started via start_committee. Requires api_pro.
cancel_preset
ChatGPTCancel a running Research Preset run started via start_preset. Requires api_pro.
check_committee_status
ChatGPTPoll an Investment Committee run started via start_committee, by job_id or vps_run_id (at least one required). Terminal states are served from a DB cache; non-terminal polls make a live call to the swarm VPS. Requires api_pro.
check_preset_status
ChatGPTPoll a Research Preset run started via start_preset. Terminal states (completed/failed/cancelled) are served from a DB cache; non-terminal polls make a live call to the swarm VPS. Requires api_pro.
compute_committee_risk
ChatGPTDeterministic risk audit: correlation matrix, annualized volatility, max drawdown, beta vs benchmark (Nifty for India / SPY for US), sector concentration, portfolio risk score. Pure computation over price history — zero LLM tokens, no quota. Requires api_pro.
estimate_committee_run
ChatGPTPreview a start_committee call before spending anything — symbol count, lens list, estimated LLM call count/runtime, and remaining daily quota. Note: this estimates Finmagine LLM call cost only — if include_news_sentiment is later passed true on the real call, that consumes the caller's own separate Alpha Vantage quota (external, BYO, not part of this estimate). No job is started, no quota consumed, no provider called. Requires api_pro.
estimate_preset_run
ChatGPTPreview a start_preset call before spending anything — symbol/preset validity, remaining daily quota, and a rough runtime estimate. No job is started, no quota consumed, no provider called. Requires api_pro.
fast_scan_committee
ChatGPTDeterministic PHP-only scoring across 3 lenses (quality compounder / growth / value-safety) for up to 10 symbols — zero LLM tokens, synchronous, does not count against the 5-runs/24h quota. Use this before start_committee to see if a full LLM run is even worth it. Requires api_pro.
get_ai_company_profile
ChatGPTFull AI research profile integrating concall analysis, financials, and sector context into 10 sections: business model, competitive moat, management quality, growth drivers, risk factors, financial health, industry dynamics, recent developments, investment thesis, bull/bear case. Use this instead of manually synthesising get_financials + get_ratios + get_management_tone for a first-pass research view. Requires api_max.
get_ai_quarterly_summary
ChatGPTAI-generated earnings summary for an NSE company from the latest concall (DeepSeek, 703 companies covered). Returns headline verdict, key positives, key risks, and management outlook. Use this to understand WHAT happened in the quarter without reading the full transcript. Requires api_max.
get_banking_kpis
ChatGPTBanking and NBFC operational KPIs from investor presentations: NIM trend, GNPA/NNPA trajectory, CASA ratio, credit growth, PCR. These metrics are not in standard financials — essential for evaluating any bank or NBFC. Returns empty array for non-financial companies; check get_company_profile sector first. Tier: api_pro+.
get_breakout_conditions
ChatGPTCall this first at the start of any session. Returns whether Nifty 50 is above both EMAs (ABOVE_BOTH), above only EMA-21 (ABOVE_21_ONLY), or below both (BELOW_BOTH). Use with get_market_breadth for a complete market regime picture. Free tier.
get_bulk_block_deals
ChatGPTInstitutional bulk and block deal feed: large buy/sell transactions with counterparty names and deal values. Tier: api_pro+.
get_circuit_stocks
ChatGPTStocks that hit upper or lower circuit limits on a given date. Upper circuits with no RS rating = retail-driven micro-cap activity (low quality). Upper circuits among Nifty 500 constituents = institutional momentum worth investigating. Free tier.
get_committee_report
ChatGPTFetch a completed (or in-progress) Investment Committee run's full report — per-symbol committee signal, agreement score, research stance, dissent summary, per-lens signals, and a bull/bear debate panel (bull_case, bear_case, what_would_change_view, unresolved_questions — may be null if unavailable). Requires api_pro.
get_company_pead
ChatGPTHistorical Post-Earnings Announcement Drift events for a single NSE company: volume surges and price drift after each results date. Use this to assess whether this stock has a track record of drifting after beats. For the current universe of active PEAD candidates, use get_pead_candidates. Tier: api_pro+.
get_company_profile
ChatGPTFull fundamental snapshot for an NSE company: PE, ROCE, ROE, D/E, OPM%, market cap, 52-week high/low, RS rating, current price. Use this as the entry point for any single-stock deep dive — it gives the context needed to interpret all other tools.
get_company_scorecard
ChatGPTPre-computed composite scorecard combining momentum and fundamental sub-scores into a single ranking. Use this to quickly compare companies without manually scoring get_financials + get_ratios + get_momentum. Omit symbol to get a ranked leaderboard — higher overall_score = better fundamentals + momentum combination. Useful for shortlisting before a full deep dive. Requires api_pro+.
get_concall_decoder
ChatGPTStructured extraction of management commitments from earnings call transcripts: what they guided for, whether they delivered, capex plans, margin targets, growth outlook. Use this to assess management credibility — a pattern of missed guidance is a red flag regardless of current RS rating. Requires api_max.
get_conglomerate
ChatGPTBusiness group (Tata, Adani, Birla, Reliance, etc.) membership and live fundamentals for all group entities. Use this to understand cross-holding structure and group-level capex cycles. Returns 404 if not in a tracked group. Tier: api_pro+.
get_conviction_ranking
ChatGPTStocks passing the most simultaneous Finmagine scans (Stage 2, VCP, near-52WH, RS momentum, PEAD, etc.). High scan-overlap count = strongest multi-factor confluence signal. Use this as a starting point for deep dives rather than manually combining screener outputs. A stock appearing in 4+ scans is worth investigating regardless of sector. Tier: api_pro+.
get_corporate_actions
ChatGPTHistorical corporate actions for an NSE stock: stock splits, bonuses, rights issues, buybacks. Requires api_pro+.
get_corporate_actions_feed
ChatGPTRecent corporate actions across all NSE companies: splits, bonuses, rights, buybacks within a look-back window. Requires api_pro+.
get_daily_prices
ChatGPTDaily OHLCV + delivery % history for an NSE stock. Delivery % > 60% on a strong up-day signals genuine accumulation (not intraday speculation). Use this to compute N-day price change, identify consolidation bases, or verify volume signature on breakout days. Requires api_pro+.
get_ecs_leaderboard
ChatGPTRanked leaderboard of stocks immediately after quarterly earnings, ranked by ECS — where fundamentals (profit growth, margins, cash flow) AND price momentum both confirm the results. Pre-computed — do not manually filter get_financials to derive this ranking. Tier: api_pro+.
get_ecs_score
ChatGPTPost-earnings quality score (0-100) for a single NSE company: integrates profit growth, sales growth, CFO/profit ratio, margin trend, and PEAD signal. Pre-computed — do not manually derive earnings quality from get_financials. Tier: api_pro+.
get_financials
ChatGPTQuarterly or annual income-statement summary for an NSE company, newest period first (annual includes a TTM row): sales, EBITDA (operating profit), net profit (PAT) and OPM%, all in ₹ crore except OPM%. Use this to see revenue and OPM% trend over 6-8 quarters. It does not return balance-sheet or cash-flow lines; FCF yield, OCF-to-PAT, net debt and growth rates (CAGR) are pre-computed in get_ratios — do not recalculate CAGRs from this data.
get_forensics
ChatGPTForensic evidence for an NSE company from up to five annual periods (chronological, TTM excluded) plus eight quarters: cash flow vs profit (CFO/PAT, mean and pooled), other income as a share of profit (annual and quarterly), receivable days, borrowings, CWIP share, net profit trend, and inventory, payable, cash-conversion and working-capital days (can be negative). Each signal returns its series, latest value, trend, the transparent rule text with threshold and hit flag (true, false, or null when not applicable or not computable) — numbers and flags only, no grade or verdict. Banks, NBFCs and insurers return applicability "limited" with the non-meaningful signals marked applicable:false. Tier: api_pro+.
get_guidance_tone
ChatGPTQuick concall tone score (0-100): ≥60 = positive, 40-59 = neutral, <40 = negative. Use for rapid screening across many stocks. For multi-quarter tone trajectory and phrase drift analysis on a single stock, use get_management_tone instead. Tier: api_pro+.
get_index_constituents
ChatGPTAll stocks in a named NSE index. Use this to check whether a candidate stock is in a specific index (index inclusion = institutional coverage) or to cross-reference index composition with a sector or momentum filter. Index names must be uppercase: "NIFTY 50", "NIFTY 500", "NIFTY MIDCAP 150". Omit index to list all 30 available index names.
get_industry_stages
ChatGPTIndustry momentum bands for every NSE industry from the latest daily run. Each industry gets a 0-100 composite score (40% RS rating, 30% 1-month return, 30% distance from the 52-week high) and a stage_label: OUTPERFORMING (70+), ACCUMULATING (50-69), CONSOLIDATING (30-49) or UNDERPERFORMING (below 30). The integer stage is derived from that band (OUTPERFORMING=2, ACCUMULATING=1, CONSOLIDATING=3, UNDERPERFORMING=4); it is not a Weinstein classification. Cross-reference with get_sector_rrg for a second, independent read on the same sector. Tier: api_pro+.
get_insider_feed
ChatGPTMarket-wide promoter and director transaction feed. For a single company's history, use get_insider_trades. Tier: api_pro+.
get_insider_trades
ChatGPTPromoter and director open-market buy/sell transactions for a single NSE company. Distinguishes market-price purchases from ESOP-related transactions. For a cross-company feed, use get_insider_feed. Tier: api_pro+.
get_management_tone
ChatGPTDeep multi-quarter management tone analysis. Use this (not get_guidance_tone) when you need trend direction: is management confidence improving or deteriorating quarter-over-quarter? Returns tone_trajectory, phrase_drift (language shifts that precede guidance changes), and investor_lens. get_guidance_tone gives a single score; this gives the story behind the score. Requires api_pro+.
get_market_breadth
ChatGPTMarket regime indicator: last 30 days of advances/declines, % stocks above 10/20/40-day MA, Nifty close. A sharp single-day drop to <30% advancers signals broad distribution.
get_market_momentum
ChatGPTTop NSE stocks ranked by RS rating (IBD-style 1-99 vs Nifty 500). RS ≥ 90 is the platform's "elite momentum" threshold. Cross-reference with get_sector_rrg's Leading sectors to narrow the list to stocks in currently-leading sectors.
get_market_sectors
ChatGPTPer-sector summary across all NSE companies: stock count, average RS rating, and total market cap. Use this to identify which sectors have the highest average RS before drilling into individual stocks with get_market_momentum. A sector with avg_rs_rating > 70 = broad sector leadership, not just one or two stocks. Free tier.
get_momentum
ChatGPTTechnical momentum signals for an NSE company: RS rating (IBD-style 1-99 vs Nifty 500 universe), EMA-10/21/50 alignment, Stage 2 flag, VCP flag, 52-week high proximity, 30-day RS trend. RS > 85 = elite; price above 10-EMA AND 21-EMA = confirmed uptrend. RS trend direction matters more than the absolute score — an RS rising from 60→75 can be more actionable than a stagnant RS 90.
get_order_wins
ChatGPTAI-extracted order win announcements for a single NSE company: deal value, client, segment, confidence score. Use this in a deep dive to assess revenue visibility and backlog growth. For a cross-company feed of recent wins, use get_order_wins_feed instead. Tier: api_pro+.
get_order_wins_feed
ChatGPTMarket-wide order win announcements feed across all NSE companies. Use this during event-flow scanning to identify which sectors are winning new business. For a single company's order history, use get_order_wins. Tier: api_pro+.
get_pead_candidates
ChatGPTActive Post-Earnings Announcement Drift candidates: stocks that recently beat earnings AND show volume + price drift signals, still within the drift window (last 45 days). Tier: api_pro+.
get_pledge_history
ChatGPTQuarterly promoter pledge % history. Pledge above 20% is commonly treated as a governance risk flag; a rising pledge trend can indicate potential forced-selling overhang. Tier: api_pro+.
get_pulse_events
ChatGPTMarket-wide Pulse feed of recent NSE/BSE corporate events: results, order wins, insider and deal activity, governance, corporate actions, announcements and documents, one row per event with a filing link when the exchange attachment is stored, otherwise a Finmagine company-timeline link. Use this to scan what happened across the market in the last few days. For a single company's timeline use get_company_profile. Order rows carry materiality (order value against trailing revenue) with a computed, approximate or not_computable state. Events are updated each morning from processed disclosures. Tier: api_pro+.
get_ratios
ChatGPTPre-computed quality and leverage snapshot (one current row, not a time series): ROCE, ROE, D/E, OPM%, sales growth, P/E, FCF yield, 5-year FCF CAGR, 10-year revenue and PAT CAGR, 3- and 5-year EBITDA CAGR, Altman Z-score, 10-year counts of profitable, FCF-positive and dividend-paying years, 5-year OCF-to-PAT, net debt (₹ crore), pledge % and promoter %. Do not compute CAGRs manually from get_financials — use these pre-calculated values.
get_results_board
ChatGPTResults Board for NSE/BSE companies: every company that has reported the chosen quarter (default: the latest), with revenue, operating margin, profit after tax and EPS, quarter-on-quarter and year-on-year changes, filtered by market-cap band, industry and Main/SME board, sorted and paged. Use this to scan a results season across the market. For one company use get_financials. Facts only: figures and changes as reported, not a view on any stock. Tier: any key gets the public board; api_pro+ adds ECS band/score, valuation, a this-quarter tag, the since-result move, and the caller's own watchlist/portfolio filter. Premium filters without api_pro+ return premium_required.
get_rs_changes
ChatGPTMomentum acceleration signals: stocks whose RS rating has improved most over N days. An RS delta > 20 points in 20 days is the platform's "strong acceleration" threshold. Tier: api_pro+.
get_sector_kpis
ChatGPTSector-specific operational KPIs extracted from investor presentations — metrics that do not appear in standard financials (e.g. Cement: utilisation %, EBITDA/tonne, realization/tonne; Banks: NIM, GNPA, PCR, CASA; Infra: order backlog, execution rate). Use this to assess operational momentum beyond P&L numbers. Omit period for full trend history. Requires api_pro+.
get_sector_rrg
ChatGPTSector rotation coordinates for top-down macro screening. Call this before searching for individual stocks. Quadrants: Leading (RS-Ratio > 100 AND RS-Momentum > 100), Weakening, Lagging, Improving — the standard JdK RRG classification. Tier: api_pro+.
get_shareholding
ChatGPTQuarterly ownership pattern: promoter, FII, DII, and public holding % over time. FII accumulation (rising FII % over 3+ quarters) is a strong institutional endorsement. Promoter holding decline without a stated reason is a red flag. Requires api_pro+.
get_top_movers
ChatGPTDaily top gainers and losers by % change across NSE. Use this at session start to read market character: if all top gainers are micro-caps with no RS rating, it is retail-driven (low quality). If large-caps from Leading sectors dominate, it is institutional. Combine with get_circuit_stocks to separate momentum from circuit-driven moves. Free tier.
get_valuation_history
ChatGPTHistorical valuation multiple (P/E, P/B, P/S or FCF yield) for an NSE company over 1y/3y/5y/10y, as one value per month plus statistics: latest, monthly-observation median (use this, not the all-rows median), quartiles, min/max and the latest value's percentile. Also returns the underlying input (TTM EPS, book value per share or TTM sales) as step changes, coverage and sampling disclosure, freshness, a quality block (reliability ok/low/unknown with reasons and the date from which inputs are verified) and the calculation basis. Weekend and holiday rows repeat the prior close. Tier: api_pro+.
list_byo_keys
ChatGPTList the calling account's saved BYO LLM provider keys (masked, never raw) and the current preferred provider. Call this before start_preset/start_committee to check what's available. No tier gate.
list_committee_runs
ChatGPTMost recent 20 Investment Committee runs for the calling account (any status). Requires api_pro.
list_preset_catalog
ChatGPTThe 8 available Research Preset definitions (id, market, label, description, approximate runtime, agent count) — call this to discover what start_preset accepts before running one. No tier gate.
list_preset_runs
ChatGPTMost recent 20 Research Preset runs for the calling account (any status). Requires api_pro.
market_trader_scan
ChatGPTNSE stocks matching a precomputed technical scan: Stage 2 breakouts, VCP setups, Near-High, High Volume, or Breakout Readiness Score (BRS). Mirrors the /picks/ Trader tab. Refreshed weekdays 12:30 IST. Use allThree for the highest-confluence names (matching multiple scans simultaneously). Requires api_pro.
remove_byo_key
ChatGPTRemove a saved BYO LLM provider key. If it was the preferred provider, the preferred-provider setting is cleared too. No tier gate.
save_byo_key
ChatGPTSave (or overwrite) a BYO LLM provider key for the calling account. Format-check only — pass test_and_save:true for an immediate live verification in the same call. No tier gate. Rate-limited: 20/account/hour (test_and_save also counts against the 10/hour test limit). WARNING: this tool argument carries a real, secret provider API key in plain text. Do not send provider secrets through MCP clients you do not fully control — some clients log tool-call arguments. If unsure, save the key via the REST endpoint instead.
screen_natural_language
ChatGPTScreen NSE stocks using plain English. Examples: "profitable mid-caps with low debt and strong momentum", "large-cap IT stocks with high ROCE and good earnings growth". Converts the query to filter criteria and returns matching stocks. Free-tier users: 20 calls/day. Requires api_base.
screen_stocks
ChatGPTFinal-stage quality filter: screen NSE stocks by ROCE, PE, RS rating, D/E, MCap, sector simultaneously. Use this after identifying the market regime (get_market_breadth) and target sectors (get_sector_rrg) — not as a starting point. Hard cap: 50 results. Requires api_max.
search_companies
ChatGPTSearch NSE-listed companies by name, sector, or financial filters. Use this to find the correct NSE symbol for a company before calling other tools. Also useful for listing all tracked companies in a sector. Returns symbol, name, sector, market cap, RS rating.
set_preferred_byo_key
ChatGPTSet the account-wide default LLM provider. This is an account default, not a per-task control — presets/committee calls should instead pass a per-call provider hint if they need a specific one, to avoid racing with other concurrent workflows on the same account. No tier gate.
start_committee
ChatGPTStart a full Investment Committee run — multi-lens LLM analysis + async swarm workflow, up to 10 symbols. Async: returns job_id/vps_run_id immediately with status=running; poll with check_committee_status. No auto-resolve of provider — call list_byo_keys first and pass one explicitly. Quota: 5 runs/24h per account, shared with web usage. Call estimate_committee_run first to preview cost/quota before spending. Requires api_pro.
start_preset
ChatGPTStart a Research Preset run — a multi-agent analyst chain (Strategy Lab), genuinely separate from Investment Committee. Async: returns run_id/vibe_run_id immediately with status=running; poll with check_preset_status. No auto-resolve of provider — call list_byo_keys first and pass one explicitly. Quota: 10 runs/24h per account, shared with web usage. Call estimate_preset_run first to preview cost/quota before spending. Requires api_pro.
test_byo_key
ChatGPTLive-verify a BYO LLM provider key against the actual provider (~15s). Pass {provider} alone to re-test the already-saved key (no secret transmitted) — prefer this mode. Pass {provider,model,key} to test an ad-hoc value without saving. No tier gate. Rate-limited: 10/account/hour — this makes a real outbound call to the provider. WARNING (ad-hoc mode only): the key argument carries a real, secret provider API key in plain text. Do not send provider secrets through MCP clients you do not fully control — some clients log tool-call arguments.
us_get_13f_holdings
ChatGPTSuperinvestor 13F holdings data. If symbol provided: shows which tracked funds hold it with value and portfolio %. If no symbol: lists all 14 tracked superinvestors (Berkshire, Pershing, Scion, Appaloosa, Duquesne, etc.). Requires api_max.
us_get_ai_company_profile
ChatGPTDeep AI-generated company profile for a US stock: 10-section analysis covering business model, financials, competitive moat, management quality, risks, and investment thesis. Updated each earnings cycle. Requires api_max.
us_get_ai_quarterly_summary
ChatGPTAI-generated one-pager for a US company's most recent earnings: verdict, key KPIs, what went right, what to watch, management guidance, and investor lens. Faster than reading the full report. Requires api_pro.
us_get_breakout_conditions
ChatGPTSPY Technical Breakout Conditions: evaluates SPY's price relative to its moving averages and returns the US benchmark's breakout regime. This describes SPY itself, not broad-market participation — for that, use us_get_market_breadth. Returns BULL_CONFIRMED, ABOVE_SMA50_ONLY, or BEAR_CONFIRMED regime with SPY price, EMA-20, and RSI-14.
us_get_company_profile
ChatGPTFull profile for a US stock: price, market cap (USD billions), 52-week range, RS rating, P/E, ROE, operating margin, scorecard score, index membership (SP500/NDX100/DOW30). Free tier restricted to 25 S&P 500 mega-caps: AAPL, MSFT, AMZN, NVDA, GOOGL, META, TSLA, JPM, V, UNH, AVGO, LLY, XOM, MA, HD, PG, COST, MRK, ABBV, CVX, KO, PEP, ORCL, BAC, JNJ.
us_get_company_scorecard
ChatGPTFinmagine scorecard for US stocks: 5-dimension score (financial_health, growth_prospects, competitive_position, management_quality, valuation) and overall 0–10 score. Omit symbol for ranked list. Requires api_pro.
us_get_concall_decoder
ChatGPTStructured earnings call decoder for a US company: tone_read, top 3 management messages, topics dodged or downplayed, tone shifts from prior quarter, key numbers from Q&A, management outlook, and investor lens. Requires api_max.
us_get_conviction_ranking
ChatGPTUS stocks appearing in multiple screener presets simultaneously — a quantitative measure of multi-factor conviction. Higher scan_count = passes more screens at once. Requires api_pro.
us_get_ecs_score
ChatGPTEarnings Catalyst Score (ECS) for a US stock: composite 0–100 score reflecting quality and surprise of recent earnings. Includes revenue/net income YoY and QoQ, percentile ranks, PEAD signal, and actual vs expected EPS. Requires api_pro.
us_get_financials
ChatGPTHistorical financials for a US stock — income statement, balance sheet, or cash flow — annual or quarterly. Key income fields: revenue, netinc, epsdil, ncfo, capex, fcf. Key balance fields: assets, debtnc, assetsc. Requires api_pro.
us_get_full_report
ChatGPTFull AI research report for a US stock with COMPELLING/WATCHLIST/AVOID stance. Complete fundamental analysis narrative in plain text. Requires api_max.
us_get_index_constituents
ChatGPTMembers of SP500, NDX100 (Nasdaq 100), or DOW30 (Dow Jones 30). Returns symbol, name, GICS sector, RS rating, market cap, P/E, and scorecard score. Use index_name: SP500, NDX100, or DOW30. Requires api_pro.
us_get_insider_trades
ChatGPTRecent SEC Form 4 insider transactions for a US stock: director/officer name, title, transaction type, shares, price per share, and total value USD. Requires api_pro.
us_get_management_tone
ChatGPTManagement tone analysis across recent earnings calls for a US company: per-quarter tone_read, top messages, dodged topics, and investor lens. Derived from AI-decoded earnings calls. Requires api_pro.
us_get_market_breadth
ChatGPTUS market breadth snapshot: percentage of stocks above SMA-50 and SMA-200, total stocks tracked, and sector-level breakdown. Use this to gauge overall US market health before screening.
us_get_market_sectors
ChatGPTUS sector summary: stock count, average scorecard score, average RS rating, and breadth (% above SMA-50 and SMA-200) for each GICS sector. Use to identify leading vs lagging sectors.
us_get_momentum
ChatGPTTechnical momentum profile for a US stock: RS rating, 1W/1M/3M returns, RSI-14, MACD, EMA-20, SMA-50, SMA-200 with above/below flags, distance from 52-week high, and latest ECS score. Requires api_pro.
us_get_order_wins
ChatGPTContract wins and significant agreements for US companies sourced from SEC 8-K filings. Returns contract type, value (USD millions), client name, segment, geography, AI summary, and confidence. Omit symbol for recent cross-company feed. Requires api_pro.
us_get_pulse_events
ChatGPTMarket-wide Pulse feed of recent US corporate events: earnings filings, insider trades, contracts and SEC filings, one row per event with the SEC filing link when stored, otherwise a Finmagine company-timeline link. Use this to scan what happened across the US market in the last few days. For a single company use us_get_company_profile. Order rows carry materiality (contract value against trailing revenue) with a computed, approximate or not_computable state. Events are updated each morning from processed filings. Tier: api_pro+.
us_get_ratios
ChatGPTFinancial ratios for a US stock with classification (Excellent/Good/Average/Poor) and peer percentile. Covers valuation (P/E, P/B, EV/EBITDA), profitability (ROE, margins), growth, leverage, and liquidity. Requires api_pro.
us_get_results_board
ChatGPTResults Board for US companies: every company that has filed its quarter in the chosen period (default: the latest filings), with revenue, net income, EPS, margins, year-on-year and quarter-on-quarter changes, EPS surprise and the filing form, filtered by market cap, sector and index, sorted and paged. Use this to scan a results season across the market. For one company use us_get_financials. Facts only: figures and changes as filed, not a view on any stock. Tier: any key gets the public board; api_pro+ adds ECS band/score, since-filing move, and the caller's own watchlist/portfolio filter. Premium filters without api_pro+ return premium_required.
us_get_sec_feed
ChatGPTRecent SEC filings from EDGAR: 8-K material events, 10-K annual reports, 10-Q quarterly reports. Filter by symbol, form type, and lookback days. Requires api_max.
us_get_top_movers
ChatGPTUS top gainers or losers by recent price return. Direction: gainers (default) or losers. Period: 1w (1 week) or 1m (1 month, default). Returns symbol, name, sector, current price, return %, RS rating, market cap in USD billions.
us_market_momentum
ChatGPTTop US stocks ranked by RS rating (IBD-style 1-99 vs full US universe). RS >= 90 = elite momentum. No tier gate — source data is fully public.
us_market_trader_scan
ChatGPTUS stocks matching a precomputed technical scan: Stage 2, VCP, Near-High, High Volume, or Breakout Readiness Score (BRS). Mirrors /us/picks/?list=trader. Requires api_pro (source data is premium-gated on the web).
us_screen_natural_language
ChatGPTScreen US stocks using plain English. Examples: "profitable large-cap tech stocks with low debt", "healthcare companies with high ROE and strong earnings growth". Converts the query to filter criteria and returns matching stocks. Uses Groq/Gemini (no Finmagine paid LLM keys). Requires api_max.
us_screen_stocks
ChatGPTScreen US stocks by fundamentals, technicals, and scorecard. Filters: sector, market cap (USD billions), P/E, ROE, operating margin, RS rating, above SMA-50/200, debt/equity, minimum scorecard score. Returns up to 50 results. Requires api_pro.
us_search_companies
ChatGPTSearch US stocks by name or ticker symbol. Returns symbol, name, sector, industry, market cap (USD billions), and scorecard score. No tier restriction on search — free keys get 10 results, paid keys get up to 50.