Documentation

API Integration

 API Integration

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

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

#

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

आप दो websites के बीच आते-जाते रहेंगे: Trade Apps (हमारा platform) और  Trade API page. दोनों को दो अलग 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 (IPv6) और Copy IP button होगा. इस broker को redirect URL नहीं चाहिए.

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

  •  के लिए आपका IP IPv6 address है. यह लंबा होता है, colons के साथ — जैसे 2402:1f00:8300:… पूरा copy कीजिए.
  • सिर्फ़ 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 — API keys खोलिए

#

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

Get started दबाइए, फिर बाईं तरफ़ API keys. आपको API key dashboard दिखेगा.

 अपनी Trade API के लिए हर महीने fee लेता है — मौजूदा price  से पूछ लीजिए.

API key dashboard: keys की list और उनका status, Update static IP button, और Generate API key menu खुला हुआ जिसमें Generate TOTP token और Generate Access Token हैं.

Step 3 — TOTP token बनाइए

#

Generate API key के बगल वाला छोटा arrow दबाकर Generate TOTP token चुनिए (Access Token नहीं).

कोई नाम डालिए, जैसे Trade Apps, और Continue दबाइए.

TOTP token box, जो Name माँग रहा है, static IP जोड़ने की याद दिलाता note, और Continue button.

Step 4 — Token copy कीजिए और QR code scan कीजिए

#

 अब तीन चीज़ें सिर्फ़ एक बार दिखाता है: TOTP Token (लंबा text), एक QR code, और उसके नीचे TOTP secret.

TOTP Token copy कीजिए — यह Trade Apps में जाता है.

Phone में authenticator app (Google Authenticator, Microsoft Authenticator या Authy) खोलिए और QR code scan कीजिए. अब app हर 30 seconds में  का नया 6 अंकों का code दिखाएगा. हर बार connect करते समय यही code डालना है.

दोनों save होने के बाद ही Done दबाइए.

बनने के बाद TOTP token box: copy button के साथ TOTP Token, TOTP QR Code, copy button के साथ secret, ये सिर्फ़ एक बार दिखने की चेतावनी, और Done button.
सिर्फ़ एक बार दिखता है. खो जाए तो नया token बनाइए और उसका नया QR code scan कीजिए. Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Step 5 — अपना static IP डालिए

#

API key dashboard पर वापस आकर ऊपर दाईं तरफ़ Update static IP दबाइए और अपना Trade Apps IP paste कीजिए. Save कीजिए.

API key dashboard, ऊपर दाईं तरफ़ Update static IP button पर घेरा.

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

#

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

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

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

#

Brokers Connected में Connect दबाइए. एक छोटा box authenticator app से आज का 6 अंकों का code माँगेगा. डालिए; हम इसे एक बार इस्तेमाल करते हैं और कभी 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 में डला है.  Trade API page पर IP बिल्कुल वही होना चाहिए जो Trade Apps दिखाता है, और IPv6 वाले box में. बदलने के बाद 2 मिनट रुकिए, फिर Connect दोबारा दबाइए.
  • Key और secret आपस में बदल गए, या साथ में space copy हो गया. दोनों को सही box में फिर से paste कीजिए.
  • Token की जगह TOTP secret paste कर दिया. Box को लंबा TOTP Token चाहिए, QR code के नीचे वाला छोटा secret नहीं.
  • पुराने QR का code. हर नए token का अपना QR code होता है. नया token बनाने के बाद नया QR फिर से scan कीजिए.
  • फिर भी अटके हैं? Error का screenshot और समय 9398840360 पर WhatsApp कीजिए. अपना password, OTP, TOTP secret या API secret कभी मत भेजिए — हमें इनकी कभी ज़रूरत नहीं होती.