FnSpace 패키지는 에프앤가이드에서 개발한 금융데이터 분석용 파이썬 패키지로 API로 금융데이터를 불러오고 분석하는 기능을 제공합니다.
FnSpaceAPI의 API KEY 발급과 상세 I/O는 아래의 웹사이트를 참조하시기 바랍니다.
FnSpace 패키지는 pip install 명령으로 설치할 수 있습니다.
pip install fnspaceFnSpace 패키지를 사용하기 위해서는 https://www.fnspace.com에서 API KEY를 발급받으셔야 합니다.
from fnspace import FnSpace
api_key = "Your API key"
fs = FnSpace(api_key)출력 변수 리스트를 조회합니다.
item_df = fs.get_data(category="item_list", data_type="account") # 재무 데이터의 출력 변수 리스트출력 변수의 Item Code는 본 github의 ITEM_LIST.csv를 참조하셔도 됩니다.
종목코드와 출력 변수를 지정하여 재무 데이터를 조회합니다.
account_df = fs.get_data(
category = 'account',
code = ['005930', '005380'], # 종목코드 리스트. 예) 삼성전자, 현대자동차
item = ['M122700', 'M123955'], # 출력 변수 리스트. 예) 당기순이익, 보고서발표일 (default : 전체 item)
consolgb = 'M', # 회계기준. 주재무제표(M)/연결(C)/별도(I) (default : 주재무제표(M))
annualgb = 'A', # 연간(A)/분기(QQ)/분기누적(QY) (default : 연간(A))
accdategb = 'C', # 컨센서스 결산년월 선택 기준. Calendar(C)/Fiscal(F) (default : Calendar(C))
from_year = '2020', # 조회 시작 연도 (default : 직전 연도)
to_year = '2020', # 조회 종료 연도 (default : 직전 연도)
kor_item_name = True # 컬럼명 한글 출력 여부 (default : ITEM_CD 그대로)
)특정 시장의 주식 리스트 데이터를 조회합니다.
stock_list_df = fs.get_data(
category = 'stock_list',
mkttype ='4', # KOSPI(1)/KOSDAQ(2)/KONEX(3)/KOSPI KOSDAQ(4)/KOSPI200(5)/KOSDAQ150(6)
date ='20240624' # 조회 기준일 (default : 오늘 일자)
)주가 데이터를 조회합니다.
price_df = fs.get_data(
category = 'stock_price',
code = ['005930', '005380'], # 종목코드 리스트. 예) 삼성전자, 현대자동차
item = ['S100300'], # 출력 변수 리스트. 예) 시가, 고가 (default : 수정 OLHCV)
from_date = '20230101', # 조회 시작 일자 (default : to_date-365일)
to_date ='20240624' # 조회 종료 일자 (default : 오늘 일자)
)경제 데이터를 조회합니다.
price_df = fs.get_data(
category = 'macro',
item = ['aKONA10NIGDPW', 'aKONA10GSGSR'], # 출력 변수 리스트. 예) 국민총소득(명목,원화)(십억원), 총저축률(명목)(%)
from_date = '20230101', # 조회 시작 일자 (default : to_date-365일)
to_date ='20240624', # 조회 종료 일자 (default : 오늘 일자)
kor_item_name=True # 컬럼명 한글 출력 여부 (default : ITEM_CD 그대로)
)consensus_price_df = fs.get_data(
category = 'consensus-price',
item = ['E612500'], # 출력 변수 리스트
code = ['005930', '005380'],
from_date = '20230101', # 조회 시작 일자 (default : to_date-365일)
to_date ='20240624', # 조회 종료 일자
kor_item_name=True # 컬럼명 한글 출력 여부 (default : ITEM_CD 그대로)
)consensus_earning_df = fs.get_data(
category = 'consensus-earning-fiscal',
item = ['E122700'], # 출력 변수 리스트. 예) 당기순이익
code = ['005930', '005380'],
consolgb = "M", # 회계기준. 주재무제표(M)/연결(C)/별도(I) (default : 주재무제표(M))
annualgb = "A", # 연간(A)/분기(QQ)/분기누적(QY) (default : 연간(A))
from_year = "2023", # 조회 시작 연도 (default : 직전 연도)
to_year = "2024", # 조회 종료 연도 (default : 직전 연도)
kor_item_name=True # 컬럼명 한글 출력 여부 (default : ITEM_CD 그대로)
)consensus_earning_df = fs.get_data(
category = 'consensus-earning-daily',
item = ['E121500'], # 출력 변수 리스트. 예) 당기순이익
code = ['005930', '005380'],
consolgb = "M", # 회계기준. 주재무제표(M)/연결(C)/별도(I) (default : 주재무제표(M))
annualgb = "A", # 연간(A)/분기(QQ)/분기누적(QY) (default : 연간(A))
from_year = "2023", # 조회 시작 연도 (default : 직전 연도)
to_year = "2024", # 조회 종료 연도 (default : 직전 연도)
from_date = "20230101", # 조회 시작 일자 (default : to_date-365일)
to_date = "20240620", # 조회 종료 일자 (default : 오늘 일자)
kor_item_name=True # 컬럼명 한글 출력 여부 (default : ITEM_CD 그대로)
)consensus_forward_df = fs.get_data(
category = 'consensus-forward',
item = ['E121560'], # 출력 변수 리스트. 예) 영업이익(Fwd.12M)
code = ['005930', '005380'],
consolgb = "M", # 회계기준. 주재무제표(M)/연결(C)/별도(I) (default : 주재무제표(M))
from_date = "20230101", # 조회 시작 일자 (default : to_date-365일)
to_date = "20240620", # 조회 종료 일자 (default : 오늘 일자)
kor_item_name=True # 컬럼명 한글 출력 여부 (default : ITEM_CD 그대로)
)- fnspace 홈페이지의 기능 수록 및 example 폴더 추가