GoogleAIBuilder/KisStock
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-01-31 22:34:57 +09:00
commit f1301de543
875 changed files with 196598 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

250
한국투자증권(API)/examples_user/overseas_futureoption/overseas_futureoption_examples.py Normal file
View File

@@ -0,0 +1,250 @@
import sys
import logging
import pandas as pd
sys.path.extend(['..', '.'])
import kis_auth as ka
from overseas_futureoption_functions import *
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
# 인증
ka.auth()
trenv = ka.getTREnv()
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 체결추이(일간) [해외선물-018]
##############################################################################################
df1, df2 = daily_ccnl(srs_cd="6AM24", exch_cd="CME", start_date_time="", close_date_time="20240402", qry_tp="Q", qry_cnt="30", qry_gap="", index_key="")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 호가 [해외선물-031]
##############################################################################################
df1, df2 = inquire_asking_price(srs_cd="ESZ23")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 당일주문내역조회 [v1_해외선물-004]
##############################################################################################
df = inquire_ccld(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, ccld_nccs_dvsn="01", sll_buy_dvsn_cd="%%", fuop_dvsn="00", ctx_area_fk200="", ctx_area_nk200="")
print(df)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 일별체결내역[해외선물-011]
##############################################################################################
df1, df2 = inquire_daily_ccld(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, strt_dt="20250101", end_dt="20250131", fuop_dvsn_cd="00", fm_pdgr_cd="", crcy_cd="%%%", fm_item_ftng_yn="N", sll_buy_dvsn_cd="%%", ctx_area_fk200="", ctx_area_nk200="")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 일별 주문내역 [해외선물-013]
##############################################################################################
df = inquire_daily_order(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, strt_dt="20250601", end_dt="20250703", fm_pdgr_cd="", ccld_nccs_dvsn="01", sll_buy_dvsn_cd="%%", fuop_dvsn="00", ctx_area_fk200="", ctx_area_nk200="")
print(df)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 예수금현황 [해외선물-012]
##############################################################################################
df = inquire_deposit(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, crcy_cd="TUS", inqr_dt="20250630")
print(df)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 기간계좌손익 일별 [해외선물-010]
##############################################################################################
df1, df2 = inquire_period_ccld(inqr_term_from_dt="20250601", inqr_term_to_dt="20250630", cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, crcy_cd="%%%", whol_trsl_yn="N", fuop_dvsn="00", ctx_area_fk200="", ctx_area_nk200="")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 기간계좌거래내역 [해외선물-014]
##############################################################################################
df = inquire_period_trans(inqr_term_from_dt="20250101", inqr_term_to_dt="20250131", cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, acnt_tr_type_cd="1", crcy_cd="%%%", ctx_area_fk100="", ctx_area_nk100="", pwd_chk_yn="")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물종목현재가 [v1_해외선물-009]
##############################################################################################
df = inquire_price(srs_cd="BONU25")
print(df)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 주문가능조회 [v1_해외선물-006]
##############################################################################################
df = inquire_psamount(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, ovrs_futr_fx_pdno="6AU22", sll_buy_dvsn_cd="02", fm_ord_pric="", ecis_rsvn_ord_yn="")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 분봉조회[해외선물-016]
##############################################################################################
df1, df2 = inquire_time_futurechartprice(srs_cd="BONU25", exch_cd="EUREX", start_date_time="20250101", close_date_time="20250701", qry_tp="Q", qry_cnt="120", qry_gap="1", index_key="")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션 분봉조회 [해외선물-040]
##############################################################################################
result1, result2 = inquire_time_optchartprice(srs_cd="DXM24", exch_cd="ICE", qry_cnt="30")
print(result1)
print(result2)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 미결제내역조회(잔고) [v1_해외선물-005]
##############################################################################################
df = inquire_unpd(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, fuop_dvsn="00", ctx_area_fk100="", ctx_area_nk100="")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 미결제추이 [해외선물-029]
##############################################################################################
df1, df2 = investor_unpd_trend(prod_iscd="GE", bsop_date="20240513", upmu_gubun="0", cts_key="")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 증거금상세 [해외선물-032]
##############################################################################################
df = margin_detail(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, crcy_cd="USD", inqr_dt="20250701")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물옵션 장운영시간 [해외선물-030]
##############################################################################################
df = market_time(fm_pdgr_cd="", fm_clas_cd="", fm_excg_cd="CME", opt_yn="N", ctx_area_nk200="", ctx_area_fk200="")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 체결추이(월간)[해외선물-020]
##############################################################################################
df1, df2 = monthly_ccnl(srs_cd="6AM24", exch_cd="CME", start_date_time="", close_date_time="20240402", qry_tp="Q", qry_cnt="30", qry_gap="", index_key="")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션 호가 [해외선물-033]
##############################################################################################
df1, df2 = opt_asking_price(srs_cd="OESM24 C5340")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션 체결추이(일간) [해외선물-037]
##############################################################################################
result1, result2 = opt_daily_ccnl(srs_cd="DXM24", exch_cd="ICE", qry_cnt="30")
print(result1)
print(result2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션종목상세 [해외선물-034]
##############################################################################################
result = opt_detail(srs_cd="C5500")
print(result)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션 체결추이(월간) [해외선물-039]
##############################################################################################
result1, result2 = opt_monthly_ccnl(srs_cd="DXM24", exch_cd="ICE", qry_cnt="30")
print(result1)
print(result2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션종목현재가 [해외선물-035]
##############################################################################################
result = opt_price(srs_cd="DXM24")
print(result)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션 체결추이(틱) [해외선물-038]
##############################################################################################
result1, result2 = opt_tick_ccnl(srs_cd="DXM24", exch_cd="ICE", qry_cnt="30")
print(result1)
print(result2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션 체결추이(주간) [해외선물-036]
##############################################################################################
result1, result2 = opt_weekly_ccnl(srs_cd="DXM24", exch_cd="ICE", qry_cnt="30")
print(result1)
print(result2)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 주문[v1_해외선물-001]
##############################################################################################
df = order(cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, ovrs_futr_fx_pdno="1AALN25 C10.0", sll_buy_dvsn_cd="02", fm_lqd_ustl_ccld_dt="", fm_lqd_ustl_ccno="", pric_dvsn_cd="1", fm_limit_ord_pric="1.17", fm_stop_ord_pric="", fm_ord_qty="1", fm_lqd_lmt_ord_pric="", fm_lqd_stop_ord_pric="", ccld_cndt_cd="6", cplx_ord_dvsn_cd="0", ecis_rsvn_ord_yn="N", fm_hdge_ord_scrn_yn="N")
print(df)
##############################################################################################
# [해외선물옵션] 주문/계좌 > 해외선물옵션 정정취소주문[v1_해외선물-002, 003]
##############################################################################################
df = order_rvsecncl(cano=trenv.my_acct, ord_dv="0", acnt_prdt_cd=trenv.my_prod, orgn_ord_dt="20250630", orgn_odno="00123456", fm_limit_ord_pric="10.0", fm_stop_ord_pric="", fm_lqd_lmt_ord_pric="", fm_lqd_stop_ord_pric="", fm_hdge_ord_scrn_yn="N", fm_mkpr_cvsn_yn="")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 상품기본정보[해외선물-023]
##############################################################################################
df = search_contract_detail(qry_cnt="1", srs_cd_01="BONU25", srs_cd_02="BONU25", srs_cd_03="BONU25")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외옵션 상품기본정보 [해외선물-041]
##############################################################################################
result = search_opt_detail(qry_cnt="1", srs_cd_01="6AM24")
print(result)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물종목상세[v1_해외선물-008]
##############################################################################################
df = stock_detail(srs_cd="BONU25")
print(df)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 체결추이(틱)[해외선물-019]
##############################################################################################
df1, df2 = tick_ccnl(srs_cd="BONU25", exch_cd="EUREX", start_date_time="", close_date_time="20250630", qry_tp="Q", qry_cnt="30", qry_gap="", index_key="")
print(df1)
print(df2)
##############################################################################################
# [해외선물옵션] 기본시세 > 해외선물 체결추이(주간)[해외선물-017]
##############################################################################################
df1, df2 = weekly_ccnl(srs_cd="6AM24", exch_cd="CME", start_date_time="", close_date_time="20240402", qry_tp="Q", qry_cnt="30", qry_gap="", index_key="")
print(df1)
print(df2)

52
한국투자증권(API)/examples_user/overseas_futureoption/overseas_futureoption_examples_ws.py Normal file
View File

@@ -0,0 +1,52 @@
import sys
import logging
import pandas as pd
sys.path.extend(['..', '.'])
import kis_auth as ka
from overseas_futureoption_functions_ws import *
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
# 인증
ka.auth()
ka.auth_ws()
trenv = ka.getTREnv()
# 웹소켓 선언
kws = ka.KISWebSocket(api_url="/tryitout")
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간호가[실시간-018]
##############################################################################################
kws.subscribe(request=asking_price, data=["SPIU25"])
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간체결가[실시간-017]
##############################################################################################
kws.subscribe(request=ccnl, data=["1OZQ25"])
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간체결내역통보[실시간-020]
##############################################################################################
kws.subscribe(request=ccnl_notice, data=[trenv.my_htsid])
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간주문내역통보[실시간-019]
##############################################################################################
kws.subscribe(request=order_notice, data=[trenv.my_htsid])
# 시작
def on_result(ws, tr_id, result, data_info):
print(result)
kws.start(on_result=on_result)

4060
한국투자증권(API)/examples_user/overseas_futureoption/overseas_futureoption_functions.py Normal file
View File

File diff suppressed because it is too large Load Diff

324
한국투자증권(API)/examples_user/overseas_futureoption/overseas_futureoption_functions_ws.py Normal file
View File

@@ -0,0 +1,324 @@
import logging
import sys
sys.path.extend(['..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간호가[실시간-018]
##############################################################################################
def asking_price(
tr_type: str,
tr_key: str,
) -> tuple[dict, list[str]]:
"""
[해외선물옵션]실시간시세 > 해외선물옵션 실시간호가[실시간-018]
※ CME, SGX 실시간시세 유료시세 신청 필수 (KIS포털 > FAQ > 자주 묻는 질문 > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소))
- CME, SGX 거래소 실시간시세는 유료시세 신청 후 이용하시는 모든 계좌에 대해서 접근토큰발급 API 호출하셔야 하며,
접근토큰발급 이후 2시간 이내로 신청정보가 동기화되어 유료시세 수신이 가능해집니다.
- CME, SGX 거래소 종목은 유료시세 신청되어 있지 않으면 실시간시세 종목등록이 불가하며,
등록 시도 시 "SUBSCRIBE ERROR : mci send failed" 에러가 발생합니다.
(중요) 해외선물옵션시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
Args:
tr_type (str): [필수] 등록/해제
tr_key (str): [필수] 종목코드
Returns:
message (dict): 메시지 데이터
columns (list[str]): 컬럼 정보
Example:
>>> msg, columns = asking_price("1", "DNASAAPL")
>>> print(msg, columns)
"""
# 필수 파라미터 검증
if tr_type == "":
raise ValueError("tr_type is required")
if tr_key == "":
raise ValueError("tr_key is required")
tr_id = "HDFFF010"
params = {
"tr_key": tr_key,
}
msg = ka.data_fetch(tr_id, tr_type, params)
columns = [
"series_cd",
"recv_date",
"recv_time",
"prev_price",
"bid_qntt_1",
"bid_num_1",
"bid_price_1",
"ask_qntt_1",
"ask_num_1",
"ask_price_1",
"bid_qntt_2",
"bid_num_2",
"bid_price_2",
"ask_qntt_2",
"ask_num_2",
"ask_price_2",
"bid_qntt_3",
"bid_num_3",
"bid_price_3",
"ask_qntt_3",
"ask_num_3",
"ask_price_3",
"bid_qntt_4",
"bid_num_4",
"bid_price_4",
"ask_qntt_4",
"ask_num_4",
"ask_price_4",
"bid_qntt_5",
"bid_num_5",
"bid_price_5",
"ask_qntt_5",
"ask_num_5",
"ask_price_5",
"sttl_price"
]
return msg, columns
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간체결가[실시간-017]
##############################################################################################
def ccnl(
tr_type: str,
tr_key: str,
) -> tuple[dict, list[str]]:
"""
※ CME, SGX 실시간시세 유료시세 신청 필수 (포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소))
- CME, SGX 거래소 실시간시세는 유료시세 신청 후 이용하시는 모든 계좌에 대해서 접근토큰발급 API 호출하셔야 하며,
접근토큰발급 이후 2시간 이내로 신청정보가 동기화되어 유료시세 수신이 가능해집니다.
- CME, SGX 거래소 종목은 유료시세 신청되어 있지 않으면 실시간시세 종목등록이 불가하며,
등록 시도 시 "SUBSCRIBE ERROR : mci send failed" 에러가 발생합니다.
Args:
tr_type (str): [필수] 등록/해제
tr_key (str): [필수] 종목코드
Returns:
message (dict): 메시지 데이터
columns (list[str]): 컬럼 정보
Example:
>>> msg, columns = ccnl("1", "DNASAAPL")
>>> print(msg, columns)
"""
# 필수 파라미터 검증
if tr_type == "":
raise ValueError("tr_type is required")
if tr_key == "":
raise ValueError("tr_key is required")
tr_id = "HDFFF020"
params = {
"tr_key": tr_key,
}
msg = ka.data_fetch(tr_id, tr_type, params)
columns = [
"series_cd",
"bsns_date",
"mrkt_open_date",
"mrkt_open_time",
"mrkt_close_date",
"mrkt_close_time",
"prev_price",
"recv_date",
"recv_time",
"active_flag",
"last_price",
"last_qntt",
"prev_diff_price",
"prev_diff_rate",
"open_price",
"high_price",
"low_price",
"vol",
"prev_sign",
"quotsign",
"recv_time2",
"psttl_price",
"psttl_sign",
"psttl_diff_price",
"psttl_diff_rate"
]
return msg, columns
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간체결내역통보[실시간-020]
##############################################################################################
def ccnl_notice(
tr_type: str,
tr_key: str,
) -> tuple[dict, list[str]]:
"""
해외선물옵션 실시간체결내역통보 API입니다.
Args:
tr_type (str): [필수] 등록/해제
tr_key (str): [필수] 종목코드
Returns:
message (dict): 메시지 데이터
columns (list[str]): 컬럼 정보
Example:
>>> msg, columns = ccnl_notice("1", trenv.my_htsid)
>>> print(msg, columns)
"""
# 필수 파라미터 검증
if tr_type == "":
raise ValueError("tr_type is required")
if tr_key == "":
raise ValueError("tr_key is required")
tr_id = "HDFFF2C0"
params = {
"tr_key": tr_key,
}
msg = ka.data_fetch(tr_id, tr_type, params)
columns = [
"acct_no",
"ord_dt",
"odno",
"orgn_ord_dt",
"orgn_odno",
"series",
"rvse_cncl_dvsn_cd",
"sll_buy_dvsn_cd",
"cplx_ord_dvsn_cd",
"prce_tp",
"fm_excg_rcit_dvsn_cd",
"ord_qty",
"fm_lmt_pric",
"fm_stop_ord_pric",
"tot_ccld_qty",
"tot_ccld_uv",
"ord_remq",
"fm_ord_grp_dt",
"ord_grp_stno",
"ord_dtl_dtime",
"oprt_dtl_dtime",
"work_empl",
"ccld_dt",
"ccno",
"api_ccno",
"ccld_qty",
"fm_ccld_pric",
"crcy_cd",
"trst_fee",
"ord_mdia_online_yn",
"fm_ccld_amt",
"fuop_item_dvsn_cd"
]
return msg, columns
##############################################################################################
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간주문내역통보[실시간-019]
##############################################################################################
def order_notice(
tr_type: str,
tr_key: str,
) -> tuple[dict, list[str]]:
"""
[참고자료]
종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
Args:
tr_type (str): [필수] 등록/해제
tr_key (str): [필수] HTS ID
Returns:
message (dict): 메시지 데이터
columns (list[str]): 컬럼 정보
Example:
>>> msg, columns = order_notice("1", trenv.my_htsid)
>>> print(msg, columns)
"""
# 필수 파라미터 검증
if tr_type == "":
raise ValueError("tr_type is required")
if tr_key == "":
raise ValueError("tr_key is required")
tr_id = "HDFFF1C0"
params = {
"tr_key": tr_key,
}
msg = ka.data_fetch(tr_id, tr_type, params)
columns = [
"acct_no",
"ord_dt",
"odno",
"orgn_ord_dt",
"orgn_odno",
"series",
"rvse_cncl_dvsn_cd",
"sll_buy_dvsn_cd",
"cplx_ord_dvsn_cd",
"prce_tp",
"fm_excg_rcit_dvsn_cd",
"ord_qty",
"fm_lmt_pric",
"fm_stop_ord_pric",
"tot_ccld_qty",
"tot_ccld_uv",
"ord_remq",
"fm_ord_grp_dt",
"ord_grp_stno",
"ord_dtl_dtime",
"oprt_dtl_dtime",
"work_empl",
"crcy_cd",
"lqd_yn",
"lqd_lmt_pric",
"lqd_stop_pric",
"trd_cond",
"term_ord_vald_dtime",
"spec_tp",
"ecis_rsvn_ord_yn",
"fuop_item_dvsn_cd",
"auto_ord_dvsn_cd"
]
return msg, columns