Documentation

Desktop: API Integration

 API Integration

 को Trade Apps desktop app से step by step जोड़िए: static IP, Kite Connect पर paid Connect app, API key और secret, TOTP key, Connect.

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

#

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

आप दो जगहों के बीच आते-जाते रहेंगे: desktop app (Brokers page) और browser में Kite Connect developer site. दोनों खुले रखिए.

  • आपका  trading account, active, और उसकी login details.
  • Trade Apps desktop app install किया हुआ, और आपका Trade Apps login. आपका broker account Brokers page पर card के रूप में पहले से दिखना चाहिए. न दिखे तो 9398840360 पर WhatsApp कीजिए — accounts हमारी team जोड़ती है.
  • TOTP step के लिए phone में authenticator app (Google Authenticator, Microsoft Authenticator या Authy).
  • यह broker पहले से Trade Apps website पर चला रहे हैं? तो API app आपके पास पहले से है. यहाँ वही key और secret डालिए; सीधे TOTP step पर जाइए.

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

#

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

Desktop app खोलिए और बाईं menu में Brokers पर click कीजिए. अपने  account का card ढूंढिए. अगर Static IP box में Not assigned yet लिखा है, तो उसके पास Get static IP दबाइए, फिर confirm करने वाले box में दोबारा Get static IP दबाइए.

अगर To use your system IP, leave this field blank लिखा दिखे, तो वह सिर्फ उन clients के लिए है जो static IP के बिना trade करते हैं. Subscription है तो static IP लीजिए.

Desktop के Brokers page पर नए account का card: Not connected, Static IP box में Not assigned yet, Get static IP button पर निशान, redirect URL, खाली boxes, और Disconnect व Connect.
नया account: अभी static IP नहीं है, इसलिए box के पास Get static IP दिखता है.

IP copy कीजिए और redirect URL भी

#

अब box में आपका static IP दिखता है. अगर Whitelist your static IP नाम की window खुले, तो अगले steps करते समय उसे खुला रखिए, और I have whitelisted it तभी दबाइए जब IP  में save हो जाए.

Static IP box के अंदर click कीजिए, पूरा address select कीजिए (Ctrl+A) और copy कीजिए (Ctrl+C). फिर REDIRECT URL के पास Copy दबाइए — अगले steps में दोनों चाहिए.

  •  के लिए आपका IP IPv6 address है. यह लंबा होता है, colons के साथ — जैसे 2402:1f00:8300:… पूरा copy कीजिए.
  • सिर्फ IP paste कीजिए. Port number कभी मत जोड़िए, और घर का Wi-Fi या mobile IP कभी मत डालिए.
Static IP मिलने के बाद वही card: Static IP box, Copy button और redirect URL पर निशान.
IP निशान वाले box में है; Copy redirect URL copy करता है. Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Step 2 — Connect app बनाइए

#

Kite Connect developer site खोलिए. पहले कभी इस्तेमाल नहीं किया तो पहले Sign up कीजिए — यह account आपके Kite login से अलग है. फिर login कीजिए.

My apps → Create new app पर जाइए. Connect चुनिए — यह paid है, और desktop को live prices के लिए यही चाहिए (नीचे Prices के लिए Connect plan चाहिए देखिए). ये भरिए:

  • App name — कोई भी नाम, जैसे Trade Apps.
  •  Client ID — आपका client ID, जैसे AB1234.
  • Redirect URL — desktop card से copy किया हुआ paste कीजिए.
  • Postback URL — खाली छोड़िए.
  • Description — कुछ शब्द, जैसे Algo trading through Trade Apps.
Create a new app form, Type में Connect चुना हुआ और उस पर निशान: 500 credits for 30 days, API और WebSockets से live market quotes. Personal और Publisher free हैं.
Connect चुनिए. Personal free है पर live prices नहीं देता.

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

#

Create दबाइए. फिर ऊपर Profile दबाइए. IP Whitelist में पहली line पर अपना Trade Apps IP paste कीजिए और page के नीचे Update दबाइए.

