Documentation

Desktop: API Integration

 API Integration

 ని step by step Trade Apps desktop app కి కలపండి: static IP, Algo Trading app, API key, TOTP key, PIN, Connect.

మొదలుపెట్టే ముందు ఏం కావాలి?

#

ఈ page మీ  account ను Trade Apps desktop app కి మొదటి నుంచి చివరి వరకు కలుపుతుంది. మొదటిసారి సుమారు 15 నిమిషాలు పడుతుంది. ఆ తర్వాత ప్రతి trading day ఒక్కసారి Connect నొక్కితే చాలు.

మీరు రెండు చోట్ల మధ్య మారుతూ ఉంటారు: desktop app (Brokers page), browser లో  developer apps page. రెండూ తెరిచి ఉంచండి.

  • మీ  trading account, active గా ఉండాలి, దాని login details మీ దగ్గర ఉండాలి.
  • Trade Apps desktop app install అయ్యి ఉండాలి, మీ Trade Apps login ఉండాలి. మీ broker account Brokers page లో card గా ఇప్పటికే కనిపించాలి. కనిపించకపోతే 9398840360 కి WhatsApp చేయండి — accounts మా team జోడిస్తుంది.
  • TOTP step కోసం phone లో authenticator app (Google Authenticator, Microsoft Authenticator లేదా Authy).
  • ఈ broker ని ఇప్పటికే Trade Apps website లో వాడుతున్నారా? అయితే API app మీ దగ్గర ఇప్పటికే ఉంది. ఇక్కడ అదే key, secret పెట్టండి; నేరుగా TOTP step కి వెళ్ళండి.

Step 1 — Desktop app లో మీ static IP తీసుకోండి

#

Brokers API orders ను మీరు approve చేసిన address నుంచి మాత్రమే తీసుకుంటాయి — దీన్ని static IP అంటారు. Trade Apps దీన్ని మీ subscription తో ఇస్తుంది; free-trial accounts కి ఇవ్వదు.

Desktop app తెరిచి, ఎడమవైపు menu లో Brokers నొక్కండి. మీ  account card వెతకండి. Static IP box లో Not assigned yet అని ఉంటే, దాని పక్కన ఉన్న Get static IP నొక్కండి, తర్వాత confirm అడిగే box లో మళ్ళీ Get static IP నొక్కండి.

To use your system IP, leave this field blank అని కనిపిస్తే, అది static IP లేకుండా trade చేసే clients కోసం మాత్రమే. Subscription ఉంటే static IP తీసుకోండి.

Desktop Brokers page లో కొత్త account card: Not connected, Static IP box లో Not assigned yet, Get static IP button కి గుర్తు, redirect URL, ఖాళీ boxes, Disconnect, Connect.
కొత్త account: ఇంకా static IP లేదు, అందుకే box పక్కన Get static IP కనిపిస్తుంది.

IP copy చేయండి, redirect URL కూడా

#

ఇప్పుడు box లో మీ static IP కనిపిస్తుంది. Whitelist your static IP అనే window తెరుచుకుంటే, తర్వాతి steps చేసేటప్పుడు దాన్ని తెరిచే ఉంచండి, IP ని  లో save చేసిన తర్వాతే I have whitelisted it నొక్కండి.

Static IP box లోపల click చేసి, address మొత్తం select చేసి (Ctrl+A) copy చేయండి (Ctrl+C). తర్వాత REDIRECT URL పక్కన Copy నొక్కండి — తర్వాతి steps లో రెండూ కావాలి.

  •  కి మీ IP IPv6 address. ఇది పొడవుగా, colons తో ఉంటుంది — ఉదాహరణకి 2402:1f00:8300:… మొత్తం copy చేయండి.
  • IP మాత్రమే paste చేయండి. Port number ఎప్పుడూ కలపకండి, ఇంటి Wi-Fi లేదా mobile IP ఎప్పుడూ వాడకండి.
Static IP వచ్చిన తర్వాత అదే card: Static IP box, Copy button, redirect URL కి గుర్తు.
IP గుర్తు పెట్టిన box లో ఉంది; Copy redirect URL ని copy చేస్తుంది. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

Step 2 — Algo Trading app తయారు చేయండి

#

