GoogleAIBuilder/KisStock0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

initial commit

Browse Source
This commit is contained in:
tindevil
2026-02-04 00:16:34 +09:00
commit ae11528dd9
867 changed files with 209640 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

278
한국투자증권(API)/examples_llm/domestic_stock/intgr_margin/chk_intgr_margin.py Normal file
View File

@@ -0,0 +1,278 @@
"""
Created on 20250601
"""
import sys
import logging
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
from intgr_margin import intgr_margin
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내주식] 주문/계좌 > 주식통합증거금 현황 [국내주식-191]
##############################################################################################
COLUMN_MAPPING = {
'acmga_rt': '계좌증거금율',
'acmga_pct100_aptm_rson': '계좌증거금100퍼센트지정사유',
'stck_cash_objt_amt': '주식현금대상금액',
'stck_sbst_objt_amt': '주식대용대상금액',
'stck_evlu_objt_amt': '주식평가대상금액',
'stck_ruse_psbl_objt_amt': '주식재사용가능대상금액',
'stck_fund_rpch_chgs_objt_amt': '주식펀드환매대금대상금액',
'stck_fncg_rdpt_objt_atm': '주식융자상환금대상금액',
'bond_ruse_psbl_objt_amt': '채권재사용가능대상금액',
'stck_cash_use_amt': '주식현금사용금액',
'stck_sbst_use_amt': '주식대용사용금액',
'stck_evlu_use_amt': '주식평가사용금액',
'stck_ruse_psbl_amt_use_amt': '주식재사용가능금사용금액',
'stck_fund_rpch_chgs_use_amt': '주식펀드환매대금사용금액',
'stck_fncg_rdpt_amt_use_amt': '주식융자상환금사용금액',
'bond_ruse_psbl_amt_use_amt': '채권재사용가능금사용금액',
'stck_cash_ord_psbl_amt': '주식현금주문가능금액',
'stck_sbst_ord_psbl_amt': '주식대용주문가능금액',
'stck_evlu_ord_psbl_amt': '주식평가주문가능금액',
'stck_ruse_psbl_ord_psbl_amt': '주식재사용가능주문가능금액',
'stck_fund_rpch_ord_psbl_amt': '주식펀드환매주문가능금액',
'bond_ruse_psbl_ord_psbl_amt': '채권재사용가능주문가능금액',
'rcvb_amt': '미수금액',
'stck_loan_grta_ruse_psbl_amt': '주식대출보증금재사용가능금액',
'stck_cash20_max_ord_psbl_amt': '주식현금20최대주문가능금액',
'stck_cash30_max_ord_psbl_amt': '주식현금30최대주문가능금액',
'stck_cash40_max_ord_psbl_amt': '주식현금40최대주문가능금액',
'stck_cash50_max_ord_psbl_amt': '주식현금50최대주문가능금액',
'stck_cash60_max_ord_psbl_amt': '주식현금60최대주문가능금액',
'stck_cash100_max_ord_psbl_amt': '주식현금100최대주문가능금액',
'stck_rsip100_max_ord_psbl_amt': '주식재사용불가100최대주문가능',
'bond_max_ord_psbl_amt': '채권최대주문가능금액',
'stck_fncg45_max_ord_psbl_amt': '주식융자45최대주문가능금액',
'stck_fncg50_max_ord_psbl_amt': '주식융자50최대주문가능금액',
'stck_fncg60_max_ord_psbl_amt': '주식융자60최대주문가능금액',
'stck_fncg70_max_ord_psbl_amt': '주식융자70최대주문가능금액',
'stck_stln_max_ord_psbl_amt': '주식대주최대주문가능금액',
'lmt_amt': '한도금액',
'ovrs_stck_itgr_mgna_dvsn_name': '해외주식통합증거금구분명',
'usd_objt_amt': '미화대상금액',
'usd_use_amt': '미화사용금액',
'usd_ord_psbl_amt': '미화주문가능금액',
'hkd_objt_amt': '홍콩달러대상금액',
'hkd_use_amt': '홍콩달러사용금액',
'hkd_ord_psbl_amt': '홍콩달러주문가능금액',
'jpy_objt_amt': '엔화대상금액',
'jpy_use_amt': '엔화사용금액',
'jpy_ord_psbl_amt': '엔화주문가능금액',
'cny_objt_amt': '위안화대상금액',
'cny_use_amt': '위안화사용금액',
'cny_ord_psbl_amt': '위안화주문가능금액',
'usd_ruse_objt_amt': '미화재사용대상금액',
'usd_ruse_amt': '미화재사용금액',
'usd_ruse_ord_psbl_amt': '미화재사용주문가능금액',
'hkd_ruse_objt_amt': '홍콩달러재사용대상금액',
'hkd_ruse_amt': '홍콩달러재사용금액',
'hkd_ruse_ord_psbl_amt': '홍콩달러재사용주문가능금액',
'jpy_ruse_objt_amt': '엔화재사용대상금액',
'jpy_ruse_amt': '엔화재사용금액',
'jpy_ruse_ord_psbl_amt': '엔화재사용주문가능금액',
'cny_ruse_objt_amt': '위안화재사용대상금액',
'cny_ruse_amt': '위안화재사용금액',
'cny_ruse_ord_psbl_amt': '위안화재사용주문가능금액',
'usd_gnrl_ord_psbl_amt': '미화일반주문가능금액',
'usd_itgr_ord_psbl_amt': '미화통합주문가능금액',
'hkd_gnrl_ord_psbl_amt': '홍콩달러일반주문가능금액',
'hkd_itgr_ord_psbl_amt': '홍콩달러통합주문가능금액',
'jpy_gnrl_ord_psbl_amt': '엔화일반주문가능금액',
'jpy_itgr_ord_psbl_amt': '엔화통합주문가능금액',
'cny_gnrl_ord_psbl_amt': '위안화일반주문가능금액',
'cny_itgr_ord_psbl_amt': '위안화통합주문가능금액',
'stck_itgr_cash20_ord_psbl_amt': '주식통합현금20주문가능금액',
'stck_itgr_cash30_ord_psbl_amt': '주식통합현금30주문가능금액',
'stck_itgr_cash40_ord_psbl_amt': '주식통합현금40주문가능금액',
'stck_itgr_cash50_ord_psbl_amt': '주식통합현금50주문가능금액',
'stck_itgr_cash60_ord_psbl_amt': '주식통합현금60주문가능금액',
'stck_itgr_cash100_ord_psbl_amt': '주식통합현금100주문가능금액',
'stck_itgr_100_ord_psbl_amt': '주식통합100주문가능금액',
'stck_itgr_fncg45_ord_psbl_amt': '주식통합융자45주문가능금액',
'stck_itgr_fncg50_ord_psbl_amt': '주식통합융자50주문가능금액',
'stck_itgr_fncg60_ord_psbl_amt': '주식통합융자60주문가능금액',
'stck_itgr_fncg70_ord_psbl_amt': '주식통합융자70주문가능금액',
'stck_itgr_stln_ord_psbl_amt': '주식통합대주주문가능금액',
'bond_itgr_ord_psbl_amt': '채권통합주문가능금액',
'stck_cash_ovrs_use_amt': '주식현금해외사용금액',
'stck_sbst_ovrs_use_amt': '주식대용해외사용금액',
'stck_evlu_ovrs_use_amt': '주식평가해외사용금액',
'stck_re_use_amt_ovrs_use_amt': '주식재사용금액해외사용금액',
'stck_fund_rpch_ovrs_use_amt': '주식펀드환매해외사용금액',
'stck_fncg_rdpt_ovrs_use_amt': '주식융자상환해외사용금액',
'bond_re_use_ovrs_use_amt': '채권재사용해외사용금액',
'usd_oth_mket_use_amt': '미화타시장사용금액',
'jpy_oth_mket_use_amt': '엔화타시장사용금액',
'cny_oth_mket_use_amt': '위안화타시장사용금액',
'hkd_oth_mket_use_amt': '홍콩달러타시장사용금액',
'usd_re_use_oth_mket_use_amt': '미화재사용타시장사용금액',
'jpy_re_use_oth_mket_use_amt': '엔화재사용타시장사용금액',
'cny_re_use_oth_mket_use_amt': '위안화재사용타시장사용금액',
'hkd_re_use_oth_mket_use_amt': '홍콩달러재사용타시장사용금액',
'hgkg_cny_re_use_amt': '홍콩위안화재사용금액',
'usd_frst_bltn_exrt': '미국달러최초고시환율',
'hkd_frst_bltn_exrt': '홍콩달러최초고시환율',
'jpy_frst_bltn_exrt': '일본엔화최초고시환율',
'cny_frst_bltn_exrt': '중국위안화최초고시환율'
}
NUMERIC_COLUMNS = [
'계좌증거금율',
'주식현금대상금액',
'주식대용대상금액',
'주식평가대상금액',
'주식재사용가능대상금액',
'주식펀드환매대금대상금액',
'주식융자상환금대상금액',
'채권재사용가능대상금액',
'주식현금사용금액',
'주식대용사용금액',
'주식평가사용금액',
'주식재사용가능금사용금액',
'주식펀드환매대금사용금액',
'주식융자상환금사용금액',
'채권재사용가능금사용금액',
'주식현금주문가능금액',
'주식대용주문가능금액',
'주식평가주문가능금액',
'주식재사용가능주문가능금액',
'주식펀드환매주문가능금액',
'채권재사용가능주문가능금액',
'미수금액',
'주식대출보증금재사용가능금액',
'주식현금20최대주문가능금액',
'주식현금30최대주문가능금액',
'주식현금40최대주문가능금액',
'주식현금50최대주문가능금액',
'주식현금60최대주문가능금액',
'주식현금100최대주문가능금액',
'주식재사용불가100최대주문가능',
'채권최대주문가능금액',
'주식융자45최대주문가능금액',
'주식융자50최대주문가능금액',
'주식융자60최대주문가능금액',
'주식융자70최대주문가능금액',
'주식대주최대주문가능금액',
'한도금액',
'미화대상금액',
'미화사용금액',
'미화주문가능금액',
'홍콩달러대상금액',
'홍콩달러사용금액',
'홍콩달러주문가능금액',
'엔화대상금액',
'엔화사용금액',
'엔화주문가능금액',
'위안화대상금액',
'위안화사용금액',
'위안화주문가능금액',
'미화재사용대상금액',
'미화재사용금액',
'미화재사용주문가능금액',
'홍콩달러재사용대상금액',
'홍콩달러재사용금액',
'홍콩달러재사용주문가능금액',
'엔화재사용대상금액',
'엔화재사용금액',
'엔화재사용주문가능금액',
'위안화재사용대상금액',
'위안화재사용금액',
'위안화재사용주문가능금액',
'미화일반주문가능금액',
'미화통합주문가능금액',
'홍콩달러일반주문가능금액',
'홍콩달러통합주문가능금액',
'엔화일반주문가능금액',
'엔화통합주문가능금액',
'위안화일반주문가능금액',
'위안화통합주문가능금액',
'주식통합현금20주문가능금액',
'주식통합현금30주문가능금액',
'주식통합현금40주문가능금액',
'주식통합현금50주문가능금액',
'주식통합현금60주문가능금액',
'주식통합현금100주문가능금액',
'주식통합100주문가능금액',
'주식통합융자45주문가능금액',
'주식통합융자50주문가능금액',
'주식통합융자60주문가능금액',
'주식통합융자70주문가능금액',
'주식통합대주주문가능금액',
'채권통합주문가능금액',
'주식현금해외사용금액',
'주식대용해외사용금액',
'주식평가해외사용금액',
'주식재사용금액해외사용금액',
'주식펀드환매해외사용금액',
'주식융자상환해외사용금액',
'채권재사용해외사용금액',
'미화타시장사용금액',
'엔화타시장사용금액',
'위안화타시장사용금액',
'홍콩달러타시장사용금액',
'미화재사용타시장사용금액',
'엔화재사용타시장사용금액',
'위안화재사용타시장사용금액',
'홍콩달러재사용타시장사용금액',
'홍콩위안화재사용금액',
'미국달러최초고시환율',
'홍콩달러최초고시환율',
'일본엔화최초고시환율',
'중국위안화최초고시환율'
]
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()
trenv = ka.getTREnv()
# case1 조회
logging.info("=== case1 조회 ===")
try:
result = intgr_margin(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, cma_evlu_amt_icld_yn="N", wcrc_frcr_dvsn_cd="01",
fwex_ctrt_frcr_dvsn_cd="01")
except ValueError as e:
logging.error("에러 발생: %s", str(e))
return
logging.info("사용 가능한 컬럼: %s", result.columns.tolist())
# 컬럼명 한글 변환 및 데이터 출력
result = result.rename(columns=COLUMN_MAPPING)
# 숫자형 컬럼 소수점 둘째자리까지 표시
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()

