greeksoup/ docs
Brokers

Upstox

India. An API key and secret from the Upstox developer console, free for its clients, and a login every trading day. Upstox serves live prices at no charge. 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, and the redirect address if it differs from the desk's; then the day's login each trading morning Daily loginYes; every token ends at 3:30 in the morning the next day The desk showsHoldings and cash at Upstox's own prices; live prices with the buy and sell quotes

Where the keys come from

In the Upstox developer console create an app. Set its 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. Upstox says "All trading + data APIs are free of cost".

On Settings

Pick Upstox · India, paste the key and the secret, and click Save and connect. Leave Redirect address empty if the app uses the desk's Settings address; otherwise put in the address exactly as you registered it. The desk saves the keys and then asks for today's login.

Every trading morning

Click Open the broker login. Log in on Upstox's page. When it finishes, the page jumps to your redirect address with code= 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 code= (or the whole address) into the box and click Connect. The code works once and lasts a few minutes, so paste it straight away.

Upstox issues no longer-lived key, so this is a daily job. Skip it and the desk keeps showing the last saved book, re-priced live through Yahoo, with a ribbon saying the session is off. A stale session comes back as "Upstox's session for today is not valid". Every other screen is unaffected.

What Desk · Home shows

Every holding with quantity, average cost and the price Upstox reports for it, and cash from the funds and margin read. A line Upstox does not price is marked from Yahoo.

The desk asks Upstox for live prices on Watch · Home and the ticker page, with the buy and sell quotes. Upstox names each stock by its ISIN, and the desk finds the ISIN for each name by itself. If Upstox refuses prices on the account, the desk uses the free feed (Yahoo) for the rest of the session.

The home ticker page shows the exchange's filings, and the results calendar for the home watchlist sits under Desk · Home.

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. Nothing places an order.