성능 및 캐싱¶
캐싱¶
kis-agent는 지능형 캐싱으로 API 호출을 80-95% 줄입니다.
캐시 적중률¶
- 동일 종목 반복 조회 시 캐시에서 즉시 반환
- 응답 TTL 기반으로 자동 갱신
- 캐시 적중 시 응답 시간 50ms 이하
토큰 캐시¶
인증 토큰은 우선적으로 캐시되어 불필요한 토큰 발급 API 호출을 방지합니다.
Rate Limiting¶
한국투자증권 API의 실측 안정 기준:
| 항목 | 제한 |
|---|---|
| 초당 요청 수 (RPS) | 18 |
| 분당 요청 수 (RPM) | 900 |
kis-agent는 이 제한을 자동으로 준수합니다. 제한 초과 시 자동으로 대기 후 재시도합니다.
동시성¶
- 멀티스레드 안전성 보장
- WebSocket은 asyncio 기반 비동기 처리
- 장기 데이터 조회 시 자동 페이지네이션 (100건 제한 우회)
성능 요약¶
| 항목 | 수치 |
|---|---|
| 캐시 적중률 | 80-95% |
| 캐시 적중 응답 | < 50ms |
| Rate Limiting | 18 RPS / 900 RPM |
| 동시 연결 | 멀티스레드 안전 |