Documentation

API Integration

 API Integration

 को step-by-step Trade Apps से जोड़िए: static IP, Trade API token, TOTP और MPIN, Connect.

शुरू करने से पहले क्या चाहिए?

#

यह page आपका  account Trade Apps से शुरू से आख़िर तक जोड़ता है. पहली बार करीब 10 मिनट लगते हैं. उसके बाद हर trading day बस एक बार Connect दबाना होता है.

आप दो websites के बीच आते-जाते रहेंगे: Trade Apps (हमारा platform) और  web platform. दोनों को दो अलग browser tabs में खुला रखिए.

  • आपका  trading account, चालू हालत में, और उसके login details.
  • आपका Trade Apps login, और यह broker account Settings → Brokers Connected में पहले से दिखना चाहिए. नहीं दिख रहा तो 9398840360 पर WhatsApp कीजिए — accounts हमारी team जोड़ती है.
  • Broker portal के लिए phone से laptop या desktop ज़्यादा आसान रहता है.

Step 1 — Trade Apps में अपना static IP लीजिए

#

Brokers API orders सिर्फ़ उसी address से लेते हैं जिसे आपने approve किया हो — इसे static IP कहते हैं. Trade Apps यह आपकी subscription के साथ देता है. Free-trial accounts को नहीं मिलता, क्योंकि Forward Testing में इसकी ज़रूरत नहीं होती.

Settings खोलिए. Brokers Connected में अपना  account ढूँढिए और उसके दाईं तरफ़ छोटा pencil (Edit) button दबाइए.

जो form खुलेगा, उसमें Static IP box में Not assigned yet लिखा होगा. उसके नीचे Get static IP link दबाइए. एक box आएगा जिसमें Your static IP (IPv4) और Copy IP button होगा. इस broker को redirect URL नहीं चाहिए.

IP अभी copy कर लीजिए (और redirect URL भी, अगर दिखे) और यह tab खुला रखिए. अगर form में पहले से static IP दिख रहा है तो button नहीं होगा — IP Static IP box से copy कीजिए.

  •  के लिए आपका IP IPv4 address है. यह dots वाले चार numbers जैसा दिखता है — जैसे 151.242.10.20.
  • सिर्फ़ IP paste कीजिए. Port number कभी मत जोड़िए, और घर के Wi-Fi या mobile का IP कभी मत डालिए.
Settings में नए account का edit form: Broker Type, Client ID, Static IP में Not assigned yet और उसके नीचे Get static IP link, खाली API boxes, और Save Credentials.
नया account: अभी static IP नहीं है, इसलिए box के नीचे Get static IP link दिखता है. आपके form में आपका अपना client ID दिखेगा.

Step 2 — Trade API खोलिए

#

नए tab में  web platform खोलिए और अपने  login details से login कीजिए.

ऊपर More दबाइए, फिर Trading tools में Trade API.

आगे बढ़ने से पहले पक्का कर लीजिए कि आपके  account पर TOTP चालू है (phone में authenticator app) और आपको अपना MPIN पता है. हर बार connect करते समय दोनों चाहिए.

Trading platform का More menu, जिसमें Trading tools के नीचे Trade API — Create your own trading terminal with APIs.

Step 3 — Application बनाइए

#

नया application बनाइए ( में पहले से Default Application दिख सकता है). उसका TOKEN — consumer key — app के नाम के नीचे दिखता है.

Application खोलने के लिए दाईं तरफ़ का arrow दबाइए.

Trade API page पर एक application: नाम के नीचे token, IP Whitelist, Status Active, Reset button और खोलने के लिए arrow.
Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Step 4 — अपना IP डालिए और Consumer Key copy कीजिए

#

Application page पर Primary IP का pencil दबाइए और अपना Trade Apps IP paste कीजिए. आपका  IP IPv4 है. Save कीजिए.

ऊपर की Consumer Key उसके copy icon से copy कीजिए. Reset API Credentials मत दबाइए — उससे पुरानी key चलना बंद हो जाएगी.

Application page: copy icon के साथ Consumer Key, pencil और delete icon वाले Primary IP और Secondary IP boxes, और Reset API Credentials button.
Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Details Trade Apps में paste कीजिए

#

Trade Apps वाले tab पर लौटिए. Settings खोलिए, अपने  account का pencil फिर से दबाइए, और भरिए:

  • Client ID — आपका  client code (UCC).
  • API Key — Trade API की Consumer Key.
  •  को API Secret और redirect URL नहीं चाहिए.
  • Save Credentials दबाइए.
Settings का वही edit form, जिसमें सिर्फ़ API details वाले boxes पर निशान है.
निशान वाले boxes में paste कीजिए, फिर Save Credentials दबाइए.

Connect कीजिए और देखिए कि काम हुआ

#

Brokers Connected में Connect दबाइए.  का login page नहीं है; एक छोटा box आपका registered mobile number, आज का TOTP (authenticator app के 6 अंक) और आपका MPIN माँगेगा. हम इन्हें session शुरू करने के लिए एक बार इस्तेमाल करते हैं और कभी save नहीं करते.

काम हो गया तो Brokers Connected में आपके account के आगे हरा dot और Session active (broker validated) लिखा दिखेगा. अब आप trade कर सकते हैं.

Broker sessions हर रात ख़त्म हो जाते हैं. हर trading day market खुलने से पहले Settings खोलकर एक बार Connect दबाइए. Setup दोबारा नहीं करना होता.

Setup के बाद Brokers Connected में account: हरा dot, client ID, static IP और Session active (broker validated), साथ में edit, refresh और Disconnect buttons.
हरा dot और Session active — setup पूरा हुआ.

काम न करे तो

#

इन्हें इसी क्रम में देखिए. ज़्यादातर गड़बड़ पहली तीन में से कोई होती है.

  • IP ग़लत है या ग़लत box में डला है.  web platform पर IP बिल्कुल वही होना चाहिए जो Trade Apps दिखाता है, और IPv4 वाले box में. बदलने के बाद 2 मिनट रुकिए, फिर Connect दोबारा दबाइए.
  • Key और secret आपस में बदल गए, या साथ में space copy हो गया. दोनों को सही box में फिर से paste कीजिए.
  •  पर TOTP register नहीं है. पहले  app में TOTP चालू कीजिए; उसके बिना Connect login नहीं कर सकता.
  • फिर भी अटके हैं? Error का screenshot और समय 9398840360 पर WhatsApp कीजिए. अपना password, OTP, TOTP secret या API secret कभी मत भेजिए — हमें इनकी कभी ज़रूरत नहीं होती.