API Endpoints

API Endpoints

Complete mapping of Groww Trade API endpoints used by this MCP server.

Base URL: https://api.groww.in

Authentication

Method	Endpoint	Description
POST	/v1/token/api/access	Generate access token (TOTP or approval)

Portfolio

Method	Endpoint	Description
GET	/v1/holdings/user	Get all holdings
GET	/v1/positions/user	Get open positions
GET	/v1/margin/user	Get margin details
POST	/v1/margin/calculate	Calculate margin for an order

Orders

Method	Endpoint	Description
GET	/v1/order/list	List all orders
GET	/v1/order/detail/{order_id}	Order details
GET	/v1/order/trades/{order_id}	Order trade fills
POST	/v1/order/create	Place a new order
PUT	/v1/order/modify/{order_id}	Modify pending order
DELETE	/v1/order/cancel/{order_id}	Cancel order

Smart Orders (GTT/OCO)

Method	Endpoint	Description
GET	/v1/smart-order/list	List smart orders
POST	/v1/smart-order/create	Create GTT/OCO order
PUT	/v1/smart-order/modify/{order_id}	Modify smart order
DELETE	/v1/smart-order/cancel/{order_id}	Cancel smart order

Market Data (Paid — ₹499/mo)

Method	Endpoint	Description
GET	/v1/live-data/quote	Full quote (OHLC, bid/ask)
POST	/v1/live-data/ltp	Batch LTP (up to 50)
POST	/v1/live-data/ohlc	Batch OHLC (up to 50)
GET	/v1/live-data/option-chain	Option chain with Greeks
GET	/v1/historical/candle	Historical candlestick data

Instruments

Method	Endpoint	Description
GET	/v1/instruments/search	Search instruments
GET	/v1/instruments/detail	Instrument details
GET	/v1/instruments/download	Full instrument CSV

Backtesting (Paid — ₹499/mo)

Method	Endpoint	Description
POST	/v1/backtest/run	Run strategy backtest

User

Method	Endpoint	Description
GET	/v1/user/profile	User profile and account info

Common Headers

All authenticated requests include:

Authorization: Bearer <access_token>
Content-Type: application/json
X-API-VERSION: 1.0

Rate Limits

Category	Requests/sec	Requests/min
Orders (create, modify, cancel)	10	250
Live Data (quote, LTP, OHLC)	10	300
Non-Trading (orders, holdings, positions)	20	500

Error Codes

HTTP Status	Meaning	MCP Behavior
200	Success	Returns formatted data
400	Bad request	Returns error message with details
401	Unauthorized	Auto-refreshes token, retries
403	Forbidden	Returns subscription hint (for paid endpoints)
404	Not found	Returns error with endpoint info
429	Rate limited	Retries with exponential backoff
500	Server error	Retries up to 3 times

Important Notes

• All endpoints require a valid access token except instrument CSV download
• Access tokens expire daily at 6:00 AM IST
• Order placement requires a static IP registered with Groww (SEBI compliance)
• Market data endpoints return 403 without the Live Data subscription
• Endpoint paths were verified against the live Groww API — other MCP implementations may use incorrect paths