# Mfcentral — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Explore mutual fund schemes across different AMCs and categories, search for specific funds, and access detailed performance metrics and scheme information. Get answers to common questions and discover all available fund houses in one centralized platform.

**Category:** Finance & Markets | **Website:** [mfcentral.com/](https://mfcentral.com/) | **Docs:** [parse.bot/marketplace/40e8100e-8cc5-4b5f-b669-357697329d5e/mfcentral-com-api](https://parse.bot/marketplace/40e8100e-8cc5-4b5f-b669-357697329d5e/mfcentral-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mfcentral-com-api-40e8100e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### explore_mutual_funds

List or filter mutual fund schemes with basic info such as NAV, returns, and category. Supports filtering by AMC code, category, and plan type. Paginated via limit/offset. Due to upstream response size, approximately 6000+ schemes are available for filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `amc_code` | string | No | Filter by AMC code (e.g., '327' for Mirae Asset, '25' for SBI). AMC codes can be found via get_fund_categories endpoint's amcDetails array. |
| `category` | string | No | Filter by category name: 'Equity', 'Debt', 'Hybrid', 'Other'. |
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Number of results to skip for pagination. |
| `plan` | string | No | Filter by plan type: 'Direct' or 'Regular'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mfcentral-com-api-40e8100e/explore_mutual_funds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amc_code":"<string>","category":"<string>","limit":"<integer>","offset":"<integer>","plan":"<string>"}'
```

### get_all_fund_houses

Retrieve all mutual fund houses (AMCs) listed on MFCentral. Returns a list of all registered Asset Management Companies with their codes, names, RTA codes, and website URLs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mfcentral-com-api-40e8100e/get_all_fund_houses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_faqs

Retrieve categorized FAQs from the MFCentral help center. Returns questions and answers grouped by topic such as General, Signup & Signin, Service Requests, Portfolio & CAS, and many more.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mfcentral-com-api-40e8100e/get_faqs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_fund_categories

Retrieve the top-level mutual fund categories, subcategories, AMC details, fund size ranges, and risk categories available on the platform.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mfcentral-com-api-40e8100e/get_fund_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_fund_details

Get detailed information for a specific mutual fund scheme by its ISIN, including NAV history, sector-wise allocation, company holdings, SIP/SWP/STP options, and sub-plans.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `isin` | string | Yes | ISIN code of the mutual fund scheme (12-character alphanumeric code starting with 'INF', e.g., 'INF200K01644'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mfcentral-com-api-40e8100e/get_fund_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"isin":"<string>"}'
```

### search_mutual_fund_scheme

Search for mutual fund schemes by name keyword. Performs a case-insensitive substring match on scheme names across available schemes. Due to upstream response size, approximately 6000+ schemes are searchable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against scheme names (e.g., 'Mirae', 'HDFC', 'Nifty'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mfcentral-com-api-40e8100e/search_mutual_fund_scheme \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```
