Kotak Securities APIkotaksecurities.com ↗
Access Kotak Securities mutual fund NAV, holdings, sector allocation, market indices, and top gainers via 6 structured JSON endpoints.
What is the Kotak Securities API?
The Kotak Securities API exposes 6 endpoints covering mutual fund listings, detailed NAV and AUM data, top equity holdings, sector allocations, major market indices, and top-gaining NSE Nifty 50 stocks. The get_mutual_fund_detail endpoint returns fields like expense ratio, risk score, minimum investment, and 1/3/5-year returns for any fund identified by its slug. Market data endpoints surface live SENSEX, NIFTY, and NIFTY BANK prices alongside the day's top gainers.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ea37b5c4-a03f-49cb-a440-b41b9f52ebec/list_mutual_funds' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace kotaksecurities-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Kotak Neo API — mutual funds, market data, brokerage plans."""
from parse_apis.kotak_neo_api import KotakNeo, FundNotFound
client = KotakNeo()
# List available mutual funds and pick the first one
fund_summary = client.mutualfundsummaries.list(limit=5).first()
print(f"First fund: {fund_summary.name} (slug={fund_summary.slug})")
# Get full details for this fund via the summary's navigation method
detail = fund_summary.details()
print(f"NAV: {detail.nav}, AUM: {detail.aum} Cr, Category: {detail.category}")
print(f"Returns: 1Y={detail.returns.one_year_return}%, 3Y={detail.returns.three_year_return}%")
# Get holdings breakdown for the same fund
holdings = fund_summary.holdings()
for h in holdings.equity:
print(f" Holding: {h.company} — {h.weight}%")
for s in holdings.sector_distribution:
print(f" Sector: {s.sector} — {s.weight}%")
# Check market indices
for index in client.marketindexes.list(limit=5):
print(f"{index.name}: {index.price} (change: {index.change})")
# Top gaining stocks today
for stock in client.stocks.top_gainers(limit=3):
print(f"{stock.symbol}: {stock.price} ({stock.change})")
# Typed error handling: attempt to fetch a non-existent fund
try:
client.mutualfunds.get(slug="non-existent-fund-xyz")
except FundNotFound as exc:
print(f"Fund not found: {exc.slug}")
# Brokerage plans
for plan in client.brokerageplans.list(limit=5):
print(f"Plan: {plan.name}")
print("Exercised: mutualfundsummaries.list / details / holdings / marketindexes.list / stocks.top_gainers / mutualfunds.get / brokerageplans.list")
List available mutual funds with their slugs and names. Returns a curated list of popular funds displayed on the Kotak Neo mutual funds page. Each fund carries a slug usable as input to get_mutual_fund_detail and get_mutual_fund_top_holdings.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of fund summary objects with name and slug"
},
"sample": {
"data": {
"items": [
{
"id": null,
"name": "Parag Parikh Flexi Cap",
"slug": "parag-parikh-flexi-cap-fund"
},
{
"id": null,
"name": "Nippon India Large Cap Fund",
"slug": "nippon-india-large-cap-fund"
}
]
},
"status": "success"
}
}About the Kotak Securities API
Mutual Fund Data
The list_mutual_funds endpoint returns a catalogue of popular funds available on Kotak Neo, each with a name and slug. Pass that slug to get_mutual_fund_detail to retrieve the fund's nav, aum (in crores), expenseRatio, minInvestment, risk score, rating, category, and a returns object containing oneYearReturn, threeYearReturn, fiveYearReturn, and overallReturn as floats. No additional input parameters are required beyond the slug.
Holdings and Sector Allocation
get_mutual_fund_top_holdings accepts the same slug and returns two arrays: equity, listing up to five holdings with company name and percentage weight, and sector_distribution, covering full sector allocation with corresponding weights. These fields are useful for portfolio overlap analysis or visualizing fund composition without managing a separate data ingestion pipeline.
Market Indices and Movers
get_market_indices returns current price and change values for SENSEX, NIFTY, and NIFTY BANK. get_top_gainers delivers the day's top-performing Nifty 50 stocks with symbol, price, and a formatted change string (e.g. +450.50(+4.72%)). The get_brokerage_plans endpoint returns plan names from the Kotak Neo pricing page, useful for surfacing current brokerage tier names.
Identifiers and Workflow
Fund slugs (e.g. hdfc-flexi-cap-fund, nippon-india-large-cap-fund) are the primary key for fund-level endpoints. The recommended workflow is to call list_mutual_funds first to enumerate valid slugs, then fan out to get_mutual_fund_detail and get_mutual_fund_top_holdings for richer data. No authentication or user-specific parameters are required for any endpoint.
The Kotak Securities API is a managed, monitored endpoint for kotaksecurities.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when kotaksecurities.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official kotaksecurities.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display mutual fund NAV and expense ratio comparisons across multiple Kotak-listed funds.
- Build a portfolio overlap tool using sector distribution weights from get_mutual_fund_top_holdings.
- Track daily SENSEX, NIFTY, and NIFTY BANK movements using get_market_indices.
- Alert users to top Nifty 50 gainers in a trading dashboard using get_top_gainers.
- Surface 1-year, 3-year, and 5-year return data to help investors compare fund performance.
- Enumerate brokerage plan names from get_brokerage_plans for a Kotak Neo product comparison page.
- Filter mutual funds by minimum investment amount using the minInvestment field for SIP calculators.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Kotak Securities offer an official developer API?+
What does get_mutual_fund_detail return, and does it include SIP-specific data?+
minInvestment field reflects lumpsum minimums. Dedicated SIP minimum amounts are not currently in the response. You can fork this API on Parse and revise it to add an endpoint covering SIP-specific investment thresholds.How many equity holdings does get_mutual_fund_top_holdings return?+
Is historical price or index time-series data available from these endpoints?+
get_market_indices endpoint returns current prices and day-change values for SENSEX, NIFTY, and NIFTY BANK, and the fund return fields cover 1/3/5-year aggregate figures. Point-in-time historical OHLCV series are not exposed. You can fork this API on Parse and revise it to add a historical data endpoint if the underlying source exposes it.Does the mutual fund list cover all funds on the Kotak Neo platform, or only a subset?+
list_mutual_funds endpoint returns a curated list of popular funds displayed on the Kotak Neo mutual funds page, not the full fund universe available on the platform. Coverage is limited to what appears on that page at the time of the request.