Documentation

Desktop: API Integration

 API Integration

 ని step by step Trade Apps desktop app కి కలపండి: static IP, developer portal, API key, secret, TOTP key, Connect.

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

#

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

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

  • మీ  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 — App తయారు చేయండి

#

కొత్త tab లో  developer portal తెరిచి, మీ  login details తో login అవ్వండి, Individual trader ఎంచుకోండి.

Create App కి వెళ్ళండి. ఎర్ర star ఉన్న ప్రతి box నింపండి:

  • App Name — ఏ పేరైనా, ఉదాహరణకి Trade Apps.
  • Description — కొన్ని మాటలు, ఉదాహరణకి Algo trading through Trade Apps.
  • Redirect URL — Trade Apps నుంచి copy చేసిన redirect URL paste చేయండి. అది సరిగ్గా అలాగే ఉండాలి.
  • Business Type — Trading ఎంచుకోండి.
  • Contact Name, Contact Email, Mobile Number — మీ సొంత details.
  • App Icon — అవసరం లేదు.
Broker portal లో Create App form: App Name, Description, Redirect URL, Business Type, Contact Name, Contact Email, Mobile Number, App Icon boxes, Save button.

Step 3 — Save చేసి మీ static IP పెట్టండి

#

Save నొక్కండి. కింద మరిన్ని boxes వస్తాయి: Primary IPv4, Secondary IPv4, Primary IPv6, Secondary IPv6, IP Type.

మీ Trade Apps IP IPv6, కాబట్టి దాన్ని Primary IPv6 లో paste చేయండి. రెండు IPv4 boxes ఖాళీగా వదలండి. IP Type ని Static మీదే ఉంచండి. తర్వాత Submit నొక్కండి.

Save తర్వాత అదే form, నింపి ఉంది, static IP Primary IPv6 box లో. IPv4 boxes ఖాళీ, IP Type Static.
IP Primary IPv6 లోకి వెళ్తుంది — IPv4 లోకి కాదు. ఈ example లో వేరేది కనిపించినా Business Type లో Trading నే ఎంచుకోండి. Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

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

#

మీ app ఇప్పుడు Your Applications లో కనిపిస్తుంది. దాని App Key, App Secret Key ని పక్కనున్న copy icons తో copy చేయండి. ఇవే మీ API key, API secret.

Broker portal లో Your Applications: ప్రతి app కి App Name, App Key, App Secret Key, Redirect URL, Status, key, secret పక్కన copy icons.
ఈ రెండే copy చేయాలి. Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

TOTP 1 — Login page లో Reset TOTP

#

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

ANT web తెరిచి మీ user ID type చేయండి. TOTP box కింద Reset TOTP నొక్కండి.

ANT web login page, user box, TOTP box, Reset TOTP link కి గుర్తు.
TOTP box కింద Reset TOTP నొక్కండి. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

TOTP 2 — Mobile OTP type చేయండి

#

 మీ registered mobile కి OTP పంపుతుంది. దాన్ని Mobile OTP లో type చేసి Next నొక్కండి.

Mobile OTP అడిగే ANT web page, OTP box, Next button కి గుర్తు.
Mobile OTP type చేసి Next నొక్కండి. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

TOTP 3 — Key copy చేయండి

#

 Scan QR చూపిస్తుంది. QR code కింద Can’t scan? Copy the key. నొక్కండి; key కనిపిస్తుంది. దాన్ని copy చేయండి.

తర్వాత authenticator app తో QR code scan చేసి, దాని 6-digit code ని TOTP లో type చేసి Next నొక్కండి.

  • 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. ఎవరికీ పంపకండి, మాకు కూడా.
Scan QR page: QR code, Can’t scan? Copy the key link కి గుర్తు, TOTP box, Next.
ఈ link key చూపిస్తుంది. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

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

#

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

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

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

#

Connect నొక్కండి. మీరు type చేసింది save చేసి login అవుతుంది. Desktop మీ password, 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 portal లో 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 చేయండి.
  • IP ని IPv4 box లో పెట్టారు.  లో నాలుగు IP boxes ఉన్నాయి. మీ IP Primary IPv6 (లేదా Secondary IPv6) లో మాత్రమే పని చేస్తుంది.
  • ఇంకా కుదరట్లేదా? Card screenshot, సమయం 9398840360 కి WhatsApp చేయండి. మీ password, PIN, OTP, TOTP key, API secret ఎప్పుడూ పంపకండి — మాకు అవి ఎప్పుడూ అవసరం లేదు.