Documentation

API Integration

API Integration

हर broker को Trade Apps से जोड़ने की step-by-step guide: static IP, broker का API app, key और secret, Connect.

Broker connect करना कैसे काम करता है?

#

Trade Apps आपके अपने broker account में orders लगाता है. इसकी इजाज़त के लिए आपका broker आपको API key देता है (कभी-कभी secret के साथ), और आप वह static IP approve करते हैं जिससे हमारे orders आते हैं. यह एक बार करना होता है.

हर guide इन्हीं चार steps पर चलती है:

  • 1. Trade Apps में — Settings → Brokers Connected → pencil → Get static IP. IP और redirect URL copy कीजिए.
  • 2. अपने broker की website पर — API app बनाइए, IP (और redirect URL) paste कीजिए, और API key व secret copy कीजिए.
  • 3. वापस Trade Apps में — इन्हें paste करके Save Credentials दबाइए.
  • 4. Connect — Connect दबाइए और देखिए कि Session active लिखा है. उसके बाद हर trading day बस एक बार Connect.

अपना broker चुनिए

#

अपने broker की guide खोलिए:

कौन-से brokers चलते हैं

#

Accounts आपके लिए Bluechip Algos support जोड़ता है; broker account आप ख़ुद नहीं जोड़ सकते. Settings → Brokers Connected में आपका account नहीं दिखता तो 9398840360 पर WhatsApp कीजिए.

,  और  accounts को execution के लिए free lifetime licence मिलता है — details के लिए 9398840360 पर WhatsApp कीजिए. बाक़ी brokers पर यह free licence नहीं है.

आपका broker ऊपर की list में नहीं है तो live trading की योजना से पहले support से बात कीजिए. एक broker की details दूसरे broker के account में कभी मत डालिए.

कौन-सी details चाहिए

#

आपका broker client ID, जहाँ ज़रूरी हो वहाँ broker login password या PIN, API key, जहाँ broker दे वहाँ API secret, जहाँ ज़रूरी हो वहाँ TOTP/authenticator code, और broker जो भी vendor या app code दिखाए.

Fields के नाम हर broker में अलग हैं — हर guide बताती है कि कौन-सी value किस box में जाती है. Values बिल्कुल वैसे ही paste कीजिए, आगे-पीछे कोई space नहीं.

API fields का अंदाज़ा मत लगाइए

#

पक्का नहीं पता कि कौन-सी value किस box में जाती है, तो अंदाज़ा मत लगाइए. ग़लत details से invalid-session errors आते हैं, login मना हो जाता है, या live trading रुक जाती है.

9398840360 पर WhatsApp कीजिए, support आपको बताएगा.

Static IP क्या है?

#

Brokers API orders सिर्फ़ उन addresses से लेते हैं जिन्हें आपने approve किया हो. इसी approve किए address को whitelisted या static IP कहते हैं.

Broker देखता है कि हर order आपके approve किए Trade Apps IP से आ रहा है. Approve नहीं है तो Connect या order ही fail हो जाता है.

Static IP कैसे बदलें?

#

अपने broker के API या developer portal में IP whitelist, static IP या allowed IP ढूँढिए, Settings में आपके account पर दिखने वाला IP paste कीजिए, save कीजिए, और Trade Apps में फिर से Connect दबाइए.

सिर्फ़ IP paste कीजिए, port के साथ कभी नहीं. हर broker की guide दिखाती है कि IP किस box में जाता है.

अभी static IP नहीं है तो

#

घर के Wi-Fi का IP, mobile internet का IP, office का IP या कोई भी मनमाना IP कभी मत डालिए.

Settings खोलिए, अपने account का pencil दबाइए और Get static IP दबाइए; Trade Apps एक IP देता है और बताता है कि क्या whitelist करना है. अगर वह support से बात करने को कहे तो अपने broker के नाम के साथ 9398840360 पर WhatsApp कीजिए.

Static IP errors

#

IP whitelist, invalid IP, static IP या unauthorised source वाला error मतलब broker वह address मना कर रहा है — सही IP अभी whitelist नहीं हुआ, या बदल गया है.

अपने broker का नाम, समय और error का screenshot 9398840360 पर WhatsApp कीजिए. अपना password, OTP, TOTP secret या API secret कभी मत भेजिए.

Connect या reconnect

#

API details save करने के बाद Settings में Connect दबाइए.

Live trading के लिए connected session चाहिए. Sessions हर रात ख़त्म होते हैं, और दिन में भी ख़त्म हो सकते हैं — नए live orders लगाने या automated entries चलने की उम्मीद से पहले reconnect कीजिए.

Session active

#

हरा dot और Session active (broker validated) मतलब broker session चालू है.

फिर भी हर order का status देखिए: connected होने पर भी broker कोई order मना कर सकता है.

Session expired

#

Session expired — connect मतलब session ख़त्म हो गया है. Live orders लगाने से पहले Connect दबाइए.

Session invalid

#

Session invalid — connect मतलब कोई key, token, TOTP, static IP या ख़ुद session ग़लत है.

पहले अपने broker की guide से API details जाँचिए. फिर भी रहे तो 9398840360 पर WhatsApp कीजिए.

कोई broker connected नहीं

#

यह warning तब आती है जब आपकी subscription चालू है पर कोई broker connected नहीं है.

Live orders लगाने, live बदलाव save करने या automated entries चलने की उम्मीद से पहले अपना account connect कीजिए.

Live trading से पहले

#

चार चीज़ें देखिए: product subscription चालू है, सही broker account चुना है, उस पर Session active दिख रहा है, और app उसी mode में है जो आप चाहते हैं — Live या Forward Testing.

इनमें से एक भी ग़लत हो तो live trading fail हो सकती है या ग़लत account में हो सकती है.

अपनी details सुरक्षित रखिए

#

अपना broker password, OTP, API secret, TOTP secret या पूरा token कभी share मत कीजिए — न groups में, न हमारे साथ.

मदद के लिए बस broker का नाम, error का screenshot, समय, और छिपाया हुआ client ID भेजिए. 9398840360 पर WhatsApp कीजिए.