KIS-Agent — Korea Investment & Securities OpenAPI, artık tek bir `pip` ile

Korea Investment & Securities OpenAPI’yi kullanmak için resmi dokümantasyonu açıp sonra kapatanlar için bunu yaptım.
Kimlik doğrulama token’ı yönetimi, Rate Limit’i kollama, stck_prpr gibi alan adlarını çözme, 100 kayıtlık sayfalama döngüsü — bunların hepsini her seferinde elle yazmak doğru mu diye düşününce bunu bir wrapper içinde topladım.

Neler yapabiliyor?
Doğrudan terminalden:

kis price 005930           # Samsung Electronics anlık fiyatı  
kis balance --holdings     # hesap bakiyesi + elde tutulan varlıklar  
kis overseas NAS AAPL      # Nasdaq AAPL  

Kod içinde:

agent = Agent(app_key=..., app_secret=..., account_no=...)  
price = agent.get_stock_price("005930")  
agent.order_stock_cash("buy", "005930", "03", "1", "0")  # piyasa emriyle alım  

LLM ajan aracı olarak:
JSON çıktısı + kis schema tip keşfi ile doğrudan GPT/Claude tool call’a bağlanabiliyor.

Başlıca çözdüğü noktalar

Alan adlarını otomatik dönüştürme — stck_prpr → currentPrice. Resmi yanıtı olduğu gibi almak zorunda değilsiniz
Yerleşik Rate Limiting — ölçüme dayalı 18 RPS / 900 RPM. Patladıktan sonra ayar yapmanız gerekmez
Önbellekleme — aynı istek tekrarlandığında API çağrıları %80~95 azalır
100 kayıt sınırını aşma — get_daily_price_all() ile tüm dönem otomatik toplanır
96 adet TypedDict modeli — IDE otomatik tamamlama ve type checker’ların tamamı çalışır

Destek kapsamı
Yurt içi (KOSPI/KOSDAQ/NXT) · yurt dışı 9 borsa (NASDAQ, NYSE, Tokyo, Şanghay, Hong Kong, Vietnam vb.) · yurt içi/yurt dışı vadeli işlem ve opsiyonlar · WebSocket gerçek zamanlı akış · yatırımcı/program işlemleri/aracı kurum bazlı eğilim analizi

Kişisel trading otomasyonu amacıyla geliştirdiğim için, uygulamada gerçekten kullanılan şeylere odaklanarak implement ettim. Resmi API’de olup eksik kalan bir özellik varsa issue bırakın, ekleyeyim.