initial commit

This commit is contained in:
2026-01-31 22:34:57 +09:00
commit f1301de543
875 changed files with 196598 additions and 0 deletions

View File

@@ -0,0 +1,145 @@
"""
Created on 20250601
"""
import sys
import logging
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
from comp_program_trade_daily import comp_program_trade_daily
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내주식] 시세분석 > 프로그램매매 종합현황(일별)[국내주식-115]
##############################################################################################
COLUMN_MAPPING = {
'stck_bsop_date': '주식 영업 일자',
'nabt_entm_seln_tr_pbmn': '비차익 위탁 매도 거래 대금',
'nabt_onsl_seln_vol': '비차익 자기 매도 거래량',
'whol_onsl_seln_tr_pbmn': '전체 자기 매도 거래 대금',
'arbt_smtn_shnu_vol': '차익 합계 매수2 거래량',
'nabt_smtn_shnu_tr_pbmn': '비차익 합계 매수2 거래 대금',
'arbt_entm_ntby_qty': '차익 위탁 순매수 수량',
'nabt_entm_ntby_tr_pbmn': '비차익 위탁 순매수 거래 대금',
'arbt_entm_seln_vol': '차익 위탁 매도 거래량',
'nabt_entm_seln_vol_rate': '비차익 위탁 매도 거래량 비율',
'nabt_onsl_seln_vol_rate': '비차익 자기 매도 거래량 비율',
'whol_onsl_seln_tr_pbmn_rate': '전체 자기 매도 거래 대금 비율',
'arbt_smtm_shun_vol_rate': '차익 합계 매수 거래량 비율',
'nabt_smtm_shun_tr_pbmn_rate': '비차익 합계 매수 거래대금 비율',
'arbt_entm_ntby_qty_rate': '차익 위탁 순매수 수량 비율',
'nabt_entm_ntby_tr_pbmn_rate': '비차익 위탁 순매수 거래 대금',
'arbt_entm_seln_vol_rate': '차익 위탁 매도 거래량 비율',
'nabt_entm_seln_tr_pbmn_rate': '비차익 위탁 매도 거래 대금 비',
'nabt_onsl_seln_tr_pbmn': '비차익 자기 매도 거래 대금',
'whol_smtn_seln_vol': '전체 합계 매도 거래량',
'arbt_smtn_shnu_tr_pbmn': '차익 합계 매수2 거래 대금',
'whol_entm_shnu_vol': '전체 위탁 매수2 거래량',
'arbt_entm_ntby_tr_pbmn': '차익 위탁 순매수 거래 대금',
'nabt_onsl_ntby_qty': '비차익 자기 순매수 수량',
'arbt_entm_seln_tr_pbmn': '차익 위탁 매도 거래 대금',
'whol_seln_vol_rate': '전체 매도 거래량 비율',
'whol_entm_shnu_vol_rate': '전체 위탁 매수 거래량 비율',
'whol_entm_seln_tr_pbmn': '전체 위탁 매도 거래 대금',
'nabt_smtm_seln_vol': '비차익 합계 매도 거래량',
'arbt_entm_shnu_vol': '차익 위탁 매수2 거래량',
'nabt_entm_shnu_tr_pbmn': '비차익 위탁 매수2 거래 대금',
'whol_onsl_shnu_vol': '전체 자기 매수2 거래량',
'arbt_onsl_ntby_tr_pbmn': '차익 자기 순매수 거래 대금',
'nabt_smtn_ntby_qty': '비차익 합계 순매수 수량',
'arbt_onsl_seln_vol': '차익 자기 매도 거래량',
'whol_entm_ntby_qty': '전체 위탁 순매수 수량',
'nabt_onsl_ntby_tr_pbmn': '비차익 자기 순매수 거래 대금',
'arbt_onsl_seln_tr_pbmn': '차익 자기 매도 거래 대금',
'nabt_smtm_seln_tr_pbmn_rate': '비차익 합계 매도 거래대금 비율',
'arbt_entm_shnu_vol_rate': '차익 위탁 매수 거래량 비율',
'nabt_entm_shnu_tr_pbmn_rate': '비차익 위탁 매수 거래 대금 비',
'whol_onsl_shnu_tr_pbmn': '전체 자기 매수2 거래 대금',
'arbt_onsl_ntby_tr_pbmn_rate': '차익 자기 순매수 거래 대금 비',
'nabt_smtm_ntby_qty_rate': '비차익 합계 순매수 수량 비율',
'arbt_onsl_seln_vol_rate': '차익 자기 매도 거래량 비율',
'whol_entm_seln_vol': '전체 위탁 매도 거래량',
'arbt_entm_shnu_tr_pbmn': '차익 위탁 매수2 거래 대금',
'nabt_onsl_shnu_vol': '비차익 자기 매수2 거래량',
'whol_smtn_shnu_vol': '전체 합계 매수2 거래량',
'arbt_smtn_ntby_tr_pbmn': '차익 합계 순매수 거래 대금',
'arbt_smtn_seln_vol': '차익 합계 매도 거래량',
'whol_entm_seln_tr_pbmn_rate': '전체 위탁 매도 거래 대금 비율',
'nabt_onsl_seln_vol_rate': '전체 자기 매도 거래량 비율',
'arbt_onsl_shnu_vol_rate': '차익 자기 매수 거래량 비율',
'nabt_smtm_shun_vol_rate': '비차익 합계 매수 거래량 비율',
'whol_shun_tr_pbmn_rate': '전체 매수 거래대금 비율',
'nabt_entm_ntby_qty_rate': '비차익 위탁 순매수 수량 비율',
'arbt_smtm_seln_tr_pbmn_rate': '차익 합계 매도 거래대금 비율',
'arbt_onsl_shnu_vol': '차익 자기 매수2 거래량',
'nabt_onsl_shnu_tr_pbmn': '비차익 자기 매수2 거래 대금',
'nabt_smtn_shnu_vol': '비차익 합계 매수2 거래량',
'whol_smtn_shnu_tr_pbmn': '전체 합계 매수2 거래 대금',
'arbt_smtm_ntby_qty': '차익 합계 순매수 수량',
'nabt_smtn_ntby_tr_pbmn': '비차익 합계 순매수 거래 대금',
'arbt_smtn_seln_tr_pbmn': '차익 합계 매도 거래 대금',
'arbt_onsl_shnu_tr_pbmn_rate': '차익 자기 매수 거래 대금 비율',
'whol_shun_vol_rate': '전체 매수 거래량 비율',
'arbt_smtm_ntby_tr_pbmn_rate': '차익 합계 순매수 거래대금 비율',
'whol_entm_ntby_qty_rate': '전체 위탁 순매수 수량 비율',
'arbt_smtm_seln_tr_pbmn_rate': '차익 합계 매도 거래대금 비율'
}
NUMERIC_COLUMNS = []
def main():
"""
프로그램매매 종합현황(일별) 조회 테스트 함수
이 함수는 프로그램매매 종합현황(일별) API를 호출하여 결과를 출력합니다.
Returns:
None
"""
# pandas 출력 옵션 설정
pd.set_option('display.max_columns', None) # 모든 컬럼 표시
pd.set_option('display.width', None) # 출력 너비 제한 해제
pd.set_option('display.max_rows', None) # 모든 행 표시
# 인증 토큰 발급
ka.auth()
# case1 조회
logging.info("=== case1 조회 ===")
try:
result = comp_program_trade_daily(
fid_cond_mrkt_div_code="J",
fid_mrkt_cls_code="K",
fid_input_date_1="20250101",
fid_input_date_2="20250617"
)
except ValueError as e:
logging.error("에러 발생: %s" % str(e))
return
logging.info("사용 가능한 컬럼: %s", result.columns.tolist())
# 컬럼명 한글 변환 및 데이터 출력
result = result.rename(columns=COLUMN_MAPPING)
# 숫자형 컬럼 (메타데이터에 number로 명시적으로 선언된 필드가 없음)
for col in NUMERIC_COLUMNS:
if col in result.columns:
result[col] = pd.to_numeric(result[col], errors='coerce').round(2)
logging.info("결과:")
print(result)
if __name__ == "__main__":
main()

