{"openapi":"3.1.0","info":{"title":"MF NAV API — Open Mutual Fund Data","version":"3.1.0","description":"Daily NAV history for 17,866+ Indian mutual fund schemes from AMFI India. Jan 2013 – present. Rolling returns for 104 tracked funds.\n\nRate limit: 50 requests/min per IP. Downloads: 10/min. No auth required."},"paths":{"/mf/v1/":{"get":{"tags":["MF NAV -Open Mutual Fund Data"],"summary":"API catalog -endpoints, schema, description","description":"Starting point for API discovery. Lists all endpoints, data schema,\nand usage examples.","operationId":"catalog_mf_v1__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mf/v1/search":{"get":{"tags":["MF NAV -Open Mutual Fund Data"],"summary":"Search schemes by name or code","description":"Search across all 17,866 mutual fund schemes by name or code.\n\n- If q is numeric, matches scheme_code exactly or as prefix.\n- Otherwise, performs case-insensitive substring match on scheme_name.\n- Returns up to `limit` results (default 30).\n- Uses in-memory catalog for instant results (~2ms).\n\nExample: `/mf/v1/search?q=axis` or `/mf/v1/search?q=119775`","operationId":"search_schemes_mf_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Search query: scheme name (partial match) or scheme code (exact or prefix)","title":"Q"},"description":"Search query: scheme name (partial match) or scheme code (exact or prefix)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Max results to return","default":30,"title":"Limit"},"description":"Max results to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mf/v1/nav":{"get":{"tags":["MF NAV -Open Mutual Fund Data"],"summary":"NAV data for a single scheme","description":"Returns full NAV history for a single mutual fund scheme.\n\nNo pagination -all rows returned (typically ~3,300 trading days max).\n\nExample: `/mf/v1/nav?scheme=119775` or `/mf/v1/nav?scheme=119775&since=2024-01-01`","operationId":"nav_data_mf_v1_nav_get","parameters":[{"name":"scheme","in":"query","required":true,"schema":{"type":"integer","description":"AMFI scheme code (e.g., 119775)","title":"Scheme"},"description":"AMFI scheme code (e.g., 119775)"},{"name":"since","in":"query","required":false,"schema":{"type":"string","description":"Date filter YYYY-MM-DD. Returns NAV from this date onward.","title":"Since"},"description":"Date filter YYYY-MM-DD. Returns NAV from this date onward."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mf/v1/download":{"get":{"tags":["MF NAV -Open Mutual Fund Data"],"summary":"Download full NAV dataset","description":"Download the complete AMFI NAV dataset as a pre-generated static file.\n\nFormats (zip for browsers, gz for programmatic use):\n- **csv.zip** / **csv.gz** - CSV, universal\n- **tsv.zip** / **tsv.gz** - TSV, ideal for LLM context\n- **parquet** - Columnar compressed, ideal for pandas/DuckDB\n- **sqlite.zip** / **sqlite** - SQLite database, extract then query locally\n\nFiles are regenerated 3x daily after sync. Sizes shown in the catalog endpoint.","operationId":"download_dataset_mf_v1_download_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"File format: csv.gz, tsv.gz, parquet, sqlite","default":"parquet","title":"Format"},"description":"File format: csv.gz, tsv.gz, parquet, sqlite"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mf/v1/downloads/manifest":{"get":{"tags":["MF NAV -Open Mutual Fund Data"],"summary":"Download file sizes and metadata","description":"Returns pre-generated file sizes and row counts.\nUse this to show file sizes on download buttons.","operationId":"downloads_manifest_mf_v1_downloads_manifest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}