Documentation

Desktop: API Integration

 API Integration

Connect  to the Trade Apps desktop app step by step: static IP, API key page, Client ID and Secret code, TOTP key, 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 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 IPv6 address. It is long, with colons — for example 2402:1f00:8300:… Copy the whole thing.
  • 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 — Open the API key page

#

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

Open your profile page (the three dots at the top right, then your profile). Click the orange API KEY button.

The profile page of the trading platform with Security, Accessibility, Connection, Order Preference and LoggedIn Sessions, and the orange Freeze Account and API KEY buttons at the top.
Grey boxes hide private details such as keys, IPs and names.

Step 3 — Add the redirect URL and your IP

#

On Api Key Generation, fill in:

  • URL — paste the redirect URL from Trade Apps.
  • Primary IP Address — paste your Trade Apps IP. It is IPv6; this box accepts it.
  • Backup IP Address — leave empty.
  • Click Update.
The Api Key Generation page with Client Id, Secret Code, the URL box filled with the Trade Apps redirect URL, Primary IP Address and Backup IP Address boxes, and an Update button.
Grey boxes hide private details such as keys, IPs and names.

Step 4 — Copy the Client Id and Secret Code

#

After Update, the same page keeps your settings. Copy the Client Id (ending in _U) and the Secret Code with the copy icons on the right.

The Api Key Generation page after saving, with the Client Id and Secret Code at the top and their copy icons.
Copy these two. Grey boxes hide private details such as keys, IPs and names.

TOTP 1 — Open 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 same  profile page, open Security and click TOTP.

The broker profile page with Security open, showing Change Password and TOTP, with TOTP outlined.
Click TOTP under Security.

TOTP 2 — Copy the key

#

The Authenticator QR Code box opens. The key sits under the QR code as dots: click the eye icon to see it, or the copy icon to copy it.

Scan the QR code with your authenticator app. To generate new code — Click here makes a new key; use it only if you lost the old one.

  • 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 Authenticator QR Code box: the QR code and, under it, the hidden key with eye and copy icons, outlined.
Copy the key with the copy icon. 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:

  • Password — your  login password.
  • Client ID (API) — the Client Id from the API key page (the one ending in _U).
  • Secret Code — the Secret Code from the API key page.
  • TOTP Generator — the TOTP key you copied.
  • 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 fills ’s login in the background with your password and TOTP key; no window 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  web platform, the IP must be exactly the one the desktop card shows, in the IPv6 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.
  • Trading ID typed in the Client ID (API) box. That box takes the Client Id from the API page (ending in _U).
  • 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.