85
한국투자증권(API)/examples_llm/domestic_stock/intgr_margin/intgr_margin.py Normal file
View File

@@ -0,0 +1,85 @@
"""
Created on 20250601
"""
import sys
import logging
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내주식] 주문/계좌 > 주식통합증거금 현황 [국내주식-191]
##############################################################################################
# 상수 정의
API_URL = "/uapi/domestic-stock/v1/trading/intgr-margin"
def intgr_margin(
cano: str, # [필수] 종합계좌번호 (ex. 12345678)
acnt_prdt_cd: str, # [필수] 계좌상품코드 (ex. 01)
cma_evlu_amt_icld_yn: str, # [필수] CMA평가금액포함여부 (ex. Y: 포함, N: 미포함)
wcrc_frcr_dvsn_cd: str, # [필수] 원화외화구분코드 (ex. 01: 외화기준, 02: 원화기준)
fwex_ctrt_frcr_dvsn_cd: str # [필수] 선도환계약외화구분코드 (ex. 01: 외화기준, 02: 원화기준)
) -> pd.DataFrame:
"""
주식통합증거금 현황 API입니다.
한국투자 HTS(eFriend Plus) > [0867] 통합증거금조회 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
※ 해당 화면은 일반계좌와 통합증거금 신청계좌에 대해서 국내 및 해외 주문가능금액을 간단하게 조회하는 화면입니다.
※ 해외 국가별 상세한 증거금현황을 원하시면 [해외주식] 주문/계좌 > 해외증거금 통화별조회 API를 이용하여 주시기 바랍니다.
Args:
cano (str): [필수] 종합계좌번호 (ex. 12345678)
acnt_prdt_cd (str): [필수] 계좌상품코드 (ex. 01)
cma_evlu_amt_icld_yn (str): [필수] CMA평가금액포함여부 (ex. Y: 포함, N: 미포함)
wcrc_frcr_dvsn_cd (str): [필수] 원화외화구분코드 (ex. 01: 외화기준, 02: 원화기준)
fwex_ctrt_frcr_dvsn_cd (str): [필수] 선도환계약외화구분코드 (ex. 01: 외화기준, 02: 원화기준)
Returns:
pd.DataFrame: 주식통합증거금 현황 데이터
Example:
>>> df = intgr_margin(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, cma_evlu_amt_icld_yn="N", wcrc_frcr_dvsn_cd="01", fwex_ctrt_frcr_dvsn_cd="01")
>>> print(df)
"""
if cano == "":
raise ValueError("cano is required (e.g. '12345678')")
if acnt_prdt_cd == "":
raise ValueError("acnt_prdt_cd is required (e.g. '01')")
if cma_evlu_amt_icld_yn == "":
raise ValueError("cma_evlu_amt_icld_yn is required (e.g. 'Y' or 'N')")
if wcrc_frcr_dvsn_cd == "":
raise ValueError("wcrc_frcr_dvsn_cd is required (e.g. '01' or '02')")
if fwex_ctrt_frcr_dvsn_cd == "":
raise ValueError("fwex_ctrt_frcr_dvsn_cd is required (e.g. '01' or '02')")
tr_id = "TTTC0869R"
params = {
"CANO": cano,
"ACNT_PRDT_CD": acnt_prdt_cd,
"CMA_EVLU_AMT_ICLD_YN": cma_evlu_amt_icld_yn,
"WCRC_FRCR_DVSN_CD": wcrc_frcr_dvsn_cd,
"FWEX_CTRT_FRCR_DVSN_CD": fwex_ctrt_frcr_dvsn_cd
}
res = ka._url_fetch(API_URL, tr_id, "", params)
if res.isOK():
current_data = pd.DataFrame([res.getBody().output])
return current_data
else:
res.printError(url=API_URL)
return pd.DataFrame()