Global Configuration
Detailed guide to obtain and set up your Shoonya API credentials.
Basic Credentials
SHOONYA_LOGIN_USERNAME
Your Shoonya Login ID (e.g., FN012345). Use the same ID you use to login to the mobile app or web portal.
SHOONYA_PASSWORD
Your Shoonya trading account password.
API Keys & Redirect URL (Shoonya Portal)
API Key, Vendor Code, and API Secret Code (SHOONYA_SECRET_CODE) must be obtained from your Shoonya profile portal.
Direct Link:
https://trade.shoonya.com/Navigation & Configuration Steps:
- Login to trade.shoonya.com.
- Click on your Profile/Client ID at the top-right corner and select API Key.
- You will find your
SHOONYA_SECRET_CODE(API Secret Code),SHOONYA_CLIENT_ID(Vendor Code), and other details. - Set Redirect URL: Enter
https://trade.shoonya.com/OAuthlogin/in the Redirect URL field. - Registered IP: Enter your registered public IP address in the configuration and click update/save settings.
SHOONYA_TOTP_SECRET
The TOTP Secret is required for the application to automatically generate 2FA codes during login.
Method A (Trading Site)
Login to trade.shoonya.com
- Go to Profile
- Click Security
- Select TOTP
- Copy the alphanumeric TOTP Code
Method B (Beta Site)
Login to beta.shoonya.com
- Go to Profile
- Click Settings
- Select Set TOTP
- Copy the alphanumeric TOTP Code
⚠️ Important Note:
Ensure you copy the Secret Key (alphanumeric string), not the 6-digit dynamic OTP. If you have already enabled TOTP, you might need to disable and re-enable it to see the secret key again.
Can I skip this?
Yes. If you don't provide the TOTP secret, the application will simply ask you to manually enter the 6-digit TOTP code from your mobile authenticator app (Google Authenticator, Microsoft Authenticator, etc.) during every login.
Save & Restart
Once you have all the details, you can enter them in the application:
- Launch Shoonya Trader application.
- Go to User menu at the top.
- Select Creds.
- Fill in all the fields and click Save.
- Close and Restart the application for changes to take effect.
⚠️ Important Note:
All credentials are saved locally in the root .env file. No sensitive data is stored on external servers except Finvasia.
Need Help with Config?
If you are finding it difficult to get your API keys or TOTP secret, our support team can help you remotely via RustDesk.
Security Assurance
All your credentials are stored locally on your computer in the root .env file. We never send your passwords or API keys to our servers. Your trading strategy and account details remain completely private.