기업정보검색

상장된 기업 정보 불러오기

DART에 공시된 회사리스트를 반환하는 클래스.

dart_fss.corp.get_corp_list()

DART 공시된 회사 리스트 반환

Returns:

CorpList

회사 리스트

class dart_fss.corp.CorpList(*args, **kwargs)

Attributes:

corps

모든 상장된 종목(회사)를 반환한다

sectors

Methods

find_by_corp_code(corp_code)	DART에서 사용하는 회사 코드를 이용한 찾기
find_by_corp_name(corp_name[, exactly, market])	회사 명칭을 이용한 검색
find_by_product(product[, market])	취급 상품으로 검색(코스피, 코스닥, 코넥스만 지원)
find_by_sector(sector[, market])	산업 섹터로 검색(코스피, 코스닥, 코넥스만 지원)
find_by_stock_code(stock_code[, ...])	주식 종목 코드를 이용한 찾기
load([profile])	회사 정보가 없을시 회사 정보 로딩

property corps

모든 상장된 종목(회사)를 반환한다

find_by_corp_code(corp_code)

DART에서 사용하는 회사 코드를 이용한 찾기

Parameters:

corp_code: str

공시대상회사의 고유번호(8자리)

Returns:

Corp

회사 정보를 담고 있는 클래스

find_by_corp_name(corp_name, exactly=False, market='YKNE')

회사 명칭을 이용한 검색

Parameters:

corp_name: str

공시대상회사의 고유번호(8자리)

exactly: bool, optional

corp_name과 정확히 일치 여부(default: False)

market: str or list of str, optional

‘Y’: 코스피, ‘K’: 코스닥, ‘N’: 코넥스, ‘E’: 기타

Returns

——-

list of Corp

회사 정보를 담고 있는 클래스 리스트

find_by_product(product, market='YKN')

취급 상품으로 검색(코스피, 코스닥, 코넥스만 지원)

Parameters:

product: str

상품

market: str or list of str, optional

‘Y’: 코스피, ‘K’: 코스닥, ‘N’: 코넥스, ‘E’: 기타

Returns

——-

list of Corp

회사 정보를 담고 있는 클래스 리스트

find_by_sector(sector, market='YKN')

산업 섹터로 검색(코스피, 코스닥, 코넥스만 지원)

Parameters:

sector: str

산업 섹터

market: str or list of str, optional

‘Y’: 코스피, ‘K’: 코스닥, ‘N’: 코넥스, ‘E’: 기타

Returns

——-

list of Corp

회사 정보를 담고 있는 클래스 리스트

find_by_stock_code(stock_code, include_delisting=False, include_trading_halt=True)

주식 종목 코드를 이용한 찾기

Parameters:

stock_code: str

주식 종목 코드(6자리)

include_delisting: bool, optional

상장폐지 주식 포함 여부, True 일때 상장폐지 주식 포함(default: False)

include_trading_halt: bool, optional

거래정지 주식 포함 여부, True 일때 거래정지 주식 포함(default: True)

Returns

——-

Corp

회사 정보를 담고 있는 클래스

load(profile=False)

회사 정보가 없을시 회사 정보 로딩

Parameters:

profile: bool, optional

상세정보 로딩 여부

Example

from dart_fss import get_corp_list

# 모든 상장된 기업 리스트 불러오기
crp_list = get_corp_list()

# 삼성전자를 이름으로 찾기 ( 리스트 반환 )
samsung = corp_list.find_by_name('삼성전자', exactly=True)[0]

# 증권 코드를 이용한 찾기
samsung = corp_list.find_by_stock_code('005930')

# 다트에서 사용하는 회사코드를 이용한 찾기
samsung = corp_list.find_by_corp_code('00126380')

# "삼성"을 포함한 모든 공시 대상 찾기
corps = corp_list.find_by_name('삼성')

# "삼성"을 포함한 모든 공시 대상중 코스피 및 코스닥 시장에 상장된 공시 대상 검색(Y: 코스피, K: 코스닥, N:코넥스, E:기타)
# corps = corp_list.find_by_name('삼성', market=['Y','K']) # 아래와 동일
corps = corp_list.find_by_name('삼성', market='YK')

# "휴대폰" 생산품과 연관된 공시 대상
corps = corp_list.find_by_product('휴대폰')

# "휴대폰" 생산품과 연관된 공시 대상 중 코스피 시장에 상장된 대상만 검색
corps = corp_list.find_by_product('휴대폰', market='Y')

# 섹터 리스트 확인
corp_list.sectors

# "텔레비전 방송업" 섹터 검색
corps = corp_list.find_by_sector('텔레비전 방송업')

기업정보(Crp)

class dart_fss.corp.Corp(corp_code: str, corp_name: str | None = None, modify_date: str | None = None, stock_code: str | None = None, profile: bool = False)

회사(종목) 정보를 담고 있는 클래스

종목 코드, 이름, 종목 분류 및 취급 물품에 관한 기본정보를 가지고 있으며 DART 에서 제공하는 기업개황 정보를 담고 있다.

Attributes:

corp_code: str

종목 코드

