Documentation

Desktop: API Integration

 API Integration

Connect  to the Trade Apps desktop app step by step: static IP, Trade API consumer key, TOTP key, mobile number and 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  web platform 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

#

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). This broker needs no redirect URL.

  • 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 outlined.
The IP sits in the outlined box. Grey boxes hide private details such as keys, IPs and names.

Step 2 — Open Trade API

#

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

Click More at the top, then Trade API under Trading tools.

Before you go on, make sure TOTP is set up for your  account (an authenticator app on your phone) and you know your MPIN. You need both every time you connect.

The More menu of the trading platform with Trade API — Create your own trading terminal with APIs — under Trading tools.

Step 3 — Create the application

#

Create a new application ( may already show a Default Application). Its TOKEN — the consumer key — appears under the app name.

Click the arrow on the right to open the application.

The Trade API page with an application listed: app name with its token under it, IP Whitelist, Status Active, and a Reset button and an arrow to open it.
Grey boxes hide private details such as keys, IPs and names.

Step 4 — Add your IP and copy the Consumer Key

#

On the application page, click the pencil on Primary IP and paste your Trade Apps IP. Your  IP is IPv4. Save.

Copy the Consumer Key at the top with its copy icon. Do not press Reset API Credentials — it would make the old key stop working.

The application page: Consumer Key with a copy icon, Primary IP and Secondary IP boxes each with a pencil and a delete icon, and a Reset API Credentials button.
Grey boxes hide private details such as keys, IPs and names.

TOTP 1 — Open Trade API

#

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.

In , click More at the top, then Trade API under Trading tools.

The broker More page with the More tab and the Trade API tile outlined.
Click More, then Trade API. Grey boxes hide private details such as keys, IPs and names.

TOTP 2 — Open TOTP Registration

#

On the Neo Trade API page, click Menu at the top right and choose TOTP Registration.

The Neo Trade API page with the Menu button and TOTP Registration in its list outlined.
Click Menu, then TOTP Registration.

TOTP 3 — Copy the Setup Key

#

The panel shows a QR code and a Setup Key (hidden as stars). Click the copy icon on its right to copy the key.

Scan the QR code with your authenticator app and type its 6-digit code in the boxes.

The TOTP Registration panel: the QR code, the Setup Key row with its copy icon outlined, and six boxes for the code.
Copy the Setup Key with the copy icon. Grey boxes hide private details such as keys, IPs and names.

TOTP 4 — Done

#

 shows TOTP Registration Successfully Done. Click Done.

  • 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 TOTP Registration Successfully Done panel with the Done button outlined.
Click Done.

Fill in the card in the desktop app

#

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

  • Consumer key — the Consumer Key from Trade API.
  • Mobile number — the 10-digit mobile number registered with . The desktop adds +91 for you.
  • M-Pin — your  MPIN.
  • TOTP Generator — the TOTP key you copied.
  •  needs no API Secret and no redirect URL.
  • 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 mobile number, MPIN and TOTP key; no broker page opens and no box asks for a code.

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  web platform, 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.
  • Key and secret swapped, or a space copied with them. Paste each one again into the right box.
  • Reset API Credentials pressed. The old consumer key stops working. Copy the new Consumer Key into the card and press Connect.
  • 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.