Documentation

class coredotfinance.data.KrxReader(api_key=None)

krx data를 읽어오는 인스턴스를 생성한다.

listed_company()

상장된 주식 정보를 읽어온다.

Returns

data

Return type

pd.DataFrame

read(symbol, *, start=None, end=None, kind='stock', api=False, **kwargs)

해당 주식 가격 데이터를 시작일(start) 부터 종료일(end) 까지 읽어온다.

Parameters

• symbol (str) --

  조회하고자 하는 데이터의 종목코드.

  형태는 종목과 종류마다 다르다.

  예) 삼성전자 : '005930', ARIRANG 200 : '152100'

• start (str) --

  조회하고자 하는 데이터의 시작일.

  형태는 YYYY-MM-DD가 되어야 한다.

  예) 2021-06-01

• end (str) --

  조회하고자 하는 데이터의 종료일.

  형태는 YYYY-MM-DD가 되어야 한다.

  예) 2021-06-01

• kind (str, default "stock") --

  조회하고자 하는 데이터의 종류.

  krx : ['stock', 'etf', 'index' ,'per', 'index', 'other_index']

• kwargs --

  divisionstr

  조회하고자 하는 데이터의 세부 구분

  other_index : ['선물지수', '옵션지수', '전략지수', '상품지수']

  reversebool, default false

  dataframe을 거꾸로 정렬하기

  korbool, default false

  columns를 한글로 받아오기

  adjustbool, default false

  수정주가 적용하기

Returns

data

Return type

pd.DataFrame

Examples

>>> from coredotfinance.data import KrxReader
>>> krx = KrxReader()
>>> dataframe = krx.read('000660', start='2021-07-01')

read_all(symbol, *, kind='stock', api=False, **kwargs)

전기간의 해당 주식 가격 데이터를 읽어온다.

Parameters

• symbol (str) --

  조회하고자 하는 데이터의 종목코드.

  형태는 종목과 종류마다 다르다.

  예) 삼성전자 : '005930', ARIRANG 200 : '152100'

• kind (str, default "stock") --

  조회하고자 하는 데이터의 종류.

  krx : ["stock", "etf", "etn", "elw", "per"]

• kwargs --

  kindstr

  조회하고자 하는 데이터의 종류

  krx : ['stock', 'etf', 'index' ,'per', 'index', 'other_index']

  divisionstr

  조회하고자 하는 데이터의 세부 구분

  other_index : ['선물지수', '옵션지수', '전략지수', '상품지수']

  reversebool, default false

  dataframe을 거꾸로 정렬하기

  korbool, default false

  columns를 한글로 받아오기

  adjustbool, default false

  수정주가 적용하기

Returns

data

Return type

pd.DataFrame

Examples

>>> from coredotfinance.data import KrxReader
>>> krx = KrxReader()
>>> dataframe = krx.read_all('000660')

read_date(date=None, *, kind='stock', api=False, **kwargs)

해당 일자의 전 종목 주식 데이터를 불러온다.

Parameters

• date (str) --

  조회하고자 하는 데이터의 조회일.

  형태는 YYYY-MM-DD가 되어야 한다.

  예) 2021-06-01

• kind (str, default "stock") --

  조회하고자 하는 데이터의 종류.

  krx : ['stock', 'etf', 'index' ,'per', 'index', 'other_index']

• kwargs --

  divisionstr

  조회하고자 하는 데이터의 세부 구분

  other_index : ['선물지수', '옵션지수', '전략지수', '상품지수']

  reversebool, default false

  dataframe을 거꾸로 정렬하기

  korbool, default false

  columns를 한글로 받아오기

  adjustbool, default false

  수정주가 적용하기

Returns

data

Return type

pd.DataFrame

Examples

>>> from coredotfinance.data import KrxReader
>>> krx = KrxReader()
>>> dataframe = krx.read_date('2021-07-20')

search(find, kind='stock', **kwargs)

필요 주식의 종목코드 또는 종목명을 검색한다.

Parameters

• find (str) -- 종목명 또는 종목코드

• kind (str) --

  조회하고자 하는 데이터의 종류

  krx : ['stock', 'etf', 'index' ,'per', 'index', 'other_index']

• kwargs --

  divisionstr

  조회하고자 하는 데이터의 세부 구분

Returns

종목명, 종목코드, 종목코드약식

Return type

tuple

Examples

>>> from coredotfinance.data import KrxReader
>>> krx = KrxReader()
>>> krx.search('삼성전자')

>>> ('삼성전자', 'KR7005930003', '005930')