Sharenox
 ← Back to Terminal
📖 Setup Guide · ~10 min read

Connect Zerodha Kite to Sharenox

A complete walkthrough — from creating your Kite Connect app to placing your first order through Sharenox terminal. Includes the SEBI-mandated IP whitelisting step that breaks most setups.

Steps

  1. Create a Kite Connect app
  2. Choose plan: Personal (Free) vs Connect (₹500/mo)
  3. Set the Redirect / Callback URL
  4. Whitelist Sharenox server IP (critical)
  5. Save API Key & Secret in Sharenox profile
  6. Daily login — token refresh after 6 AM IST
  7. Troubleshooting common errors
  8. FAQ
1

Create a Kite Connect app

Kite Connect is Zerodha's official trading API. To use Sharenox terminal, you need a Zerodha demat/trading account first — if you don't have one, sign up at zerodha.com.

Once you have a Zerodha account:

  1. Visit developers.kite.trade and log in with your Zerodha credentials.
  2. Click My Apps in the top nav.
  3. Click Create new app.
  4. Pick a name (e.g., "Sharenox Terminal") and a category — keep it simple.
💡 Tip The app name is just for your reference. It doesn't affect anything functional.
2

Choose plan: Personal (Free) vs Connect (₹500/mo)

Kite Connect currently has two tiers. Most Sharenox users need the paid Connect plan — here's the difference:

Feature Personal (Free) Connect (₹500/mo)
Place / modify / cancel orders ✓ Yes ✓ Yes
Holdings & positions read ✓ Yes ✓ Yes
WebSocket live tick data ✗ No ✓ Yes
Historical OHLC data ✗ No ✓ Yes
Sharenox Live Tracking page ✗ Will not work ✓ Works fully
LTP streaming in terminal ✗ No ✓ Real-time
Watchlist price alerts ✗ No ✓ Yes
⚠️ Important — billing is credit-based Kite Connect does not charge a fixed monthly subscription directly. Instead it uses a credit system: 1 credit = ₹1. You add ₹500 credits to your Kite Connect account, and they are deducted each month for the Connect plan. Credits can be added via Razorpay (card/netbanking/UPI) or by linking your Zerodha trading account for auto-renewal.

To add credits: Go to developers.kite.trade → Billing → Add ₹500 credits (or link Zerodha account for auto-renewal).

💡 Which plan is right for you? If you only want to place orders manually — Personal (free) works. But the moment you open Sharenox's Live Tracking, watchlist LTP streaming, or price alerts, you'll see "WebSocket: Not Connected" errors. The Connect plan (₹500/mo) unlocks all real-time features.
3

Set the Redirect / Callback URL

This URL tells Kite where to send users after they log in. It must match Sharenox's callback exactly — even one extra slash or a typo will fail with a confusing error.

In your Kite Connect app's settings, paste this into the Redirect URL field:

https://api.sharenox.com/api/kite/callback
⚠️ Common mistake Don't use https://sharenox.com/... (no api. subdomain). Kite will redirect, but the callback handler lives on the API subdomain. Use the URL above exactly as shown.
4

Whitelist Sharenox server IP (critical, SEBI mandate)

As of March 2026, SEBI requires that every API call to a broker originate from an IP address registered with the broker. Without this step, every Sharenox order will fail with 403 Forbidden or IP not whitelisted errors.

In your Kite Connect app's settings, find the Allowed IPs field and paste this IP:

Loading…
⚠️ This IP can change Sharenox runs on Render's infrastructure. Render rotates outbound IPs occasionally (usually after major deploys or platform maintenance — typically rare, but possible). If trading suddenly fails after a working setup, refresh this page and re-add the new IP to your Kite app.
💡 Multi-IP support Kite's Allowed IPs field accepts a comma-separated list. To future-proof, you can leave the old IP and add the new one — Kite will accept calls from any listed IP.

The same IP is also displayed in Sharenox's terminal execution log on every page load — search for "Sharenox outbound IP" in the log panel.

5

Save API Key & Secret in Sharenox profile

