Upstox

This guide shows how to add an Upstox account in AutoTrader Web, the multi-account, multi-broker trading platform from Stocks Developer.

Demo video

Step 1 – Set up the Upstox API app

1. Go to the Upstox API apps dashboard.
2. Click the New App button.
3. Enter the following details for the app:
   • App Name: Stocks Developer
   • Redirect Url: https://webx.stocksdeveloper.in/auth/upstoxCopy
   • Postback Url: https://apix.stocksdeveloper.in/postback/upstoxCopy
   • Static IP: see Static IP Setup below
   • Keep other options blank (they are optional)
   • Tick “I accept terms”
   • Click Done
4. Once your app is created, Upstox shows the following fields. You need them in Step 2:
   • API Key
   • API Secret

Step 2 – Enable TOTP

Note: if you already have your TOTP KEY saved, you can skip this step.

1. Log in to Upstox.
2. On the top right of the screen, open the menu (My Account -> My Account).
3. In the My Account section, look for Time-based OTP (TOTP).
   • If you have never enabled TOTP, click Enable TOTP.
   • If you already have TOTP enabled, click Reset TOTP.
   • Look for Unable to scan, click to copy the key (see screenshot below).
   • Copy the key and save it in notepad. You need it in Step 3.
   • Open any Authenticator app (such as Google Authenticator, Microsoft Authenticator, Authy, etc.) on your smartphone.
   • Click “Scan a QR code” under the Add an Account section and allow access to the phone camera.
   • Enter the 6-digit totp shown in the Google Authenticator app.
   • Click ENABLE TOTP.

Step 3 – Add your account in AutoTrader Web

1. Go to the AutoTrader Web menu (Accounts -> Trading Accounts).
2. Click the Create button.
3. Select Broker as Upstox.
4. Select platform as UPSTOX_API_AT_IPV6.
5. Enter the 6-digit PIN.
6. Enter the TOTP Key.
7. Enter the Phone number registered with your Upstox account.
8. Enter the API Key.
9. Enter the API Secret.
10. Click the Validate button.
11. On successful validation, click save to add the account.

That’s it. You have successfully added your Upstox account. Do not forget to read these known limitations.

Static IP Setup

The static IP setup is the same for every broker. Follow the full guide here:

Static IP Setup — set up a static IP or bring your own (BYOIP)

Bracket and cover orders on Upstox

Upstox does not offer a bracket order through the interface AutoTrader Web connects to, so you cannot place one on Upstox directly. You are not doing anything wrong if you went looking for it and could not find it — many Indian brokers withdrew bracket orders in 2020 and never brought them back.

You can place one anyway. An AutoTrader bracket order (AT_BO) attaches a target and a stop-loss to your Upstox order, with an optional trailing stop that follows the price in your favour and never moves back. An AutoTrader cover order (AT_CO) is the same thing with a stop-loss only. Your entry reaches Upstox as an ordinary intraday order — the one thing every broker accepts — and AutoTrader Web watches the price and sends the closing order when your level is reached.

Place one from the order window, from your own code, or from a chart alert. It is intraday only, it does not give you the extra intraday margin some brokers give on their own bracket orders, and the position is squared off automatically a short while before the market closes.

Read the risk before you use it. A stop-loss decides when we try to exit — it does not decide the price you get. A sudden move can take the price straight past your level, so your loss can be larger than the stop-loss you set. The full explanation, and the one-time terms you agree to before your first one, are on Bracket & Cover Orders.