Corporate Financial Data Collector
기업 재무정보 수집기
- 기업(법인)의 재무정보를 종합하여 주식투자에 활용할 수 있는 투자지표를 산출하여 저장하는 모듈을 개발해본다.
- 기업 재무정보를 제공하는 API들은 아래와 같다:
- 금융위원회_KRX상장종목정보
- 한국예탁결제원_기업정보서비스: 한국산업분류표준업종정보 조회
- 한국예탁결제원_기업정보서비스: 주식분포내역 주식분포현황 조회
- 한국예탁결제원_기업정보서비스: 기업기본정보 기업개요 조회
- 금융위원회_기업기본정보: 기업개요조회
- 금융위원회_주식발행정보: 종목기본정보조회
- 금융위원회_주식발행정보: 주식발행현황조회
- 금융위원회_기업 재무정보: 요약재무제표조회
기업 기본 재무정보
Schema (스키마)
| Seq | Attribute | Description | Source |
| crno | - 법인등록번호 | 금융위원회_기업기본정보: 기업개요조회 |
|
| corpNm | - 법인명 | ||
| corpEnsnNm | - 법인영문명 | ||
| corpRegMrktDcd | - 법인등록시장구분코드 | ||
| corpRegMrktDcdNm | - 법인등록시장구분코드명 | ||
| corpDcd | - 법인구분코드 | ||
| corpDcdNm | - 법인구분코드명 | ||
| bzno | - 사업자등록번호 | ||
| enpHmpgUrl | - 기업홈페이지URL | ||
| sicNm | - 표준산업분류명 | ||
| enpEstbDt | - 기업설립일자 | ||
| smenpYn | - 중소기업여부 (Y | N) |
||
| enpEmpeCnt | - 기업종업원수 | ||
| empeAvgCnwkTermCtt | - 종업원평균근속기간내용 | ||
| enpPn1AvgSlryAmt |
- 기업1인평균급여금액 | ||
| crno | - 법인등록번호 | 금융위원회_주식발행정보: 주식발행현황조회 |
|
| stckIssuCmpyNm | - 주식발행회사명 | ||
| onskTisuCnt | - 보통주총발행수 | ||
| pfstTisuCnt | - 우선주총발행수 | ||
| srtnCd | - 종목 코드보다 짧으면서 유일성이 보장되는 코드 |
금융위원회_KRX상장종목정보 |
|
| isinCd | - 현선물 통합상품의 종목 코드 (12자리) |
||
| mrktCtg | - 시장 구분 (KOSPI | KOSDAQ | KONEX) |
||
| itmsNm | - 종목의 명칭 | ||
| crno | - 종목의 법인등록번호 | ||
| corpNm | - 종목의 법인 명칭 | ||
| crno | - 법인등록번호 | 금융위원회_주식발행정보: 종목기본정보조회 |
|
| isinCd | - ISIN코드 | ||
| stckIssuCmpyNm | - 주식발행회사명 | ||
| isinCdNm | - ISIN코드명 | ||
| scrsItmsKcd | - 유가증권종목종류코드 | ||
| scrsItmsKcdNm | - 유가증권종목종류코드명 | ||
| stckParPrc | - 주식액면가 | ||
| issuStckCnt |
- 발행주식수 | ||
| lstgDt | - 상장일자 | ||
| crno | - 법인등록번호 | 금융위원회_기업 재무정보: 요약재무제표조회 |
|
| bizYear | - 사업연도 | ||
| fnclDcd | - 재무제표구분코드 | ||
| fnclDcdNm | - 재무제표구분코드명 | ||
| enpSaleAmt | - 기업매출금액 | ||
| enpBzopPft | - 기업영업이익 | ||
| iclsPalClcAmt | - 포괄손익계산금액 | ||
| enpCrtmNpf | - 기업당기순이익 | ||
| enpTastAmt | - 기업총자산금액 | ||
| enpTdbtAmt | - 기업총부채금액 | ||
| enpTcptAmt | - 기업총자본금액 | ||
| enpCptlAmt | - 기업자본금액 | ||
| fnclDebtRto | - 재무제표부채비율 |
Table Join Structure (테이블 조인 구조)
Code (Python)
APIs
- 한국 거래소에서 제공하는 KRX에 상장된 종목에 대한 정보상장된 종목의 종목명, 법인명, ISIN코드 등
종목 기본정보에 대한 오퍼레이션을 제공한다.
| API Type | REST | ||
| Service URL |
http://apis.data.go.kr/1160100/service/GetKrxListedInfoService/getItemInfo
|
||
| Data Format | JSON, XML | ||
| Request Parameter | Response Element | ||
| serviceKey (Mandatory) |
- 공공데이터 포털에서 받은 인증키 |
resultCode | - 결과코드 |
| pageNo | - 페이지 번호 | resultMsg | - 결과메시지 |
| numOfRows | - 한 페이지 결과 수 | numOfRows | - 한 페이지 결과 수 |
| resultType | - 구분 (xml | json) |
pageNo | - 페이지번호 |
| basDt | - 검색값과 기준일자가 일치하는 데이터를 검색 |
totalCount | - 전체 결과 수 |
| beginBasDt | - 기준일자가 검색값보다 크거나 같은 데이터를 검색 |
basDt | - 조회의 기준일, 통상 거래일 (YYYYMMDD) |
| endBasDt | - 기준일자가 검색값보다 작은 데이터를 검색 |
srtnCd | - 종목 코드보다 짧으면서 유일성이 보장되는 코드 |
| likeBasDt | - 기준일자값이 검색값을 포함하는 데이터를 검색 |
isinCd | - 현선물 통합상품의 종목 코드(12자리) |
| likeSrtnCd | - 단축코드가 검색값을 포함하는 데이터를 검색 |
mrktCtg | - 시장 구분 (KOSPI | KOSDAQ | KONEX) |
| isinCd | - 검색값과 ISIN코드가 일치하는 데이터를 검색 |
itmsNm | - 종목의 명칭 |
| likeIsinCd | - ISIN코드가 검색값을 포함하는 데이터를 검색 |
crno | - 종목의 법인등록번호 |
| itmsNm | - 검색값과 종목명이 일치하는 데이터를 검색 |
corpNm | - 종목의 법인 명칭 |
| likeItmsNm | - 종목명이 검색값을 포함하는 데이터를 검색 |
||
| crno | - 검색값과 법인등록번호가 일치하는 데이터를 검색 |
||
| corpNm | - 검색값과 법인명이 일치하는 데이터를 검색 |
||
| likeCorpNm | - 법인명이 검색값을 포함하는 데이터를 검색 |
||
한국예탁결제원_기업정보서비스: 한국산업분류표준업종정보 조회
- 한국산업분류표준업종과 관련된 정보를 조회한다.
| API Type | REST | ||
| Service URL | http://api.seibro.or.kr/openapi/service/CorpSvc/getKRIndstrClsfStndIndtpInfo | ||
| Data Format | XML | ||
| Request Parameter | Response Element | ||
| ServiceKey (Mandatory) |
- 공공데이터포털 인증키 | resultCode | - 결과코드 |
| indtpClsfNo (Mandatory) |
- 업종분류번호 | resultMsg | - 결과메시지 |
| pageNo | - 페이지번호 | indtpClsfNo | - 업종분류번호 |
| numOfRows | - 한 페이지 결과 수 | higherIndtpClsfNo | - 상위업종분류번호 |
| indtpNm | - 업종명 | ||
| numOfRows | - 한 페이지 결과 수 | ||
| pageNo | - 페이지 번호 | ||
| totalCount | - 전체 결과 수 | ||
한국예탁결제원_기업정보서비스: 주식분포내역 주식분포현황 조회
- 주식분포내역 주식분포현황을 조회한다.
| API Type | REST | ||
| Service URL | http://api.seibro.or.kr/openapi/service/CorpSvc/getStkDistributionStatus | ||
| Data Format | XML | ||
| Request Parameter | Response Element | ||
| ServiceKey (Mandatory) |
- 공공데이터포털 인증키 | shrs | - 주주수 |
| issucoCustno (Mandatory) |
- 발행회사번호 | shrsRatio | - 주주비율 |
| rgtStdDt (Mandatory) |
- 기준일 | stkDistbutTpnm | - 구분명 |
| stkqty | - 주식수 | ||
| stkqtyRatio | - 주식비율 | ||
한국예탁결제원_기업정보서비스: 기업기본정보 기업개요 조회
- 기업기본정보 기업개요를 조회한다.
| API Type | REST | ||
| Service URL | http://api.seibro.or.kr/openapi/service/CorpSvc/getIssucoBasicInfo | ||
| Data Format | XML | ||
| Request Parameter | Response Element | ||
| ServiceKey (Mandatory) |
- 공공데이터포털 인증키 | agOrgTpcd | - 대행기관구분코드 |
| issucoCustno (Mandatory) |
- 발행회사번호 | agOrgTpcdNm | - 대행기관명 |
| apliDtY | - 상장일 | ||
| apliDty | - 예탁지정일 | ||
| bizno | - 사업자번호 | ||
| caltotMartTpcd | - 시장구분코드 | ||
| caltotMartTpcdNm | - 시장명 | ||
| ceoNm | - CEO명 | ||
| custXtinDt | - 회사소멸일 | ||
| engCustNm | - 영문회사명 | ||
| engLegFormNm | - 법인형태구분영문명 | ||
| founDt | - 설립일 | ||
| homepAddr | - 홈페이지주소 | ||
| issucoCustno | - 발행회사번호 | ||
| pval | - 액면가 | ||
| pvalStkqty | - 수권자본금 | ||
| repSecnNm | - 발행회사명 | ||
| rostCloseTerm | - 명부폐쇄기간 | ||
| rostCloseTermTpcd | - 명부폐쇄기간구분코드 | ||
| rostCloseTermUnitCd | - 명부폐쇄기간단위구분코드 | ||
| rostCloseTermUnitNm | - 명부폐쇄기간단위구분명 | ||
| rostCloseTerms | - 명부폐쇄기간수 | ||
| setaccMmdd | - 결산월 | ||
| shotnIsin | - 단축코드 | ||
| totalStkCnt | - 총발행주식수 | ||
금융위원회_기업기본정보: 기업개요조회
- 기준일자, 법인등록번호, 법인명을 통하여 기업의 법인영문명, 기업대표자성명, 사업자등록번호 등의 기업개요를 조회한다.
| API Type | REST | ||
| Service URL | http://apis.data.go.kr/1160100/service/GetCorpBasicInfoService/getCorpOutline | ||
| Data Format | JSON, XML | ||
| Request Parameter | Response Element | ||
| ServiceKey (Mandatory) |
- 공공데이터포털 인증키 | resultCode | - 결과코드 |
| pageNo (Mandatory) |
- 페이지 번호 | resultMsg | - 결과메시지 |
| numOfRows (Mandatory) |
- 한 페이지 결과 수 | numOfRows | - 한 페이지 결과 수 |
| resultType (Mandatory) |
- 결과형식 | pageNo | - 페이지 번호 |
| basDt | - 기준일자 | totalCount | - 전체 결과 수 |
| crno | - 법인등록번호 | basDt | - 기준일자 |
| corpNm | - 법인명 | crno | - 법인등록번호 |
| corpNm | - 법인명 | ||
| corpEnsnNm | - 법인영문명 | ||
| enpPbanCmpyNm | - 기업공시회사명 | ||
| enpRprFnm | - 기업대표자성명 | ||
| corpRegMrktDcd | - 법인등록시장구분코드 | ||
| corpRegMrktDcdNm | - 법인등록시장구분코드명 | ||
| corpDcd | - 법인구분코드 | ||
| corpDcdNm | - 법인구분코드명 | ||
| bzno | - 사업자등록번호 | ||
| enpOzpno | - 기업구우편번호 | ||
| enpBsadr | - 기업기본주소 | ||
| enpDtadr | - 기업상세주소 | ||
| enpHmpgUrl | - 기업홈페이지URL | ||
| enpTlno | - 기업전화번호 | ||
| enpFxno | - 기업팩스번호 | ||
| sicNm | - 표준산업분류명 | ||
| enpEstbDt | - 기업설립일자 | ||
| enpStacMm | - 기업결산월 | ||
| enpXchgLstgDt | - 기업거래소상장일자 | ||
| enpXchgLstgAbolDt | - 기업거래소상장폐지일자 | ||
| enpKosdaqLstgDt | - 기업코스닥상장일자 | ||
| enpKosdaqLstgAbolDt | - 기업코스닥상장폐지일자 | ||
| enpKrxLstgDt | - 기업KONEX상장일자 | ||
| enpKrxLstgAbolDt | - 기업KONEX상장폐지일자 | ||
| smenpYn | - 중소기업여부 (Y | N) |
||
| enpMntrBnkNm | - 기업주거래은행명 | ||
| enpEmpeCnt | - 기업종업원수 | ||
| empeAvgCnwkTermCtt | - 종업원평균근속기간내용 | ||
| enpPn1AvgSlryAmt | - 기업1인평균급여금액 | ||
| actnAudpnNm | - 회계감사인명 | ||
| audtRptOpnnCtt | - 감사보고서의견내용 | ||
| enpMainBizNm | - 기업주요사업명 | ||
| fssCorpUnqNo | - 금융감독원법인고유번호 | ||
| fssCorpChgDtm | - 금융감독원법인변경일시 | ||
금융위원회_주식발행정보: 종목기본정보조회
- 기준일자, 법인등록번호, 주식발행회사명을 통하여
주식액면가, 발행주식수, 상장일자, 상장폐지일자등의 종목기본정보를 조회한다.
| API Type | REST | ||
| Service URL | http://apis.data.go.kr/1160100/service/GetStocIssuInfoService/getItemBasiInfo | ||
| Data Format | JSON, XML | ||
| Request Parameter | Response Element | ||
| ServiceKey (Mandatory) |
- 공공데이터포털 인증키 | resultCode | - 결과코드 |
| pageNo (Mandatory) |
- 페이지 번호 | resultMsg | - 결과메시지 |
| numOfRows (Mandatory) |
- 한 페이지 결과 수 | numOfRows | - 한 페이지 결과 수 |
| resultType (Mandatory) |
- 결과형식 (xml | json) |
pageNo | - 페이지 번호 |
| basDt | - 기준일자 | totalCount | - 전체 결과 수 |
| crno | - 법인등록번호 | basDt | - 기준일자 |
| stckIssuCmpyNm | - 주식발행회사명 | crno | - 법인등록번호 |
| isinCd | - ISIN코드 | ||
| stckIssuCmpyNm | - 주식발행회사명 | ||
| isinCdNm | - ISIN코드명 | ||
| scrsItmsKcd | - 유가증권종목종류코드 | ||
| scrsItmsKcdNm | - 유가증권종목종류코드명 | ||
| stckParPrc | - 주식액면가 | ||
| issuStckCnt | - 발행주식수 | ||
| lstgDt | - 상장일자 | ||
| lstgAbolDt | - 상장폐지일자 | ||
| dpsgRegDt | - 예탁등록일자 | ||
| dpsgCanDt | - 예탁취소일자 | ||
| issuFrmtClsfNm | - 발행형태구분명 | ||
금융위원회_주식발행정보: 주식발행현황조회
- 기준일자, 법인등록번호, 주식발행회사명을 통하여 보통주총발행수, 우선주총발행수 등의 주식발행현황을 조회한다.
| API Type | REST | ||
| Service URL | http://apis.data.go.kr/1160100/service/GetStocIssuInfoService/getStocIssuStat | ||
| Data Format | JSON, XML | ||
| Request Parameter | Response Element | ||
| ServiceKey (Mandatory) |
- 공공데이터포털 인증키 | resultCode | - 결과코드 |
| pageNo (Mandatory) |
- 페이지 번호 | resultMsg | - 결과메시지 |
| numOfRows (Mandatory) |
- 한 페이지 결과 수 | numOfRows | - 한 페이지 결과 수 |
| resultType (Mandatory) |
- 결과형식 (xml | json) |
pageNo | - 페이지 번호 |
| basDt | - 기준일자 | totalCount | - 전체 결과 수 |
| crno | - 법인등록번호 | basDt | - 기준일자 |
| stckIssuCmpyNm | - 주식발행회사명 | crno | - 법인등록번호 |
| stckIssuCmpyNm | - 주식발행회사명 | ||
| onskTisuCnt | - 보통주총발행수 | ||
| pfstTisuCnt | - 우선주총발행수 | ||
금융위원회_기업 재무정보: 요약재무제표조회
- 법인등록번호, 사업연도를 통하여
재무제표구분코드, 기업매출금액, 기업영업이익, 기업총자산금액등의 요약재무제표를 조회한다.
| API Type | REST | ||
| Service URL | http://apis.data.go.kr/1160100/service/GetFinaStatInfoService/getSummFinaStat | ||
| Data Format | JSON, XML | ||
| Request Parameter | Response Element | ||
| numOfRows (Mandatory) |
- 한 페이지 결과 수 | resultCode | - 결과코드 |
| pageNo (Mandatory) |
- 페이지 번호 | resultMsg | - 결과메시지 |
| resultType (Mandatory) |
- 결과형식 (xml | json) |
numOfRows | - 한 페이지 결과 수 |
| serviceKey (Mandatory) |
- 공공데이터포털 인증키 | pageNo | - 페이지 번호 |
| crno | - 법인등록번호 | totalCount | - 전체 결과 수 |
| bizYear | - 사업연도 | basDt | - 기준일자 |
| crno | - 법인등록번호 | ||
| bizYear | - 사업연도 | ||
| fnclDcd | - 재무제표구분코드 | ||
| fnclDcdNm | - 재무제표구분코드명 | ||
| enpSaleAmt | - 기업매출금액 | ||
| enpBzopPft | - 기업영업이익 | ||
| iclsPalClcAmt | - 포괄손익계산금액 | ||
| enpCrtmNpf | - 기업당기순이익 | ||
| enpTastAmt | - 기업총자산금액 | ||
| enpTdbtAmt | - 기업총부채금액 | ||
| enpTcptAmt | - 기업총자본금액 | ||
| enpCptlAmt | - 기업자본금액 | ||
| fnclDebtRto | - 재무제표부채비율 | ||
