/moneycontrol/mutual_funds

POST /api/moneycontrol/mutual_funds

Price: 10 credits

Get an Indian mutual fund scheme from Moneycontrol by scheme id or page URL: NAV and its change, AUM, expense ratio, category, AMC, benchmark, objective, riskometer, fund managers, CAGR, trailing returns with category average and rank, risk ratios, asset and market-cap allocation, valuation against the category, debt-fund yield to maturity, duration, maturity and credit quality, and the scheme's other plan and option variants

How to use it

aum is in INR crores. Find a scheme id with moneycontrol/mutual_funds/search; moneycontrol/mutual_funds/holdings lists the portfolio.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• fund string required — Moneycontrol mutual fund scheme id or moneycontrol.com scheme page URL (examples: "MPP002", "https://www.moneycontrol.com/mutual-funds/nav/parag-parikh-flexi-cap-fund-direct-plan/MPP002")

Response

• @type string (default: "MoneycontrolMutualFund")
• id string required
• isin string nullable
• morningstar_id string nullable
• name string nullable
• short_name string nullable
• url string nullable
• is_active boolean nullable
• is_etf boolean nullable
• plan string nullable
• option string nullable
• category string nullable
• sub_category string nullable
• amc string nullable
• amc_id string nullable
• benchmark string nullable
• objective string nullable
• riskometer string nullable
• launch_date integer nullable
• lock_in string nullable
• investment_style string nullable
• star_rating integer nullable
• nav number nullable
• nav_change number nullable
• nav_change_percent number nullable
• nav_date integer nullable
• aum number nullable
• expense_ratio number nullable
• cagr_3y number nullable
• cagr_5y number nullable
• cagr_7y number nullable
• cagr_10y number nullable
• cagr_since_inception number nullable
• sharpe_ratio number nullable
• sharpe_ratio_category number nullable
• standard_deviation number nullable
• standard_deviation_category number nullable
• beta_3y number nullable
• beta_3y_category number nullable
• turnover_ratio number nullable
• turnover_ratio_category number nullable
• top_3_sector_weight number nullable
• top_5_stock_weight number nullable
• top_10_stock_weight number nullable
• holding_count integer nullable
• average_market_cap string nullable
• equity_percent number nullable
• debt_percent number nullable
• cash_percent number nullable
• other_percent number nullable
• large_cap_percent number nullable
• mid_cap_percent number nullable
• small_cap_percent number nullable
• other_cap_percent number nullable
• yield_to_maturity number nullable
• modified_duration number nullable
• average_maturity number nullable
• average_credit_quality string nullable
• credit_aaa_percent number nullable
• credit_aa_percent number nullable
• credit_a_percent number nullable
• fund_managers array (default: [])
  • @type string (default: "MoneycontrolFundManager")
  • name string required
  • role string nullable
  • start_date integer nullable
  • end_date integer nullable
• variants array (default: [])
  • @type string (default: "MoneycontrolFundVariant")
  • id string required
  • isin string nullable
  • name string nullable
  • plan string nullable
  • option string nullable
  • payout_frequency string nullable
  • url string nullable
• returns array (default: [])
  • @type string (default: "MoneycontrolFundReturn")
  • return_type string required
  • period string required
  • return_percent number nullable
  • category_average number nullable
  • category_rank integer nullable
  • category_fund_count integer nullable
• valuation array (default: [])
  • @type string (default: "MoneycontrolFundRatio")
  • name string required
  • value number nullable
  • category_average number nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — Moneycontrol has no mutual fund scheme under that id Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.