Documentation

Desktop: API Integration

 API Integration

 ని step by step Trade Apps desktop app కి కలపండి: static IP, API key, vendor code, TOTP key, password, Connect.

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

#

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

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

  • మీ  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 చేయండి

#

ఇప్పుడు 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). ఈ broker కి redirect URL అవసరం లేదు.

  •  కి మీ IP IPv4 address. ఇది dots తో నాలుగు numbers లా ఉంటుంది — ఉదాహరణకి 151.242.10.20.
  • IP మాత్రమే paste చేయండి. Port number ఎప్పుడూ కలపకండి, ఇంటి Wi-Fi లేదా mobile IP ఎప్పుడూ వాడకండి.
Static IP వచ్చిన తర్వాత అదే card: Static IP box కి గుర్తు.
IP గుర్తు పెట్టిన box లో ఉంది. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

Step 2 — కొత్త key తయారు చేయండి

#

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

ఎడమవైపు menu తెరిచి Developer → API Key కి వెళ్ళి, + Create New Key నొక్కండి.

Key Name (ఉదాహరణకి Trade Apps), చిన్న Description పెట్టి, Create నొక్కండి.

Key Generation page లో Create New Key box తెరిచి ఉంది: Key Name, Description, Cancel, Create buttons.
Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

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

#

అదే page లో + Add Static IP నొక్కండి. మీ Trade Apps IP ని Primary IP లో paste చేయండి (మీ  IP IPv4), Secondary IP ఖాళీగా వదిలి, Submit నొక్కండి.

Edit Static IP box: Primary IP, Secondary IP (optional), IP మారిస్తే ప్రస్తుత API session ముగుస్తుందనే note, Cancel, Submit buttons.
Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

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

#

మీ key ఇప్పుడు API Key Details లో దాని API Key, Vendor Code, expiry date, IPs తో కనిపిస్తుంది. API Key, Vendor Code ని copy icons తో copy చేయండి.

ఒక key API Key Details: copy icons తో API Key, Vendor Code, Expiry date, Primary IP, Secondary IP.
ఈ రెండే copy చేయాలి. Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

TOTP 1 — Settings తెరవండి

#

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

 web platform లో ఎడమవైపు menu తెరిచి, కింద Settings నొక్కండి.

broker menu కింది భాగం: Rewards, Reports, Settings, Support, Settings కి గుర్తు.
Settings నొక్కండి. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

TOTP 2 — Enable TOTP

#

Profile లో Password & Security tab తెరవండి. External 2FA TOTP కింద Enable TOTP నొక్కండి.

 మీ email కి OTP పంపుతుంది. దాన్ని type చేసి Verify నొక్కండి.

Profile page, Password & Security tab, Enable TOTP button కి గుర్తు.
Password & Security తెరిచి Enable TOTP నొక్కండి.

TOTP 3 — Key copy చేయండి

#

 QR code, దాని పక్కన Enter this Key Manually తో key, copy icon చూపిస్తుంది. Key copy చేయండి.

Authenticator app తో QR code scan చేసి, దాని 6-digit code, మీ current password type చేసి, Enable TOTP నొక్కండి.

Set Up Your TOTP Authenticator: QR code, Enter this Key Manually కింద copy icon తో key కి గుర్తు, TOTP, password boxes, Enable TOTP.
QR code పక్కన ఉన్న key copy చేయండి. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

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

#

 TOTP Successfully Enabled అని చూపించి, మిమ్మల్ని అన్ని చోట్ల నుంచి logout చేస్తుంది. Continue To Login నొక్కి, మీ password, TOTP code తో 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. ఎవరికీ పంపకండి, మాకు కూడా.
broker TOTP Successfully Enabled pop-up, Continue To Login button కి గుర్తు.
Continue To Login నొక్కండి.

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

#

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

  • Password — మీ  login password.
  • Vendor code —  లోని Vendor Code.
  • API KEY —  లోని API 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 లో పెట్టారు.  web platform లో IP సరిగ్గా desktop card చూపించేదే అయ్యుండాలి, IPv4 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 నొక్కండి.
  • Key, secret తారుమారయ్యాయి, లేదా వాటితో పాటు space copy అయింది. ప్రతి దాన్ని సరైన box లో మళ్ళీ paste చేయండి.
  • Vendor code, API key తారుమారయ్యాయి. ప్రతి box ని API Key Details page తో సరిచూడండి.
  • MCX.  తన API ద్వారా MCX ఇవ్వదు, అందుకే  account తో MCX contracts trade చేయలేరు.
  • ఇంకా కుదరట్లేదా? Card screenshot, సమయం 9398840360 కి WhatsApp చేయండి. మీ password, PIN, OTP, TOTP key, API secret ఎప్పుడూ పంపకండి — మాకు అవి ఎప్పుడూ అవసరం లేదు.