Documentation

API Integration

 API Integration

 को step-by-step Trade Apps से जोड़िए: static IP,  app, API key, Connect.

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

#

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

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

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

  •  के लिए आपका 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 —  पर 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 छिपाई गई हैं.

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

#

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

  • Client ID — आपका  client ID.
  • API Key —  की API key.
  •  के लिए API Secret box नहीं होता.
  • Save Credentials दबाइए.
Settings का वही edit form, जिसमें सिर्फ़ API details वाले boxes पर निशान है.
निशान वाले boxes में paste कीजिए, फिर Save Credentials दबाइए.

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

#

Brokers Connected में Connect दबाइए.  का login page खुलेगा; अपने client ID, PIN और authenticator app के TOTP से login कीजिए. आप अपने-आप Trade Apps पर लौट आएँगे.

काम हो गया तो 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 में डला है.  portal पर IP बिल्कुल वही होना चाहिए जो Trade Apps दिखाता है, और IPv4 वाले box में. बदलने के बाद 2 मिनट रुकिए, फिर Connect दोबारा दबाइए.
  • Redirect URL में typo या extra space है. Copy redirect URL button से फिर copy कीजिए और नए सिरे से paste कीजिए.
  • Key और secret आपस में बदल गए, या साथ में space copy हो गया. दोनों को सही box में फिर से paste कीजिए.
  • TOTP चालू नहीं है.  login में TOTP चाहिए.  portal में ऊपर Enable TOTP से चालू कीजिए.
  • इस हफ़्ते IP पहले ही बदल चुका है.  हफ़्ते में एक ही बार IP बदलने देता है. मना करे तो support को WhatsApp कीजिए.
  • फिर भी अटके हैं? Error का screenshot और समय 9398840360 पर WhatsApp कीजिए. अपना password, OTP, TOTP secret या API secret कभी मत भेजिए — हमें इनकी कभी ज़रूरत नहीं होती.