Finmagine

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

Banking 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+.

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

Institutional bulk and block deal feed: large buy/sell transactions with counterparty names and deal values. Tier: api_pro+.

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

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

Historical 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+.

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

Pre-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+.

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

Business 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+.

Stocks 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+.

Historical corporate actions for an NSE stock: stock splits, bonuses, rights issues, buybacks. Requires api_pro+.

Recent corporate actions across all NSE companies: splits, bonuses, rights, buybacks within a look-back window. Requires api_pro+.

Daily 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+.

Ranked 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+.

Post-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+.

Quarterly or annual P&L, balance sheet, and cash flow for an NSE company. Use this to assess revenue trend and OPM% expansion/compression over 6-8 quarters. Growth rates (CAGR) are pre-computed in get_ratios — do not manually calculate them from this data.

Quick 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+.

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

Weinstein Stage 1–4 classification for all 51 NSE industries (Stage 2 = active uptrend per the Weinstein methodology, Stage 4 = downtrend). Cross-reference with get_sector_rrg for a second, independent read on the same sector. Returns Stage 0 in broad market corrections where no industry clears the uptrend threshold. Tier: api_pro+.

Market-wide promoter and director transaction feed. For a single company's history, use get_insider_trades. Tier: api_pro+.

Promoter 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+.

Deep 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+.

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

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

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

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

AI-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+.

Market-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+.

Active 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+.

Quarterly 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+.

Pre-computed quality and risk ratios: ROCE, ROE, D/E, FCF yield, revenue/PAT CAGR (1yr, 3yr, 5yr), Altman Z-score, pledge %. Red flags: Altman Z < 1.8 = financial distress risk; pledge > 20% = governance risk; D/E > 2 = over-leveraged. Do not compute CAGRs manually from get_financials — use these pre-calculated values.

Momentum 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+.

Sector-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+.

Sector 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+.

Quarterly 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+.

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

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

Most recent 20 Investment Committee runs for the calling account (any status). Requires api_pro.