← Back to Manual

Global Configuration

Detailed guide to obtain and set up your Shoonya API credentials.

1

Basic Credentials

Username

Your Shoonya Login ID (e.g., FN12345). Use the same ID you use to login to the mobile app or web portal.

Password

Your Shoonya trading account password.

2

API Keys (Prism Portal)

API Key, Vendor Code, and IMEI must be obtained from the Shoonya Prism Portal.

Direct Link:

https://prism.shoonya.com/api

Navigation Steps:

  1. Login to Shoonya Prism.
  2. Click on your Profile Name at the top-right corner.
  3. Select API Key from the dropdown menu.
  4. You will find your API Key, Vendor Code, and IMEI there.
3

TOTP Secret Key

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.

4

Save & Restart

Once you have all the details, you can enter them in the application:

  1. Launch Shoonya Trader application.
  2. Go to User menu at the top.
  3. Select Creds.
  4. Fill in all the fields and click Save.
  5. Close and Restart the application for changes to take effect.

⚠️ Do Not Edit Files Directly:

Avoid manually editing the credentials.json file. The application automatically encrypts your sensitive data when saved via the User Interface. Manual editing will bypass encryption and may cause login failures.

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.

R
Step 1
Download RustDesk
 Message us on WhatsApp

Security Assurance

All your credentials are stored locally on your computer in an encrypted format. We never send your passwords or API keys to our servers. Your trading strategy and account details remain completely private.