broker API Integration | Bluechip Algos Documentation

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

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

आप दो websites के बीच आते-जाते रहेंगे: Trade Apps (हमारा platform) और developer apps 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 होगा. उसके नीचे 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 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 — Algo Trading app बनाइए

#

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

Apps → Algo Trading पर जाकर + App दबाइए. App Name (20 अक्षर तक, जैसे Trade Apps) और Redirect URL (Trade Apps वाला paste कीजिए) भरिए. Optional boxes ख़ाली छोड़िए. Continue दबाइए.

Create New Algo Trading App form: App Name, Redirect URL, Order Update टिक के साथ Postback URL (optional), Notifier Webhook Endpoint (optional) और Description (optional).

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

#

+ Static IPs दबाइए. अपना Trade Apps IP Primary IP में paste कीजिए, Secondary IP ख़ाली छोड़िए, और Save दबाइए.

Static IPs page: Primary IP box, Secondary IP box, और Cancel व Save buttons. — Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Step 4 — API Key और API Secret copy कीजिए

#

My Apps → Algo Trading में अपने app के बगल वाला arrow दबाकर उसे खोलिए. API Key copy कीजिए. API Secret के लिए उसका copy icon इस्तेमाल कीजिए (eye icon उसे दिखाता है).

Algo Trading tab पर My Apps, एक app खुला हुआ: copy icon के साथ API Key, stars में छिपा API Secret copy, show और refresh icons के साथ, और Generate button के साथ Access Token. — यही दोनों copy करने हैं. Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

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

#

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

Client ID — आपकी profile का 6 अक्षर वाला client code (UCC). Mobile number नहीं.
API Key — आपके app की API Key.
API Secret — आपके app का API Secret.
Save Credentials दबाइए.

Settings का वही edit form, जिसमें सिर्फ़ API details वाले boxes पर निशान है. — निशान वाले boxes में paste कीजिए, फिर **Save Credentials** दबाइए.

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

#

Brokers Connected में Connect दबाइए. login खुलेगा: पहली बार पूरा login माँगेगा, बाद में सिर्फ़ PIN. आप अपने-आप 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 में डला है. developer apps page पर IP बिल्कुल वही होना चाहिए जो Trade Apps दिखाता है, और IPv6 वाले box में. बदलने के बाद 2 मिनट रुकिए, फिर Connect दोबारा दबाइए.
Redirect URL में typo या extra space है. Copy redirect URL button से फिर copy कीजिए और नए सिरे से paste कीजिए.
Key और secret आपस में बदल गए, या साथ में space copy हो गया. दोनों को सही box में फिर से paste कीजिए.
Client ID में mobile number डाल दिया. को profile वाला 6 अक्षर का client code चाहिए.
फिर भी अटके हैं? Error का screenshot और समय 9398840360 पर WhatsApp कीजिए. अपना password, OTP, TOTP secret या API secret कभी मत भेजिए — हमें इनकी कभी ज़रूरत नहीं होती.