Developer site का Profile page: Your name, E-mail, Phone, Website, About you, State of residence और IP Whitelist box, जिसमें एक line में एक, ज़्यादा से ज़्यादा 2 IPs आते हैं.
Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Step 4 — अपना app खोलिए

#

ऊपर My apps दबाइए. आपका app अपनी API key के साथ दिखेगा. App के नाम पर दबाकर उसे खोलिए.

Developer site पर My apps: हर app अपने Active status, नाम, Personal type और API key के साथ.
Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Step 5 — API key और API secret copy कीजिए

#

App page पर दाईं तरफ़ API key और API secret हैं. दोनों copy कीजिए. Re-generate API secret को मत छेड़िए — उससे पुराना secret चलना बंद हो जाएगा.

App page: बाईं तरफ़ App details में App name, Redirect URL और Postback URL; दाईं तरफ़ API key, API secret और Re-generate API secret button.
यही दोनों copy करने हैं. Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

TOTP 1 — Password & Security खोलिए

#

Desktop हर सुबह आपके broker में खुद login करता है, इसलिए उसे आपकी TOTP key चाहिए: TOTP चालू करते समय broker जो QR code दिखाता है, उसके पीछे का letters और digits वाला लंबा code. इसी से desktop वही 6-digit code बनाता है जो आपके authenticator app में दिखता है.

Kite में login कीजिए और अपनी Profile खोलिए (ऊपर दाईं ओर अपने user ID पर click कीजिए).

Profile page पर ऊपर दाईं ओर Password & Security पर click कीजिए.

Kite profile page, ऊपर दाईं ओर Password & Security link पर निशान.
Password & Security दबाइए. Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

TOTP 2 — External TOTP चालू कीजिए

#

नीचे External 2FA TOTP तक scroll कीजिए और Enable external TOTP दबाइए.

External 2FA TOTP section, Enable external TOTP button पर निशान.
Enable external TOTP दबाइए.

TOTP 3 — Email verify कीजिए

#

Kite आपके email पर OTP भेजता है. उसे डालिए और Verify दबाइए.

Kite E-mail verification box, OTP box और Verify button पर निशान.
Email OTP डालिए और Verify दबाइए. Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

TOTP 4 — Key copy कीजिए

#

Kite QR code दिखाता है. उसके नीचे Can’t scan? Copy the key. पर click करके key copy कीजिए.

Authenticator app से QR code scan कीजिए, उसका 6-digit code और अपना Kite password डालिए, और Enable दबाइए.

  • Key copy कीजिए, 6-digit code नहीं. Code हर 30 seconds में बदलता है; key कभी नहीं बदलती.
  • QR code को phone के authenticator app (Google Authenticator, Microsoft Authenticator या Authy) से भी scan कीजिए. Broker की अपनी website और app के लिए उसके codes चाहिए.
  • अगर TOTP बहुत पहले चालू किया था और key save नहीं की, तो TOTP reset करके नई key देखिए, और नया QR code phone में भी scan कीजिए — पुराने codes काम करना बंद कर देते हैं.
  • यह key आपके password जितनी ही निजी है. इसे कभी किसी को मत भेजिए, हमें भी नहीं.
External 2FA TOTP: QR code, Can’t scan? Copy the key link पर निशान, 6-digit TOTP और password boxes, और Enable button पर निशान.
यह link key दिखाता है. Grey boxes में keys, IPs और नाम जैसी निजी details छिपाई गई हैं.

Prices के लिए Connect plan चाहिए

#

Desktop prices  से लेता है. Live prices सिर्फ Connect app को मिलते हैं; free Personal app को नहीं. इसीलिए Step 2 में Connect चुनने को कहा है.

Connect का भुगतान Kite Connect credits से होता है: 9 Nov 2026 को 500 credits (Rs 500) for 30 days. App बनाने से पहले developer site पर Billing में credits डालिए, और हर renewal के लिए काफी credits रखिए. Pay करने से पहले उसी page पर price देख लीजिए.

