DOWNLOAD

While25 Terminal

Paper trading, backtesting, and real-time market data for NSE, BSE, and MCX. Runs entirely on your machine — no cloud subscription required.

v1.0.0-beta.1EARLY BETA

⬇ Download for macOS.dmg · macOS 12 Monterey or later ⬇ Windows (.exe)

📋 PAPER TRADING ONLY

Live order execution is not available in this version. While25 is currently a market data, paper trading, and backtesting tool — no real orders are ever sent to your broker. Live trading will be supported when we launch the cloud-hosted terminal.

⚠ BETA SOFTWARE

Early-access software — you may encounter crashes, incomplete features, or unexpected behaviour. Antivirus software and OS security gates (Windows SmartScreen, Gatekeeper) may flag the installer — this is normal for unsigned early-access apps. See the installation guide below.

SYSTEM REQUIREMENTS

What you need to run it.

⊞Windows

· Windows 10 or 11 (64-bit)
· 4 GB RAM minimum, 8 GB recommended
· 500 MB free disk space
· Internet connection (for Upstox market data)

macOS

· macOS 12 Monterey or later
· 4 GB RAM minimum, 8 GB recommended
· 500 MB free disk space
· Internet connection (for Upstox market data)

INSTALLATION

Install in three minutes.

Download the .dmg file

Click the Download for macOS button above. Safari will save While25.dmg to your Downloads folder.

Open the DMG

Double-click While25.dmg. A window will appear — drag the While25 icon into the Applications folder.

First launch — macOS Gatekeeper warning

When you double-click While25 for the first time, macOS may show:

"While25 cannot be opened because it is from an unidentified developer."

This happens because the app is not yet Apple-notarised (we are in the process). You have two ways to open it:

OPTION A — System Settings (easiest)

Open System Settings → Privacy & Security
Scroll down to the Security section
You should see "While25 was blocked…" — click Open Anyway
Enter your Mac password if prompted, then click Open

OPTION B — Terminal command (one-liner)

Open Terminal (press ⌘ Space, type "Terminal") and run:

xattr -d com.apple.quarantine /Applications/While25.app

This removes the quarantine flag macOS sets on downloaded files. It does not change the app binary. After running the command, double-click While25 normally.

⚠ IMPORTANT — from the DMG too

If you run While25 directly from the DMG (without moving to Applications), run the command on the DMG path instead:

xattr -d com.apple.quarantine ~/Downloads/While25.dmg

We recommend always moving to Applications first.

UPSTOX API SETUP

Connect Upstox for market data.

While25 uses Upstox's official OAuth API to stream market data and simulate paper trades. You need your own API key — it takes about 10 minutes to set up. One-time process.

ℹ PREREQUISITE — UPSTOX DEMAT + TRADING ACCOUNT

While25 works exclusively with Upstox. You need an active Upstox demat + trading account before any of the steps below. If you trade on Zerodha, ICICI Direct, Angel One, etc. — those brokers are not supported yet. Opening an Upstox account is free (no account opening charges, ₹0 equity delivery brokerage). Visit upstox.com to open one. Account activation typically takes 1–2 working days after document submission.

Open account.upstox.com/developer/apps in your browser. Log in with your Upstox UCC ID and password (same credentials you use on the Upstox Pro web platform).

Select an app type

Click New App. Upstox will ask you to select an app type.

Select “Personal”. Personal is sufficient for market data, paper trading, and backtesting. You do not need the Algo Trading App type — that is only required for live automated order placement, which is not supported in this version.

Fill in the app details

App Name — any name you like, e.g. While25 or My Trading Terminal
Redirect URL — enter exactly:
```
http://127.0.0.1
```
This is the local address While25 uses to capture the Upstox auth token after you log in. It must match exactly — no trailing slash, no port number.
App Description — optional, fill in anything

Click Create. You will be taken to the app detail page.

Copy your API Key and API Secret

On the app detail page, you will see:

API Key (also called Client ID) — a long alphanumeric string
API Secret (also called Client Secret) — keep this private, do not share it

Copy both. You will paste them into While25 in step 7.

Open While25 → Settings → paste your credentials

Launch While25. On first launch, you will be shown the Upstox configuration screen. Paste:

Your API Key (from step 4)
Your API Secret (from step 4)

Then click Authenticate with Upstox. A browser window will open — log in with your Upstox account. After login, you will be redirected back and While25 will confirm a successful connection.

Done — market data and paper trading are live

Once authenticated, While25 will show your portfolio, positions, and live market data. The access token auto-refreshes daily at login.

✓ Market data, paper trading, and backtesting are available immediately.
Live order execution is not available in this version. It will be enabled in a future cloud-hosted release.

⚠ ONE APP PER UPSTOX ACCOUNT

Upstox allows only one active API app per account. If you already have an existing app, creating a new one will replace it. If you use any other API-based tool alongside While25, configure both tools to use the same API key.

NEED HELP?

Stuck on the setup? Drop us a message on the contact page — include your OS, the step you're on, and what error you saw.

CONTACT SUPPORT →