Finvasia

This page shows how to set up a Finvasia account. Finvasia is also known as Shoonya. The setup has three steps, in order.

Demo video

Step 1 – Set up the API key

1. Login to https://trade.shoonya.com/
2. Click on your profile (login id) at the top right
3. Click on the API key button at the top right
4. Click on the API key, then click generate and copy it from there
5. URL: https://webx.stocksdeveloper.in/auth/finvasiaCopy

Step 2 – Set up TOTP

1. Install the Google Authenticator app on your phone
2. You need the secret key that Shoonya provides when you enable TOTP
3. Login to the Shoonya website, then:
   1. Click on your login id at the top right corner
   2. Click security (see screenshot 1 below)
   3. Click TOTP
   4. You will be shown your secret TOTP key. You need to enter this in AutoTrader Web (see screenshot 2 below)

Step 3 – Add your account

1. Go to the AutoTrader Web create-account menu (Accounts -> Trading Accounts) and:
   1. Select your broker as Finvasia
   2. Select platform KAMBALA_FIN_IPV6. This is the recommended choice and is already selected for you.
   3. Enter your trading platform login id and password
   4. Enter your TOTP Key
   5. Enter your API Secret Code
   6. Click the Validate button
   7. On successful validation, save the account
2. That is it. You have added your Finvasia account.

Do not forget to read the known Finvasia limitations.

Screenshots

1. Finvasia – TOTP menu

---

2. How to copy the security key

If you see “User Not enabled on API”

If validation fails with “Invalid Input : User Not enabled on : API”, it means API access is not yet active for your account at Finvasia. AutoTrader Web cannot enable this — only the broker can.

1. Log in to Finvasia (Shoonya) and make sure API access is turned on for your account, as shown in Step 1 above.
2. If you have just generated the API key, give it some time to become active at the broker before you try again.
3. If it still fails, contact Finvasia and ask them to enable API access for your account.

Once the broker enables it, validate the account again in AutoTrader Web.

Static IP setup

Finvasia supports IPv6 static IPs, so your Finvasia account uses a Premium static IPv6 — ₹100 per month, inclusive of all taxes. It is the cheapest and fastest option we offer, and you get two addresses for that one price: a primary and a backup.

Take it from the Static IP button on the account, then register both addresses with Finvasia so a spare is always ready.

Because Finvasia supports IPv6, we do not offer the Standard IPv4 pool option on it. If you specifically need an IPv4 address, the only route is to bring your own IP, which we never charge for — though we do not recommend it here, since IPv6 is faster and costs less.

The rest of the 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)

Already using Finvasia on IPv4?

Existing Finvasia accounts were set up on the older KAMBALA_FIN_IPV4 platform. That platform is being retired, and IPv6 is faster and costs ₹100 instead of ₹200 per month.

You need to move this account. An account still on KAMBALA_FIN_IPV4 cannot be recharged, so its licence will lapse once it expires. The account keeps trading normally until then — move it any time before your next recharge is due.

To move:

1. Open the account under Accounts → Trading Accounts and change the platform to KAMBALA_FIN_IPV6.
2. A note appears asking you to save the platform change first. Click Save platform change and confirm — the account is saved and opens again on the same screen.
3. Click the Static IP button and take your Premium static IPv6.
4. Register the new primary and backup addresses with Finvasia, and remove your old IPv4 address there.
5. Place a small test order to confirm everything works.

Your old IPv4 static IP is released automatically when you switch, and you are not charged for it again.

Bracket and cover orders on Finvasia

Whether Finvasia offers a bracket or a cover order of its own — and in which segments — is set by the broker, and it can change. 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 Finvasia 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 Finvasia 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.