కొత్త tab లో  developer apps page తెరిచి, మీ  login details తో login అవ్వండి.

Apps → Algo Trading కి వెళ్ళి + App నొక్కండి. App Name (20 అక్షరాల వరకు, ఉదాహరణకి Trade Apps), Redirect URL (Trade Apps దాన్ని paste చేయండి) నింపండి. Optional boxes ఖాళీగా వదలండి. Continue నొక్కండి.

Create New Algo Trading App form: App Name, Redirect URL, Order Update tick తో Postback URL (optional), Notifier Webhook Endpoint (optional), Description (optional).

Step 3 — మీ static IP పెట్టండి

#

+ Static IPs నొక్కండి. మీ Trade Apps IP ని Primary IP లో paste చేసి, Secondary IP ఖాళీగా వదిలి, Save నొక్కండి.

Static IPs page: Primary IP box, Secondary IP box, Cancel, Save buttons.
Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

Step 4 — API Key, API Secret copy చేయండి

#

My Apps → Algo Trading లో మీ app పక్కన arrow నొక్కి తెరవండి. API Key copy చేయండి. API Secret కి దాని copy icon వాడండి (eye icon దాన్ని చూపిస్తుంది).

Algo Trading tab లో My Apps, ఒక app తెరిచి ఉంది: copy icon తో API Key, stars గా దాచిన API Secret copy, show, refresh icons తో, Generate button తో Access Token.
ఈ రెండే copy చేయాలి. Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

TOTP 1 — Enable TOTP

#

Desktop ప్రతి ఉదయం మీ broker లో తనే login అవుతుంది, అందుకే దానికి మీ TOTP key కావాలి: TOTP on చేసేటప్పుడు broker చూపించే QR code వెనకాల ఉండే letters, digits ఉన్న పొడవైన code. దీని నుంచే desktop మీ authenticator app చూపించే అదే 6-digit code తయారు చేస్తుంది.

account..com లో login అయ్యి, పైన Profile నొక్కి, ఎడమ menu లో చివర Time-based OTP (TOTP) ఎంచుకోండి. Enable TOTP నొక్కండి.

broker profile page, ఎడమ menu లో Time-based OTP (TOTP), Enable TOTP button, రెండింటికీ గుర్తు.
Time-based OTP (TOTP) తెరిచి Enable TOTP నొక్కండి.

TOTP 2 — Mobile number verify చేయండి

#

 మీ registered mobile కి 6-digit OTP పంపుతుంది. దాన్ని Enter OTP లో type చేసి Continue నొక్కండి.

Verify your mobile number page, Enter OTP box, Continue button కి గుర్తు.
Mobile OTP type చేసి Continue నొక్కండి. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

TOTP 3 — Key copy చేయండి

#

Page లోని Step 1 లో QR code కనిపిస్తుంది. దాని కింద Unable to scan? Click to copy the key నొక్కండి: key copy అవుతుంది. దాన్ని వెంటనే ఎక్కడైనా జాగ్రత్తగా paste చేసి దాచుకోండి.

Authenticator app తో QR code scan చేసి, దాని 6-digit code ని Step 2 లో type చేసి, Enable TOTP నొక్కండి.

broker TOTP page: Step 1 లో QR code, Unable to scan? Click to copy the key link కి గుర్తు, Step 2 లో 6-digit box, Enable TOTP button కి గుర్తు.
ఈ link key ని copy చేస్తుంది. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

TOTP 4 — మళ్ళీ login అవ్వండి

#

 Congratulations అని చూపిస్తుంది: TOTP on అయ్యింది, మీరు అన్ని చోట్ల నుంచి logout అయ్యారు. Okay నొక్కి, మీ mobile number, TOTP, PIN తో మళ్ళీ login అవ్వండి.

  • Key copy చేయండి, 6-digit code కాదు. Code ప్రతి 30 seconds కి మారుతుంది; key ఎప్పుడూ మారదు.
  • QR code ని phone లోని authenticator app (Google Authenticator, Microsoft Authenticator లేదా Authy) తో కూడా scan చేయండి. Broker సొంత website, app కోసం దాని codes కావాలి.
  • TOTP ఎప్పుడో on చేసి key దాచుకోకపోతే, TOTP reset చేసి కొత్త key చూడండి, కొత్త QR code ని phone లో కూడా scan చేయండి — పాత codes పని చేయవు.
  • ఈ key మీ password అంత private. ఎవరికీ పంపకండి, మాకు కూడా.
