Zerodha Kite Connect API Tutorial in Hindi: Access Token, Live Quotes, Rate Limits और Errors

Introduction

अगर आप Zerodha Kite Connect API का इस्तेमाल करके Python में Algo Trading System, Futures Scanner या Trading Dashboard बनाना चाहते हैं, तो केवल API से Login करना सीखना पर्याप्त नहीं है।

एक Stable Trading Application बनाने के लिए आपको Access Token Management, Instrument List, Live Market Quotes, API Rate Limits और Error Handling को भी समझना जरूरी है।

इस Tutorial में हम जानेंगे कि इन सभी चीजों को सही तरीके से कैसे Manage करें, ताकि आपका Python Application अधिक Reliable तरीके से काम कर सके।

1. Access Token Validity और Session Management

Kite Connect API में Access Token का इस्तेमाल Authenticated API Requests भेजने के लिए किया जाता है।

Access Token की Validity सीमित होती है। सामान्यतः यह एक दिन के लिए Valid रहता है, इसलिए अगले दिन API इस्तेमाल करने के लिए दोबारा Authentication करना पड़ सकता है।

Access Token Expire होने पर क्या करें?

अगर आपका Access Token Expire या Invalidate हो जाता है, तो API Requests असफल हो सकती हैं।

इस स्थिति में:

Token से संबंधित Error को पहचानें।
पुराने Session को Invalid मानें।
Zerodha की Login और Authentication Process दोबारा पूरी करें।
नया Access Token प्राप्त करें।
API Requests दोबारा शुरू करने से पहले Authentication Verify करें।

Best Practice: Access Token को सुरक्षित रखें और Application में Token Expiry या Authentication Failure को Handle करने की व्यवस्था बनाएँ।

2. Instrument List और Live Market Quotes

Kite Connect API के साथ काम करते समय Instrument List बहुत महत्वपूर्ण होती है।

Instrument List में उपलब्ध Instruments की जानकारी, जैसे Trading Symbol, Exchange, Instrument Token, Expiry और अन्य Contract Details शामिल हो सकती हैं।

यदि आप Futures Scanner या Options Scanner बना रहे हैं, तो इसी जानकारी का इस्तेमाल करके आवश्यक Contracts Filter कर सकते हैं।

Instrument List कैसे प्राप्त करें?

Python में नीचे दिया गया Code इस्तेमाल करें:

from kiteconnect import KiteConnect
import pandas as pd

api_key = "YOUR_API_KEY"
access_token = "YOUR_ACCESS_TOKEN"

kite = KiteConnect(api_key=api_key)
kite.set_access_token(access_token)

instruments = kite.instruments()

df = pd.DataFrame(instruments)

print(df.head())

यह Code Authenticated Kite Connect Client से Instrument List प्राप्त करके उसे Pandas DataFrame में बदलता है।

ध्यान दें कि सफल API Access और Valid Session आवश्यक हैं।

Instrument List को Daily Update क्यों करना चाहिए?

Instrument List में समय के साथ बदलाव हो सकते हैं। नए Contracts जुड़ सकते हैं और Expired Contracts का उपयोग आगे नहीं करना चाहिए।

इसलिए बेहतर तरीका है कि आप प्रत्येक दिन Instrument List डाउनलोड करके उसे अपडेट करें।

इससे पुराने Instrument Tokens या Expired Contracts के कारण होने वाली समस्याओं का जोखिम कम हो सकता है।

Live Market Quotes कैसे प्राप्त करें?

यदि आपके पास किसी Instrument का सही Trading Symbol है, तो आप उसके लिए Market Quote प्राप्त कर सकते हैं।

उदाहरण:

quotes = kite.quote(["NSE:INFY"])

print(quotes)

यह उदाहरण NSE पर Infosys के लिए Quote Request करता है। वास्तविक Data की उपलब्धता Market Status, API Access और Instrument Availability पर निर्भर करती है।

एक साथ कई Instruments के Quotes प्राप्त करने से पहले API की वर्तमान Request Limits और Endpoint Restrictions जाँचें।

3. API Rate Limits क्या हैं?

Rate Limits का मतलब है कि आपका Application एक निश्चित समय में कितनी API Requests भेज सकता है।

यदि Python Script बहुत तेजी से Requests भेजती है, तो API Rate Limit पार हो सकती है और आपको HTTP 429 Error मिल सकता है।

उदाहरण के लिए, यदि आपका Futures Scanner सैकड़ों Contracts को बार-बार Check करता है, तो बिना Request Management के API पर अनावश्यक Load बढ़ सकता है।

Rate Limits से बचने के तरीके

API Documentation में दिए गए वर्तमान Limits को Follow करें।

अनावश्यक बार-बार Requests भेजने से बचें।
जहाँ उपयुक्त हो, Batch या Multi-Instrument Requests का इस्तेमाल करें।
जरूरत के अनुसार Polling Interval निर्धारित करें।
Requests को Queue के माध्यम से नियंत्रित करें।
Temporary Errors के लिए सीमित Retries और Backoff लागू करें।

Python में Basic Retry और Backoff Example

import time
from kiteconnect import KiteConnect
from kiteconnect.exceptions import NetworkException

def fetch_quotes(kite, instruments, retries=3):
    for attempt in range(retries):
        try:
            return kite.quote(instruments)

        except NetworkException:
            if attempt == retries - 1:
                raise

            time.sleep(2 ** attempt)

यह Code केवल Network Exceptions के लिए सीमित Retry का उदाहरण है। यह सभी Rate Limit या API Errors को Automatically Handle नहीं करता।

