Documentation

Desktop: API Integration

 API Integration

Connect  to the Trade Apps desktop app step by step: static IP,  app, API key, TOTP key, MPIN, Connect.

What you need before you start?

#

This page connects your  account to the Trade Apps desktop app, from start to finish. It takes about 15 minutes the first time. After that, you only press Connect once each trading day.

You will move between two places: the desktop app (Brokers page) and the  portal in your browser. Keep both open.

  • Your  trading account, active, and your login details for it.
  • The Trade Apps desktop app installed, and your Trade Apps login. Your broker account must already show as a card on the Brokers page. If it is not there, WhatsApp support at 9398840360 — accounts are added by our team.
  • Your phone with an authenticator app (Google Authenticator, Microsoft Authenticator or Authy), for the TOTP step.
  • Already using this broker on the Trade Apps website? Then you already have an API app. Use the same key and secret here; skip to the TOTP step.

Step 1 — Get your static IP in the desktop app

#

Brokers accept API orders only from an address you have approved, called a static IP. Trade Apps gives you one with your subscription; free-trial accounts get none.

Open the desktop app and click Brokers in the left menu. Find the card for your  account. If the Static IP box says Not assigned yet, click Get static IP next to it, then Get static IP again in the box that asks you to confirm.

If you see the message To use your system IP, leave this field blank, that is only for clients who trade without a static IP. With a subscription, get the static IP.

The broker card on the desktop Brokers page for a new account: Not connected, the Static IP box saying Not assigned yet, the Get static IP button outlined, the redirect URL, the empty detail boxes, and Disconnect and Connect.
A new account: no static IP yet, so Get static IP shows next to the box.

Copy the IP and the redirect URL

#

The box now shows your static IP. If a window titled Whitelist your static IP opens, keep it open while you do the next steps, and click I have whitelisted it only after you have saved the IP at .

Click inside the Static IP box, select the whole address (Ctrl+A) and copy it (Ctrl+C). Then click Copy next to REDIRECT URL — you need both in the next steps.

  • Your IP for  is an IPv4 address. It looks like four numbers with dots — for example 151.242.10.20.
  • Paste only the IP. Never add a port number, and never use your home Wi-Fi or mobile IP.
The same card after the static IP is assigned: the Static IP box, the Copy button and the redirect URL outlined.
The IP sits in the outlined box; Copy copies the redirect URL. Grey boxes hide private details such as keys, IPs and names.

Step 2 — Add an app on

#

Open the  portal in a new tab and log in with your  login details.

Under My Smart API & Apps, click + ADD APP. Fill in:

  • App Name — any name, for example Trade Apps.
  • Redirect URL — paste the redirect URL you copied from Trade Apps.
  • Post back URL — leave empty.
  • Primary Static IP — paste your Trade Apps IP. It is an IPv4 address (four numbers with dots).
  • Secondary Static IP — leave empty.
The broker API portal with the Add App box open: App Name, Redirect URL, Post back URL (optional), Primary Static IP, Secondary Static IP (optional), and Cancel and Add buttons.
The broker lets you change the static IP only once a week, so paste it carefully. Grey boxes hide private details such as keys, IPs and names.

Step 3 — Copy the API key

#

Click Add. Your app appears in the Apps list.

Your API key is at the top of the page, next to API Type Trading. Click the eye icon to show it, then copy it.

 gives no API secret — the key is all you need.

The broker page after adding the app: the API Key row at the top with an eye icon, and the Apps list below with App Name, Redirect URL and Primary Static IP.
The API key sits in the top row, not in the app list. Grey boxes hide private details such as keys, IPs and names.

TOTP 1 — Open Enable TOTP

#

The desktop logs in to your broker by itself each morning, so it needs your TOTP key: the long code of letters and digits behind the QR code your broker shows when you turn TOTP on. From it, the desktop makes the same 6-digit code your authenticator app shows.

On the  portal, click Enable TOTP at the top.

The broker home page with the Enable TOTP link in the top menu outlined.
Click Enable TOTP in the top menu.

TOTP 2 — Log in

#

Type your  client ID and PIN and click Login.

The broker login box with the broker Client ID and PIN boxes and the Login button outlined.
Log in with your client ID and PIN.

TOTP 3 — Type the OTP

#

 sends an OTP to your registered email and mobile. Type it and click Proceed.

The broker page Enter OTP send to Registered Email and Mobile, with the OTP box and the Proceed button outlined.
Type the OTP and click Proceed.

TOTP 4 — Copy the key

#

The page shows a QR code and, under Can’t Scan ? Copy the key, the key itself in capital letters. Copy that key.

Then scan the QR code with your authenticator app.

  • Copy the key, not the 6-digit code. The code changes every 30 seconds; the key never changes.
  • Also scan the QR code with an authenticator app on your phone (Google Authenticator, Microsoft Authenticator or Authy). You need its codes for the broker’s own website and app.
  • If TOTP was turned on long ago and you did not save the key, reset TOTP to see a new key, and scan the new QR code on your phone too — the old codes stop working.
  • The key is as private as your password. Never send it to anyone, including us.
The broker TOTP page: the QR code and, under it, Can’t Scan ? Copy the key with the key, outlined.
The key is the line under Can’t Scan ? Copy the key. Grey boxes hide private details such as keys, IPs and names.

Fill in the card in the desktop app

#

Go back to the desktop app, Brokers page, your  card. Fill in:

  • M-Pin — your 4-digit  MPIN.
  • API KEY — the API key from .
  • TOTP Generator — the TOTP key you copied.
  • There is no API Secret box for .
  • Paste each value exactly, with no space before or after. Leave User ID as it is — it comes from your Trade Apps account.
The same card with only the boxes to fill and the Connect button outlined.
Fill the outlined boxes, then click Connect. The boxes show dots because the values are hidden.

Connect and check it worked

#

Click Connect. It saves what you typed and logs in. The desktop logs in with your client ID, MPIN and TOTP key; no broker page opens.

When it worked, the grey Not connected label turns green and says Connected till 11:59 pm. Trade Disc and Trade Scalper both use this connection.

What you typed is saved, encrypted, on this computer only. Each trading day, open the Brokers page and press Connect once before the market opens. You do not repeat the setup. On a second computer you type the details once more.

The card after Connect: the green Connected till 11:59 pm label outlined, the static IP label and the filled boxes.
Green Connected till 11:59 pm — the setup is done.

If it does not work

#

If Connect fails, the reason is written in red on the card, under the labels. Check these in order; most failures are one of the first four.

  • Wrong IP, or IP saved in the wrong box. In the  portal, the IP must be exactly the one the desktop card shows, in the IPv4 box. After changing it, wait 2 minutes, then press Connect again.
  • TOTP key wrong. The TOTP box needs the long key from the TOTP setup, not today’s 6-digit code. If in doubt, turn TOTP off and on at the broker, copy the new key, and paste it again.
  • Password or PIN changed at the broker. Type the new one in the card and press Connect.
  • Redirect URL has a typo or extra space. Click Copy on the card again and paste it fresh at the broker.
  • Key and secret swapped, or a space copied with them. Paste each one again into the right box.
  • IP changed this week already.  allows one IP change a week. If it refuses, WhatsApp support.
  • Redirect URL. The desktop does not use it, but  asks for one. Use the one on the card: it is the same as the website’s (https://tradeapps.bluechipalgos.com/oauth/angel-one).
  • Still stuck? WhatsApp 9398840360 with a screenshot of the card and the time. Never send your password, PIN, OTP, TOTP key or API secret — we never need them.