TOTP on అయ్యిందని చెప్పే broker Congratulations pop-up, Okay button కి గుర్తు.
TOTP on అయ్యింది. Okay నొక్కి మళ్ళీ login అవ్వండి.

Desktop app లో card నింపండి

#

Desktop app కి తిరిగి రండి, Brokers page, మీ  card. ఇవి నింపండి:

  • API KEY — మీ app API Key.
  • PIN — మీ 6-digit  PIN.
  • TOTP Generator — మీరు copy చేసిన TOTP key.
  •  కి desktop కి API Secret అవసరం లేదు.
  • ప్రతి value సరిగ్గా అలాగే paste చేయండి, ముందు వెనక space లేకుండా. User ID ని అలాగే వదలండి — అది మీ Trade Apps account నుంచి వస్తుంది.
అదే card, నింపాల్సిన boxes కి, Connect button కి మాత్రమే గుర్తు.
గుర్తు పెట్టిన boxes నింపి, Connect నొక్కండి. Values దాచి ఉంటాయి, అందుకే boxes లో dots కనిపిస్తాయి.

Connect చేసి, పని చేసిందో చూడండి

#

Connect నొక్కండి. మీరు type చేసింది save చేసి login అవుతుంది. Desktop మీ API key, PIN, TOTP key తో login అవుతుంది; broker page ఏదీ తెరుచుకోదు.

పని చేస్తే grey Not connected label ఆకుపచ్చ అయ్యి Connected till 11:59 pm అని చూపిస్తుంది. Trade Disc, Trade Scalper రెండూ ఇదే connection వాడతాయి.

మీరు type చేసినవి encrypt అయ్యి ఈ computer లో మాత్రమే save అవుతాయి. ప్రతి trading day market తెరవకముందు Brokers page తెరిచి ఒక్కసారి Connect నొక్కండి. Setup మళ్ళీ చేయక్కర్లేదు. రెండో computer లో details ఇంకోసారి type చేయాలి.

Connect తర్వాత card: ఆకుపచ్చ Connected till 11:59 pm label కి గుర్తు, static IP label, నింపిన boxes.
ఆకుపచ్చ Connected till 11:59 pm — setup పూర్తయింది.

పని చేయకపోతే

#

Connect fail అయితే కారణం card మీద labels కింద ఎరుపు రంగులో రాసి ఉంటుంది. వీటిని ఇదే వరుసలో చూడండి; చాలా సమస్యలు మొదటి నాలుగింటిలో ఒకటే.

  • IP తప్పు, లేదా తప్పు box లో పెట్టారు.  developer apps page లో IP సరిగ్గా desktop card చూపించేదే అయ్యుండాలి, IPv6 box లో. మార్చిన తర్వాత 2 నిమిషాలు ఆగి, Connect మళ్ళీ నొక్కండి.
  • TOTP key తప్పు. TOTP box లో TOTP setup లో వచ్చిన పొడవైన key కావాలి, ఈ రోజు 6-digit code కాదు. అనుమానం ఉంటే broker లో TOTP off చేసి మళ్ళీ on చేసి, కొత్త key copy చేసి మళ్ళీ paste చేయండి.
  • Broker లో password లేదా PIN మార్చారు. కొత్తది card లో type చేసి Connect నొక్కండి.
  • Redirect URL లో typo లేదా అదనపు space. Card మీద Copy మళ్ళీ నొక్కి, broker లో కొత్తగా paste చేయండి.
  • Key, secret తారుమారయ్యాయి, లేదా వాటితో పాటు space copy అయింది. ప్రతి దాన్ని సరైన box లో మళ్ళీ paste చేయండి.
  • PIN తప్పు.  కి మీ 6-digit login PIN కావాలి, password కాదు.
  • ఇంకా కుదరట్లేదా? Card screenshot, సమయం 9398840360 కి WhatsApp చేయండి. మీ password, PIN, OTP, TOTP key, API secret ఎప్పుడూ పంపకండి — మాకు అవి ఎప్పుడూ అవసరం లేదు.