Once your Kite Connect app is configured, it shows two credentials — API Key and API Secret. These are like a username/password pair Sharenox uses to talk to Kite on your behalf.

  1. From your Kite Connect app's dashboard, copy the API Key.
  2. Click Show next to the API Secret and copy it too. The secret is shown only once — store it safely. If you lose it, regenerate.
  3. In Sharenox, go to Profile → Edit.
  4. Paste both values into the Kite API Key and Kite API Secret fields.
  5. Save.
🔒 Security API secrets are stored encrypted in Sharenox's database and never displayed back in plaintext. They're only used to negotiate session tokens with Kite, never logged or shared.
6

Daily login — token refresh after 6 AM IST

Per Zerodha policy, every Kite Connect access token expires daily at 6:00 AM IST. This is non-negotiable — Sharenox cannot keep you logged in beyond that. Treat it like clearing customs every morning.

The flow each morning:

  1. Open Sharenox Terminal.
  2. You'll see Kite: Not Connected in the top bar.
  3. Click 🔑 Kite Login (top right).
  4. You're redirected to Kite's login page — enter your Zerodha PIN/2FA.
  5. Kite sends you back to Sharenox automatically. Status changes to Kite: Connected.

Total time: ~5 seconds, once per trading day.

💡 Pro tip Do this before 9:00 AM, before pre-open session. If you wait until 9:15 and the market opens, you'll miss the first few minutes while logging in.
⚠

Troubleshooting common errors

"Token is invalid or has expired"

Your daily access token expired (after 6 AM IST). Click 🔑 Kite Login again.

"403 Forbidden" or "IP not whitelisted"

Go back to Step 4. The Sharenox server IP has likely changed — copy the latest IP from above and update your Kite app's Allowed IPs.

"Insufficient permission" on LTP / Historical data

You're on the Personal (free) plan but trying to use WebSocket / real-time data features. Add ₹500 credits and upgrade to the Connect plan in Billing. See Step 2.

"Invalid redirect URI"

The Redirect URL in your Kite app doesn't match Sharenox's callback. Re-paste the URL from Step 3 exactly — no trailing slash, lowercase, with the api. subdomain.

"Please add your Kite API Key in your profile"

You skipped Step 5. Go to Profile → Edit and save your API Key & Secret first.

WebSocket connects but disconnects after a few seconds

Usually IP whitelist mismatch. Verify the current Sharenox IP (Step 4) matches what's in your Kite app's Allowed IPs.

Frequently asked questions

Is Sharenox safe with my Kite credentials?
Sharenox stores only your API Key & encrypted Secret. The actual session token (which authorizes orders) is generated fresh every day via Kite's OAuth flow — Sharenox never sees your Zerodha password or 2FA codes. You log into Kite directly on Zerodha's site each morning.
Can Sharenox place orders without my permission?
No. Every order flows through Kite's API and shows up in your Zerodha order book in real-time. Sharenox cannot bypass Zerodha's risk checks, margin requirements, or order limits. You can also use Kite's Kill Switch in their console to revoke access instantly.
Do I really need the Connect plan (₹500/mo)?
If you only place orders manually and use Sharenox as a smart order pad — no, Personal (free) works. But if you want live tracking, watchlist LTP streaming, intraday alerts, or any real-time price feature — yes, you need Connect (₹500/mo, credit-based). About 80% of active Sharenox users are on the Connect plan.
What if I have multiple Kite Connect apps?
You can. Sharenox stores credentials per user — connect any one of your apps and that's the one Sharenox will use. To switch, update API Key/Secret in Profile and re-login.
Why does the IP keep changing?
Sharenox runs on Render's cloud infrastructure, which assigns outbound IPs from a pool. IPs are usually stable for weeks or months but can rotate after platform-wide maintenance. We're evaluating Render's static-IP add-on for production stability — for now, refreshing the IP in your Kite app takes 30 seconds.
Can I use Sharenox without connecting Kite?
Yes — most Sharenox features (market intelligence dashboard, news feed, blog, virtual trading game, social) work without Kite. You only need Kite for live trading, watchlist LTP, and real-time order placement.
I'm getting a different error not listed above.
Open the Execution Log at the bottom of the terminal — Sharenox logs every Kite API call there. Copy the error and reach out via the contact form, or DM @SharenoxApp on X.

Ready to connect?

Once you've completed all 6 steps, head to the terminal and click 🔑 Kite Login.

Open Sharenox Terminal →