View File

@@ -0,0 +1,69 @@
"""
Created on 20250601
"""
import sys
import logging
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내주식] 시세분석 > 프로그램매매 종합현황(일별)[국내주식-115]
##############################################################################################
# 상수 정의
API_URL = "/uapi/domestic-stock/v1/quotations/comp-program-trade-daily"
def comp_program_trade_daily(
fid_cond_mrkt_div_code: str, # [필수] 조건시장분류코드 (ex. J:주식,NX:NXT,UN:통합)
fid_mrkt_cls_code: str, # [필수] 시장구분코드 (ex. K:코스피,Q:코스닥)
fid_input_date_1: str = "", # 검색시작일
fid_input_date_2: str = "" # 검색종료일
) -> pd.DataFrame:
"""
프로그램매매 종합현황(일별) API입니다.
한국투자 HTS(eFriend Plus) > [0460] 프로그램매매 종합현황 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
Args:
fid_cond_mrkt_div_code (str): [필수] 조건시장분류코드 (ex. J:주식,NX:NXT,UN:통합)
fid_mrkt_cls_code (str): [필수] 시장구분코드 (ex. K:코스피,Q:코스닥)
fid_input_date_1 (str): 검색시작일
fid_input_date_2 (str): 검색종료일
Returns:
pd.DataFrame: 프로그램매매 종합현황(일별) 데이터
Example:
>>> df = comp_program_trade_daily("J", "K", "20250101", "20250617")
>>> print(df)
"""
if fid_cond_mrkt_div_code == "":
raise ValueError("fid_cond_mrkt_div_code is required (e.g. 'J:주식,NX:NXT,UN:통합')")
if fid_mrkt_cls_code == "":
raise ValueError("fid_mrkt_cls_code is required (e.g. 'K:코스피,Q:코스닥')")
tr_id = "FHPPG04600001"
params = {
"FID_COND_MRKT_DIV_CODE": fid_cond_mrkt_div_code,
"FID_MRKT_CLS_CODE": fid_mrkt_cls_code,
"FID_INPUT_DATE_1": fid_input_date_1,
"FID_INPUT_DATE_2": fid_input_date_2
}
res = ka._url_fetch(API_URL, tr_id, "", params)
if res.isOK():
return pd.DataFrame(res.getBody().output)
else:
res.printError(url=API_URL)
return pd.DataFrame()