Broker Login & API Setup

To see live market data, option chain, and place orders, you need to connect BrilliantBull Pro with your Zerodha (Kite) account. This guide covers the Broker page — the first screen you see after license activation.

Broker Page Overview

After license activation (or every time you re-launch the app), the Broker page opens automatically. This is your gateway to live trading.

What you'll see on the Broker page:

• Broker Selection — dropdown to choose broker (currently Zerodha/Kite)
• API Key field — paste your Kite Connect API key here
• API Secret field — paste your API secret (kept encrypted on your PC)
• User ID field — your Zerodha client ID (e.g., AB1234)
• "Login" button — opens Zerodha's secure login page in your default browser
• "Test Connection" button — verifies your credentials without full login
• Status indicator — shows 🟢 Connected or 🔴 Disconnected
• Saved Profile dropdown — if you've logged in before, select your saved profile

Getting Your Kite API Keys (First Time)

Zerodha's Kite Connect API gives BrilliantBull access to your account. You need to subscribe to Kite Connect (₹500/month, payable to Zerodha separately) and generate API credentials.

1. Visit developers.kite.trade and log in with your Zerodha credentials.
2. Click "Create new app" button in the dashboard.
3. Fill the app details:
   • App name: Anything, e.g., "My Trading App"
   • App type: Connect
   • Redirect URL: https://localhost (or leave default)
   • Description: optional
4. Subscribe to Connect API — ₹2,000 one-time + ₹500/month via Kite.
5. Once approved, you'll see your API Key and API Secret.
6. Copy both values carefully.
7. Paste them in the BrilliantBull Broker page fields.
8. Click "Save Profile" — now the app remembers these keys (stored encrypted locally).

Daily Login Process

Zerodha's API requires a fresh login token each trading day. This is a security feature by Zerodha, not by BrilliantBull. The daily process is very quick:

1. Open BrilliantBull → Broker page appears.
2. Click "Login" button.
3. Your default browser opens with Zerodha's login page.
4. Enter your Zerodha User ID (e.g., AB1234) and password.
5. Enter TOTP from your authenticator app.
6. Browser briefly redirects and shows a URL with a token.
7. BrilliantBull automatically captures the token — you'll see 🟢 Connected.
8. Done! The full app loads with the Option Chain as the main screen.

When & Why Tokens Expire

All Zerodha API tokens expire at 6:00 AM IST every day. This means you must re-login through the Broker page each morning before your trading session.

• Typical login time: 10-20 seconds
• BrilliantBull will auto-detect expired tokens and prompt you
• Your API Key & Secret don't change — only the daily access token regenerates
• If you forget and try to see live data with an expired token, the app shows a "Session Expired" notification

Common Issues

"Invalid API credentials" error

This means API Key or Secret was typed/pasted incorrectly. Go back to developers.kite.trade, copy fresh keys (no extra spaces), and paste again.

Browser doesn't open on clicking "Login"

Check if Windows has a default browser set. Right-click the browser (Chrome/Edge) → "Set as default". Also ensure your firewall isn't blocking BrilliantBull.

Token captured but status stays "Disconnected"

Close the app, re-open, and try again. If it persists, check your internet connection and Zerodha's system status at status.zerodha.com.

"Subscription expired" from Zerodha

Your Kite Connect subscription is monthly (₹500). Log in to developers.kite.trade and renew. This is separate from BrilliantBull subscription.