Returns API version and service name. No authentication required.

Response fields

# REST
curl "https://finmagine.com/api/v1/status" \
  -H "X-Api-Key: fmk_YOUR_KEY"

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/companies" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"search_companies","arguments":[]}

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.

Response fields

# REST
curl "https://finmagine.com/api/v1/company/profile?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_company_profile","arguments":{"symbol":"RELIANCE"}}

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.

Response fields

# REST
curl "https://finmagine.com/api/v1/company/financials?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_financials","arguments":{"symbol":"RELIANCE"}}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/ratios?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_ratios","arguments":{"symbol":"RELIANCE"}}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/momentum?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_momentum","arguments":{"symbol":"RELIANCE"}}

Market regime indicator: last 30 days of advances/declines, % stocks above 10/20/40-day MA, Nifty close. Use this to size positions correctly before entering trades. 40d MA breadth > 65% = broad advance, full-size entries appropriate. Below 50% = selective market, reduce position size. Below 40% = correction, hold cash. A sharp single-day drop to <30% advancers signals distribution.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/breadth" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_market_breadth","arguments":[]}

Top NSE stocks ranked by RS rating (IBD-style 1-99 vs Nifty 500). RS ≥ 90 = elite momentum. Use this to find what the market is rewarding most. Filter by a Leading-sector name from get_sector_rrg to get the best stock in the best sector — the highest-probability long setup.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/momentum" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_market_momentum","arguments":[]}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/sectors" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_market_sectors","arguments":[]}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/screener" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"screen_stocks","arguments":[]}

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

Response fields

# REST
curl "https://finmagine.com/api/v1/market/trader-scan" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"market_trader_scan","arguments":[]}

Cancel a running Investment Committee job started via start_committee. Requires api_pro.

Response fields

# REST
curl "https://finmagine.com/api/v1/committee/cancel?job_id=..." \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"cancel_committee","arguments":{"job_id":"..."}}

Post-earnings quality score (0-100) for a single NSE company: integrates profit growth, sales growth, CFO/profit ratio, margin trend, and PEAD signal. Score > 70 with RS > 80 = high-conviction post-earnings setup. Do not manually compute earnings quality from get_financials — use this instead. Tier: api_pro+.

Response fields

# REST
curl "https://finmagine.com/api/v1/company/ecs?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_ecs_score","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/guidance-tone?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_guidance_tone","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/order-wins?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_order_wins","arguments":{"symbol":"RELIANCE"}}

Promoter and director open-market buy/sell transactions for a single NSE company. Promoter buying at market price (not ESOPs) is a high-conviction signal — they have the most information. Check for overlap with high-RS stocks for best setups. For a cross-company feed, use get_insider_feed. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/insider-trades?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_insider_trades","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/banking-kpis?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_banking_kpis","arguments":{"symbol":"RELIANCE"}}

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 higher after beats — a consistent PEAD pattern increases conviction. For the current universe of active PEAD candidates, use get_pead_candidates. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/pead?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_company_pead","arguments":{"symbol":"RELIANCE"}}

Business group (Tata, Adani, Birla, Reliance, etc.) membership and live fundamentals for all group entities. Use this to understand cross-holding risk, group-level capex cycles, and whether the holding company is a better or worse entry than the listed subsidiary. Returns 404 if not in a tracked group. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/conglomerate?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_conglomerate","arguments":{"symbol":"RELIANCE"}}

Quarterly promoter pledge % history. Pledge > 20% = governance risk flag; rising pledge trend = potential forced-selling overhang. Always check this before adding a high-RS stock — strong momentum with rising pledges is a trap setup. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/pledge-history?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_pledge_history","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/daily-prices?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_daily_prices","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/shareholding?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_shareholding","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/corporate-actions?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_corporate_actions","arguments":{"symbol":"RELIANCE"}}