Website के लिए पहले Personal app बनाया था? Desktop के लिए नया Connect app बनाइए, उसमें static IP और redirect URL डालिए, और यहाँ उसी की key और secret डालिए. Website भी Connect app से चलती है.

Plan के बिना orders तो जाएंगे, पर desktop को इस broker से prices नहीं मिलेंगे: Trade Scalper में feed के पास (no market-data plan) दिखेगा, और MARKET order refuse होगा क्योंकि check करने के लिए कोई price नहीं है. Desktop कभी दूसरे broker से prices उधार नहीं लेता.

Desktop app में card भरिए

#

Desktop app में वापस आइए, Brokers page, आपका  card. ये भरिए:

  • Password — आपका Kite login password.
  • API KEY — आपके app की API key.
  • API SECRET — आपके app का API secret.
  • TOTP Generator — जो TOTP key आपने copy की.
  • हर value बिल्कुल वैसी ही paste कीजिए, आगे-पीछे कोई space नहीं. User ID को वैसे ही छोड़िए — यह आपके Trade Apps account से आता है.
वही card, सिर्फ भरने वाले boxes और Connect button पर निशान.
निशान वाले boxes भरिए, फिर Connect दबाइए. Values छिपी रहती हैं, इसलिए boxes में dots दिखते हैं.

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

#

Connect दबाइए. यह आपकी भरी details save करता है और login करता है. Desktop आपके password और TOTP key से पीछे-पीछे login करता है; कोई broker page नहीं खुलता.

काम हो गया तो grey Not connected label हरा हो जाता है और Connected till 11:59 pm लिखा आता है. Trade Disc और Trade Scalper दोनों यही connection इस्तेमाल करते हैं.

आपकी भरी details encrypted होकर सिर्फ इसी computer पर save होती हैं. हर trading day market खुलने से पहले Brokers page खोलकर एक बार Connect दबाइए. Setup दोबारा नहीं करना. दूसरे computer पर details एक बार फिर भरनी होंगी.

Connect के बाद card: हरा Connected till 11:59 pm label निशान के साथ, static IP label और भरे हुए boxes.
हरा Connected till 11:59 pm — setup पूरा हो गया.

अगर काम न करे

#

Connect fail हो तो वजह card पर labels के नीचे लाल रंग में लिखी आती है. इन्हें इसी क्रम में देखिए; ज़्यादातर गड़बड़ पहले चार में से एक होती है.

  • IP गलत, या गलत box में save. Kite Connect developer site में IP बिल्कुल वही होना चाहिए जो desktop card दिखाता है, IPv6 box में. बदलने के बाद 2 मिनट रुकिए, फिर Connect दोबारा दबाइए.
  • TOTP key गलत. TOTP box में TOTP setup वाली लंबी key चाहिए, आज का 6-digit code नहीं. शक हो तो broker पर TOTP बंद करके फिर चालू कीजिए, नई key copy कीजिए और दोबारा paste कीजिए.
  • Broker पर password या PIN बदल गया. नया card में डालिए और Connect दबाइए.
  • Redirect URL में typo या extra space. Card पर Copy फिर दबाइए और broker पर नए सिरे से paste कीजिए.
  • Key और secret आपस में बदल गए, या साथ में space copy हो गया. हर एक को सही box में दोबारा paste कीजिए.
  • IP app पर save किया पर Profile पर नहीं. IP whitelist Profile page पर होती है. देखिए कि वहाँ है और आपने Update दबाया.
  • Connected है, पर prices नहीं. App Personal है, या Connect credits खत्म हो गए. Connect app बनाइए या Billing में credits डालिए, फिर Connect दोबारा दबाइए.
  • फिर भी नहीं हो रहा? Card का screenshot और समय 9398840360 पर WhatsApp कीजिए. अपना password, PIN, OTP, TOTP key या API secret कभी मत भेजिए — हमें इनकी कभी ज़रूरत नहीं होती.