KIS-Agent — Korea Investment & Securities OpenAPI, अब सिर्फ एक pip से
(github.com/Intrect-io)यह उन लोगों के लिए बनाया गया है जिन्होंने Korea Investment & Securities OpenAPI इस्तेमाल करने के लिए आधिकारिक दस्तावेज़ खोला और फिर बंद कर दिया।
ऑथ टोकन मैनेजमेंट, Rate Limit का अंदाज़ा लगाना, stck_prpr जैसे field names को समझना, 100-आइटम pagination loop — हर बार यह सब खुद लिखना सही है या नहीं, यही सोचकर इसे एक wrapper में बाँध दिया।
क्या-क्या किया जा सकता है
टर्मिनल से सीधे:
kis price 005930 # Samsung Electronics वर्तमान मूल्य
kis balance --holdings # खाता बैलेंस + होल्डिंग्स
kis overseas NAS AAPL # Nasdaq AAPL
कोड में:
agent = Agent(app_key=..., app_secret=..., account_no=...)
price = agent.get_stock_price("005930")
agent.order_stock_cash("buy", "005930", "03", "1", "0") # मार्केट buy
LLM agent tool के रूप में:
JSON output + kis schema type exploration के साथ इसे GPT/Claude tool call में सीधे जोड़ा जा सकता है।
मुख्य समाधान बिंदु
field name auto-conversion — stck_prpr → currentPrice। आधिकारिक response को ज्यों-का-त्यों लेने की ज़रूरत नहीं
Rate Limiting built-in — मापे गए आधार पर 18 RPS / 900 RPM। error आने के बाद adjust करने की ज़रूरत नहीं
caching — एक ही request दोहराने पर API call 80~95% तक कम
100-आइटम सीमा से बचाव — get_daily_price_all() के साथ पूरे अवधि का ऑटोमेटिक संग्रह
96 TypedDict models — IDE autocomplete और type checker सब काम करते हैं
समर्थन दायरा
घरेलू बाज़ार (KOSPI/KOSDAQ/NXT) · विदेशी 9 एक्सचेंज (NASDAQ, NYSE, टोक्यो, शंघाई, हांगकांग, वियतनाम आदि) · घरेलू/विदेशी futures और options · WebSocket real-time streaming · निवेशक/प्रोग्राम ट्रेडिंग/सिक्योरिटीज़ कंपनी-वार ट्रेंड विश्लेषण
इसे व्यक्तिगत trading automation के उद्देश्य से बनाते-बनाते, मुख्य रूप से वही चीज़ें लागू की गई हैं जो वास्तव में प्रैक्टिकल उपयोग में आती हैं। आधिकारिक API में मौजूद लेकिन छूटी हुई सुविधाएँ हों तो issue छोड़ दें, मैं उन्हें जोड़ दूँगा।
अभी कोई टिप्पणी नहीं है.