Documentation

Desktop: API Integration

 API Integration

Connect  to the Trade Apps desktop app step by step: static IP, an Algo Trading app, API key, TOTP key, PIN, 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  developer apps page 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 — Create an Algo Trading app

#

Open the  developer apps page in a new tab and log in with your  login details.

Go to Apps → Algo Trading and click + App. Fill App Name (up to 20 letters, for example Trade Apps) and Redirect URL (paste the one from Trade Apps). Leave the optional boxes empty. Click Continue.

The Create New Algo Trading App form: App Name, Redirect URL, Postback URL (optional) with Order Update ticked, Notifier Webhook Endpoint (optional) and Description (optional).

Step 3 — Add your static IP

#

Click + Static IPs. Paste your Trade Apps IP in Primary IP, leave Secondary IP empty, and click Save.

The Static IPs page with a Primary IP box, a Secondary IP box, and Cancel and Save buttons.
Grey boxes hide private details such as keys, IPs and names.

Step 4 — Copy the API Key and API Secret

#

In My Apps → Algo Trading, click the arrow next to your app to open it. Copy the API Key. For the API Secret, use its copy icon (the eye icon shows it).

My Apps on the Algo Trading tab with an app opened: API Key with a copy icon, API Secret shown as stars with copy, show and refresh icons, and Access Token with a Generate button.
Copy these two. Grey boxes hide private details such as keys, IPs and names.

TOTP 1 — 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.

Log in at account..com, click Profile at the top, and choose Time-based OTP (TOTP) at the bottom of the left menu. Click Enable TOTP.

The broker profile page with Time-based OTP (TOTP) in the left menu and the Enable TOTP button, both outlined.
Open Time-based OTP (TOTP) and click Enable TOTP.

TOTP 2 — Verify your mobile number

#

 sends a 6-digit OTP to your registered mobile. Type it in Enter OTP and click Continue.

Verify your mobile number, with the Enter OTP box and the Continue button outlined.
Type the mobile OTP and click Continue. Grey boxes hide private details such as keys, IPs and names.

TOTP 3 — Copy the key

#

Step 1 of the page shows a QR code. Click Unable to scan? Click to copy the key under it: the key is copied. Paste it somewhere safe straight away.

Scan the QR code with your authenticator app, type its 6-digit code in Step 2, and click Enable TOTP.

The broker TOTP page: Step 1 with the QR code and the Unable to scan? Click to copy the key link outlined, Step 2 with the 6-digit box, and the Enable TOTP button outlined.
The link copies the key. Grey boxes hide private details such as keys, IPs and names.

TOTP 4 — Log in again

#

 shows Congratulations: TOTP is on, and you are logged out everywhere. Click Okay and log in again with your mobile number, TOTP and PIN.

  • 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 Congratulations pop-up saying TOTP is enabled, with the Okay button outlined.
TOTP is on. Click Okay and log in again.

Fill in the card in the desktop app

#

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

  • API KEY — the API Key of your app.
  • PIN — your 6-digit  PIN.
  • TOTP Generator — the TOTP key you copied.
  • The desktop does not need the API Secret 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 API key, PIN 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  developer apps page, 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.
  • PIN wrong.  needs your 6-digit login PIN, not your MPIN for orders or your password.
  • 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.