KIS-Agent — OpenAPI Korea Investment & Securities, kini cukup dengan satu `pip`

Saya membuat ini untuk Anda yang pernah membuka lalu menutup dokumentasi resmi saat ingin memakai OpenAPI Korea Investment & Securities.
Mengelola token autentikasi, menyiasati Rate Limit, mengartikan nama field seperti stck_prpr, loop pagination 100 item — rasanya tidak masuk akal jika harus menulis semua itu sendiri setiap saat, jadi saya bungkus sebagai wrapper.

Apa yang bisa dilakukan
Langsung dari terminal:
bash kis price 005930 # harga terkini Samsung Electronics kis balance --holdings # saldo akun + saham yang dimiliki kis overseas NAS AAPL # AAPL di Nasdaq Di dalam kode:
python agent = Agent(app_key=..., app_secret=..., account_no=...) price = agent.get_stock_price("005930") agent.order_stock_cash("buy", "005930", "03", "1", "0") # beli di harga pasar Sebagai alat untuk agen LLM:
Dengan output JSON + penelusuran tipe schema kis, bisa langsung dipasang ke tool call GPT/Claude.

Poin utama yang diselesaikan

Konversi nama field otomatis — stck_prpr → currentPrice. Tidak perlu menerima respons resmi apa adanya
Rate Limiting bawaan — 18 RPS / 900 RPM berbasis pengukuran nyata. Tidak perlu menyesuaikan setelah error terjadi
Caching — saat permintaan yang sama diulang, panggilan API berkurang 80~95%
Melewati batas 100 item — kumpulkan otomatis seluruh periode dengan get_daily_price_all()
96 model TypedDict — autocomplete IDE dan type checker semuanya berfungsi

Cakupan dukungan
Domestik (KOSPI/KOSDAQ/NXT) · 9 bursa luar negeri (NASDAQ, NYSE, Tokyo, Shanghai, Hong Kong, Vietnam, dll.) · futures dan options domestik maupun luar negeri · streaming real-time WebSocket · analisis tren investor/program trading/per perusahaan sekuritas

Karena awalnya dibuat untuk otomasi trading pribadi, implementasinya berfokus pada hal-hal yang benar-benar dipakai di praktik nyata. Jika ada fitur API resmi yang tersedia tetapi belum masuk, silakan tinggalkan issue dan akan saya tambahkan.