corp_name: str

종목 이름

stock_code: str

주식 종목 코드

modify_date: str

최종 업데이트 일자

Methods

extract_fs(bgn_de[, end_de, fs_tp, ...])	재무제표 검색
load()	종목 정보 로딩
search_filings([bgn_de, end_de, ...])	공시보고서 검색
to_dict()	종목에 관한 모든 정보를 Dictionary 형태로 반환
update(info)	Update information

get_executive_shareholder
get_major_shareholder

extract_fs(bgn_de: str, end_de: str | None = None, fs_tp: Tuple[str] = ('bs', 'is', 'cis', 'cf'), separate: bool = False, report_tp: str = 'annual', lang: str = 'ko', separator: bool = True, dataset: str = 'xbrl', cumulative: bool = False, progressbar: bool = True, skip_error: bool = True, last_report_only: bool = True) → FinancialStatement

재무제표 검색

Parameters:

bgn_de: str

검색 시작일자(YYYYMMDD)

end_de: str, optional

검색 종료일자(YYYYMMDD)

fs_tp: tuple of str, optional

‘bs’ 재무상태표, ‘is’ 손익계산서, ‘cis’ 포괄손익계산서, ‘cf’ 현금흐름표

separate: bool, optional

개별재무제표 여부

report_tp: str, optional

‘annual’ 1년, ‘half’ 반기, ‘quarter’ 분기

lang: str, optional

‘ko’ 한글, ‘en’ 영문

separator: bool, optional

1000단위 구분자 표시 여부

dataset: str, optional

‘xbrl’: xbrl 파일 우선 데이터 추출, ‘web’: web page 우선 데이터 추출(default: ‘xbrl’)

cumulative: bool, optional

반기 혹은 분기 보고서 추출시 해당분기 값을 제외한 누적값만 추출할지 여부 (default: False)

progressbar: bool, optional

ProgressBar 표시 여부 (default: True)

skip_error: bool, optional

Error 발생시 skip 여부 (default: True)

last_report_only: bool, optional

최종 보고서만을 이용하여 데이터를 추출할지 여부 (default: True)

Returns:

FinancialStatement

제무제표 검색 결과

property info: Dict[str, str]

dict of str: 종목 정보 반환

load()

종목 정보 로딩

search_filings(bgn_de: str | None = None, end_de: str | None = None, last_reprt_at: str = 'N', pblntf_ty: str | List[str] | None = None, pblntf_detail_ty: str | List[str] | None = None, corp_cls: str | None = None, sort: str = 'date', sort_mth: str = 'desc', page_no: int = 1, page_count: int = 10)

공시보고서 검색

Parameters:

bgn_de: str, optional

검색시작 접수일자(YYYYMMDD), 없으면 종료일(end_de)

end_de: str, optional

검색종료 접수일자(YYYYMMDD), 없으면 당일

last_reprt_at: str, optional

최종보고서만 검색여부(Y or N), default : N

pblntf_ty: str, optional

공시유형

pblntf_detail_ty: str, optional

공시상세유형

corp_cls: str, optional

법인구분 : Y(유가), K(코스닥), N(코넥스), E(기타), 없으면 전체조회

sort: str, optional

정렬방법: ‘접수일자’ date, ‘회사명’ crp, ‘보고서명’ rpt

sort_mth: str, optional

‘오름차순’ asc, ‘내림차순’ desc, default : desc

page_no: int, optional

페이지 번호(1~n) default : 1

page_count: int, optional

페이지당 건수(1~100) 기본값 : 10, default : 100

Returns:

SearchResults

검색결과

to_dict() → Dict[str, str]

종목에 관한 모든 정보를 Dictionary 형태로 반환

Returns:

dict of str

종목에 관한 모든 정보 반환

update(info) → Dict[str, str]

Update information

Example

# 2019년 3월 1일부터 2019년 5월 31일까지 삼성전자의 모든 공시 정보 조회
reports = samsung.search_filings(bgn_de='20190301', end_de='20190531')

# 2010년 1월 1일부터 현재까지 모든 사업보고서 검색
reports = samsung.search_filings(bgn_de='20100101', pblntf_detail_ty='a001')

# 2010년 1월 1일부터 현재까지 모든 사업보고서의 최종보고서만 검색
reports = samsung.search_filings(bgn_de='20100101', pblntf_detail_ty='a001', last_reprt_at='Y')

# 2010년 1월 1일부터 현재까지 사업보고서, 반기보고서, 분기보고서 검색
reports = samsung.search_filings(bgn_de='20100101', pblntf_detail_ty=['a001', 'a002', 'a003'])

# 2012년 1월 1일부터 현재까지 연간 연결재무제표 검색
fs = samsung.extract_fs(bgn_de='20120101')

# 2012년 1월 1일부터 현재까지 분기 연결재무제표 검색 (연간보고서, 반기보고서 포함)
fs_quarter = samsung.extract_fs(bgn_de='20120101', report_tp='quarter')

# 2012년 1월 1일부터 현재까지 개별재무제표 검색
fs_separate = samsung.extract_fs(bgn_de='20120101', separate=True)