Ranked leaderboard of alpha candidates immediately after quarterly earnings — stocks where fundamentals (profit growth, margins, cash flow) AND price momentum both confirm the beat. Do not manually filter get_financials to find earnings quality; use this pre-computed ranking instead. Cross-reference with get_pead_candidates for highest-conviction post-earnings setups. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/ecs" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_ecs_leaderboard","arguments":[]}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/conviction" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_conviction_ranking","arguments":[]}

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). Price drift often continues weeks after a strong beat. Cross-reference with get_ecs_leaderboard — stocks appearing in both lists have the highest post-earnings conviction. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/pead" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_pead_candidates","arguments":[]}

Sector rotation coordinates for top-down macro screening. Call this before searching for individual stocks. Leading quadrant (RS-Ratio > 100 AND RS-Momentum > 100) = sectors to buy in. Lagging quadrant = avoid regardless of individual stock RS. Improving = early rotation opportunity. Weakening = reduce exposure. Focus new positions on Leading and Improving sectors only. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/rrg" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_sector_rrg","arguments":[]}

Weinstein Stage 1–4 classification for all 51 NSE industries. Stage 2 = active uptrend — only buy stocks whose industry is in Stage 2 or transitioning into it. Stage 4 = downtrend — avoid. Cross-reference with get_sector_rrg Leading sectors: Stage 2 industry + Leading RRG sector = highest-conviction setup. Returns Stage 0 in broad market corrections where no industry clears the uptrend threshold. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/industry-stages" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_industry_stages","arguments":[]}

Momentum acceleration signals: stocks whose RS rating has improved most over N days. Stocks early in a RS improvement cycle often lead the next phase of the move. An RS delta > 20 points in 20 days = strong acceleration. Combine with get_sector_rrg Leading sectors for highest-conviction early-entry setups. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/rs-changes" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_rs_changes","arguments":[]}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/index-constituents" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_index_constituents","arguments":[]}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/top-movers" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_top_movers","arguments":[]}

Call this first at the start of any session. Returns whether Nifty 50 is above both EMAs (ABOVE_BOTH = breakouts likely to work, take full-size entries), above only EMA-21 (ABOVE_21_ONLY = caution, reduce size), or below both (BELOW_BOTH = avoid new breakout trades entirely). Use with get_market_breadth for a complete market regime picture. Free tier.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/market/breakout-conditions" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_breakout_conditions","arguments":[]}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/ai-summary?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_ai_quarterly_summary","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/scorecard" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_company_scorecard","arguments":[]}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/management-tone?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_management_tone","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/sector-kpis?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_sector_kpis","arguments":{"symbol":"RELIANCE"}}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/ai-profile?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_ai_company_profile","arguments":{"symbol":"RELIANCE"}}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/company/concall-decoder?symbol=RELIANCE" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_concall_decoder","arguments":{"symbol":"RELIANCE"}}

Market-wide order win announcements feed across all NSE companies. Use this during event-flow scanning to identify which sectors are winning new business. A cluster of order wins in one sector + Leading RRG position = sector-level catalyst. For a single company's order history, use get_order_wins. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/feeds/order-wins" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_order_wins_feed","arguments":[]}

Market-wide promoter and director transaction feed. Look for promoter buying in stocks that also appear in get_market_momentum top-30 — insider buying + price momentum is a high-conviction alignment. For a single company's history, use get_insider_trades. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/feeds/insider" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_insider_feed","arguments":[]}

Institutional bulk and block deal feed: large buy/sell transactions with counterparty names. Deals > ₹100 Cr from known institutional names signal conviction-level positioning. A block deal by a major FII in a Leading-sector stock is a strong setup confirmation. Tier: api_pro+.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/feeds/bulk-block-deals" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_bulk_block_deals","arguments":[]}

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.

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/feeds/circuit" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_circuit_stocks","arguments":[]}

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

Response fields

Documentation in progress.

# REST
curl "https://finmagine.com/api/v1/feeds/corporate-actions" \
  -H "X-Api-Key: fmk_YOUR_KEY"

# MCP
{"name":"get_corporate_actions_feed","arguments":[]}