greeksoup/ docs
Brokers

Zerodha

India. A Kite Connect app and a login every trading day. Live prices come through the paid Kite Connect plan. The Indian market file serves the home screens.

MarketIndia; the home screens take the Indian shape (NSE hours, NIFTY 50, rupees, the NSE results calendar and filings) You pasteAPI key, API secret; then the day's login each trading morning Daily loginYes; the session ends at six in the morning the next day The desk showsHoldings and cash; live prices with the buy and sell quotes on the paid Kite Connect plan

Where the keys come from

At developers.kite.trade create a Kite Connect app. Set the app's redirect address to this desk's Settings address, http://localhost:8765/settings, so the daily login can land in the page by itself. Copy the API key and the API secret.

Kite Connect comes in two plans. The paid plan costs ₹500 a month per app, and in Zerodha's words it gives "access to live market data and historical data at no additional cost". The free Personal plan "does not include live market data"; the desk still reads holdings and cash on it, and prices your watchlist from the free feed.

On Settings

Pick Zerodha (Kite Connect) · India, paste the key and the secret, and click Save and connect. The desk saves them and then asks for today's login.

Every trading morning

Click Open the broker login. Log in on Zerodha's page. When it finishes, the page jumps to your redirect address with request_token= in it; if that is the desk's Settings address, the desk exchanges it for the day's session on its own and connects. Otherwise copy the value after request_token= (or the whole address) into the box and click Connect.

Skip the login and the desk keeps showing the last saved book, re-priced live through Yahoo, with a ribbon saying the session is off. Every other screen is unaffected.

What Desk · Home shows

Every holding with quantity, average cost and the price Zerodha reports for it, and cash from the margins read. A line Zerodha does not price is marked from Yahoo through its NSE or BSE symbol.

On the paid plan the desk asks Zerodha for live prices on Watch · Home and the ticker page, with the buy and sell quotes. If Zerodha refuses prices on the account, as it does on the Personal plan, the desk uses the free feed (Yahoo, fifteen to twenty minutes behind in the session) for the rest of the session. Watch · Home takes NSE and BSE symbols either way.

The home ticker page shows the exchange's filings: quarterly results, shareholding and the last ninety days of announcements. The results calendar for the home watchlist sits under Desk · Home, and Macro carries the ten-year, the repo rate and CPI.

What it does not show

No streaming ticks, no futures and options, no margin bar, no options tape: this file reads holdings, cash and prices. Those are optional additions a broker file can grow, and another broker describes the shape; an agent can add them from Zerodha's documentation. Nothing places an order.