Documentation

Desktop: API Integration

 API Integration

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

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

#

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

మీరు రెండు చోట్ల మధ్య మారుతూ ఉంటారు: desktop app (Brokers page), browser లో  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 IPv4 address. ఇది dots తో నాలుగు numbers లా ఉంటుంది — ఉదాహరణకి 151.242.10.20.
  • 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 లో  portal తెరిచి, మీ  login details తో login అవ్వండి.

My Smart API & Apps లో + ADD APP నొక్కండి. ఇవి నింపండి:

  • App Name — ఏ పేరైనా, ఉదాహరణకి Trade Apps.
  • Redirect URL — Trade Apps నుంచి copy చేసిన redirect URL paste చేయండి.
  • Post back URL — ఖాళీగా వదలండి.
  • Primary Static IP — మీ Trade Apps IP paste చేయండి. ఇది IPv4 address (dots తో నాలుగు numbers).
  • Secondary Static IP — ఖాళీగా వదలండి.
Broker API portal లో Add App box తెరిచి ఉంది: App Name, Redirect URL, Post back URL (optional), Primary Static IP, Secondary Static IP (optional), Cancel, Add buttons.
ఈ broker static IP ని వారానికి ఒక్కసారే మార్చనిస్తుంది, కాబట్టి జాగ్రత్తగా paste చేయండి. Grey boxes లో keys, IPs, పేర్లు లాంటి వ్యక్తిగత details దాచాం.

Step 3 — API key copy చేయండి

#

Add నొక్కండి. మీ app Apps list లో కనిపిస్తుంది.

మీ API key page పైభాగంలో, API Type Trading పక్కన ఉంటుంది. Eye icon నొక్కి చూపించి, copy చేయండి.

 API secret ఇవ్వదు — key ఒక్కటే చాలు.

App జోడించిన తర్వాత broker page: పైన eye icon తో API Key row, కింద App Name, Redirect URL, Primary Static IP తో Apps list.
API key పై row లో ఉంది, app list లో కాదు. 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 తయారు చేస్తుంది.

 portal లో పైన Enable TOTP నొక్కండి.

broker home page, పై menu లో Enable TOTP link కి గుర్తు.
పై menu లో Enable TOTP నొక్కండి.

TOTP 2 — Login అవ్వండి

#

మీ  client ID, PIN type చేసి Login నొక్కండి.

broker login box, broker Client ID, PIN boxes, Login button కి గుర్తు.
మీ client ID, PIN తో login అవ్వండి.

TOTP 3 — OTP type చేయండి

#

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

broker Enter OTP page, OTP box, Proceed button కి గుర్తు.
OTP type చేసి Proceed నొక్కండి.

TOTP 4 — Key copy చేయండి

#

Page లో QR code, Can’t Scan ? Copy the key కింద capital letters లో key కనిపిస్తాయి. ఆ key copy చేయండి.

తర్వాత authenticator app తో QR code scan చేయండి.

  • 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 page: QR code, దాని కింద Can’t Scan ? Copy the key తో key, గుర్తు తో.
Key అంటే Can’t Scan ? Copy the key కింద ఉన్న line. Grey boxes లో keys, IPs, పేర్లు లాంటి private details దాచి ఉన్నాయి.

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

#

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

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

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

#

Connect నొక్కండి. మీరు type చేసింది save చేసి login అవుతుంది. Desktop మీ client ID, MPIN, 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 లో పెట్టారు.  portal లో 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 నొక్కండి.
  • Redirect URL లో typo లేదా అదనపు space. Card మీద Copy మళ్ళీ నొక్కి, broker లో కొత్తగా paste చేయండి.
  • Key, secret తారుమారయ్యాయి, లేదా వాటితో పాటు space copy అయింది. ప్రతి దాన్ని సరైన box లో మళ్ళీ paste చేయండి.
  • ఈ వారం IP ఇప్పటికే మార్చారు.  వారానికి ఒక్కసారే IP మార్చనిస్తుంది. Refuse చేస్తే support కి WhatsApp చేయండి.
  • Redirect URL. Desktop దీన్ని వాడదు, కానీ  ఒకటి అడుగుతుంది. Card లో ఉన్నదే పెట్టండి: అది website దే (https://tradeapps.bluechipalgos.com/oauth/angel-one).
  • ఇంకా కుదరట్లేదా? Card screenshot, సమయం 9398840360 కి WhatsApp చేయండి. మీ password, PIN, OTP, TOTP key, API secret ఎప్పుడూ పంపకండి — మాకు అవి ఎప్పుడూ అవసరం లేదు.