Production Application में HTTP 429, Temporary Server Errors और अन्य Exceptions को उनकी प्रकृति के अनुसार अलग-अलग Handle करना चाहिए। Retry करने से पहले यह भी सुनिश्चित करें कि Request दोबारा भेजना उचित है।

4. Kite Connect API Exceptions क्या हैं?

API का इस्तेमाल करते समय विभिन्न प्रकार की Errors आ सकती हैं।

इन Errors को समझने से आपको समस्या की वजह पहचानने और सही समाधान लागू करने में मदद मिलती है।

Common Kite Connect Exceptions

Exception	अर्थ और संभावित कारण
`TokenException`	Session Expired या Invalid हो गया है
`UserException`	User Account से संबंधित समस्या
`OrderException`	Order Placement या Order Retrieval में समस्या
`InputException`	Required Parameter Missing या Invalid है
`MarginException`	Order के लिए पर्याप्त Margin उपलब्ध नहीं है
`HoldingException`	Sell Order के लिए पर्याप्त Holdings उपलब्ध नहीं हैं
`NetworkException`	Network या API Communication से संबंधित समस्या
`DataException`	Response Data को Process करने में समस्या
`GeneralException`	अन्य सामान्य या Unclassified Error

इन Exceptions के सही अर्थ और व्यवहार के लिए Official Documentation देखें, क्योंकि किसी Error का वास्तविक कारण Request और Response Context पर निर्भर कर सकता है।

Python में Exception Handling का उदाहरण

from kiteconnect import KiteConnect
from kiteconnect.exceptions import (
    TokenException,
    InputException,
    NetworkException
)

try:
    quotes = kite.quote(["NSE:INFY"])
    print(quotes)

except TokenException:
    print("Session invalid. Please authenticate again.")

except InputException as error:
    print("Check request parameters:", error)

except NetworkException as error:
    print("Network error:", error)

इस उदाहरण में अलग-अलग Exceptions के लिए अलग Messages दिखाए गए हैं।

वास्तविक Trading Application में केवल Message दिखाना पर्याप्त नहीं है। आपको Logging, Monitoring और Recovery Process भी Implement करनी चाहिए।

5. Common HTTP Error Codes और उनके Solutions

Kite Connect API का इस्तेमाल करते समय HTTP Status Codes भी उपयोगी जानकारी देते हैं।

HTTP Code	अर्थ	क्या करें?
`400`	Request Parameters गलत या Missing हैं	Parameters और Data Types जाँचें
`403`	Session Invalid या Expired हो सकता है	Authentication दोबारा पूरा करें
`404`	Requested Resource नहीं मिला	Endpoint और Resource जाँचें
`405`	HTTP Method अनुमत नहीं है	सही GET या POST Method इस्तेमाल करें
`410`	Resource अब उपलब्ध नहीं है	वर्तमान API Documentation देखें
`429`	Rate Limit पार हो गई	Request Rate कम करें और उचित Backoff लागू करें
`500`	Internal Server Error	Error Log करें और जरूरत के अनुसार Retry करें
`502`	Upstream Service से संबंधित समस्या	Service Status जाँचें और सावधानी से Retry करें
`503`	Service Unavailable	कुछ समय बाद दोबारा प्रयास करें
`504`	Gateway Timeout	Network और Service Availability जाँचें

महत्वपूर्ण: HTTP Status Code अकेले हमेशा पूरी समस्या नहीं बताता। API Response Body और Official Error Documentation भी जाँचें।

6. Stable Trading Script बनाने के लिए Best Practices

यदि आप Zerodha API के साथ एक Reliable Trading Application बनाना चाहते हैं, तो इन Practices को अपनाएँ:

Daily Instrument Refresh: Instrument List को नियमित रूप से अपडेट करें।
Authentication Management: Expired या Invalid Session को सही तरीके से Handle करें।
Rate Limit Control: API Requests को नियंत्रित करें।
Exception Handling: Errors को पहचानकर उचित Recovery लागू करें।
Logging: Request Failures, Order IDs और महत्वपूर्ण Events का सुरक्षित Log रखें।
Order Verification: Order भेजने के बाद उसका वास्तविक Status Verify करें।
Risk Management: Position Limits, Stop-Loss और Exposure Controls लागू करें।
Credential Security: API Secret और Access Token को सुरक्षित रखें।

ध्यान रखें कि Order Request भेजने का अर्थ यह नहीं है कि Order सफलतापूर्वक Execute हो गया है। वास्तविक Order Status और Executed Quantity की जाँच आवश्यक है।

7. Official Kite Connect Documentation

Kite Connect API से संबंधित Errors, Exceptions और अन्य Technical Details के लिए Official Documentation देखें:

Errors and Exceptions: https://kite.trade/docs/connect/v3/exceptions/
Kite Connect Documentation: https://kite.trade/docs/connect/v3/

API Limits, Endpoint Behaviour और उपलब्ध Features में बदलाव हो सकते हैं, इसलिए अपने Application को वर्तमान Documentation के अनुसार बनाएँ।

Conclusion

इस Tutorial में आपने सीखा कि Zerodha Kite Connect API के साथ काम करते समय Access Token, Instrument List, Live Quotes, Rate Limits और Error Handling को कैसे समझें।

ये Concepts Python आधारित Futures Scanner, Options Scanner, Portfolio Dashboard और Automated Trading System को अधिक Reliable बनाने में मदद करते हैं।

Next Tutorial: Python से Zerodha Kite Connect API के माध्यम से Historical Data प्राप्त करना और Trading Indicators Calculate करना सीखें।

J10. Zerodha Kite Connect API Tutorial in Hindi: