Embed Size (px)
Citation preview
항목명 한글명 필수여부 비고
crpno 조회하고자 하는 법인 번호
bizno 조회하고자 하는 사업자번호
stockcd 조회하고자 하는 주식종목코드
NICE평가정보 Fintech API
개요 본 문서는, NICE 평가정보에서 제공하는 Fintech API 목록을 나열하고, 각 API에 대하여 간단한 개요를 설명한다.
구성 NICE평가정보에서 제공하는 Fintech API 는 아래같이 구성된다.
1. 기업개요 API 기업개요 정보를 조회 한다.
2. 기업재무분석정보 API 기업재무분석정보를 조회할 수 있습니다.
3. 기업재무정보 API 기업재무정보 상태표를 조회 한다.
기업개요 API
Kiscode
개요
kiscode를 조회한다.
URI
/v1/nice/companyOutlineIfo/kiscode
Request Parameters
Reponse Parameters
항목명 한글명 비고
kiscode 조회 대상 기업의 KISCODE
항목명 한글명 필수여부 비고
kiscode 조회 대상 기업의 KISCODE
bizno 조회하고자 하는 사업자번호
항목명한글명 비고
Examples
삼성전자의 사업자 번호로 KISCODE 조회
GET https://sandboxapigw.koscom.co.kr/v1/nice/companyOutlineIfo/kiscode?
bizno=1248100998
Output
{
"items": {
"count": "1",
"item": [
{
"kiscode": "380725"
}
]
}
}
CompanyOutline
개요
나이스평가에서 제공하는 기업개요 정보를 조회 한다.
URI
/v1/nice/companyOutlineIfo/companyOutline
Request Parameters
Reponse Parameters
amnisuyn 관리종목여부
예) N
bizno 사업자번호
예) 1248100998
bnk_brnm 주거래은행지점명
예) 삼성센터
bnknm 주거래은행명
예) 우리은행
chulja 출자제한그룹여부
출자제한그룹여부 (0 : 비대상, 1: 대상)
crpno 법인등록번호
1301110006246
crprgrnstscd 법인등기상태코드
법인등기상태코드 (00:살아있는등기, 10:상호폐지, 20:청산종결, 21:청산종결간주, 30:파산, 40:해산, 41:합병해산, 42:해산간주, 43:조직변경해산, 44:분할해산, 51:회생절차, 55:보전관리, 63:회사정리절차개시결정, 89:기타폐쇄, 98:본점전출, 99:미등록번호)
dtlcont 특기사항
예) 삼성디지털이미징(주)( 77925)를 흡수합병함 : (20100401) 삼성광주전자(주)(451940)를 흡수합병함 : (20110101) 삼성엘이디(주)( 82053)를 흡수합병함 : (20120403) 에쓰이에이치에프코리아(주)(372678)를 흡수합병함 : (20121201),삼성반도체통신(주)를 흡수합병함 : 881101
eml 이메일
empnum 종업원수
예) 98080
empnum_bse_date 종업원수기준일자
예) 20170630
eng_bnknm 영문 주거래은행명
예) Woori Bank
eng_btpnm 영문 업종명
eng_grpnm 영문 그룹명
예) Samsung
eng_idscdnm 영문 산업명
예) Manufacture of Mobile Phone
eng_itemnm 영문 종목명
예) SamsungElec
eng_mainpdtpcl 영문 주요상품내역
예) Comm.& Semiconductor/Computer,Display/Consumer Electronics,Rambus DRAM,FLASH & SMART MADIA
eng_scl 영문 기업규모
예) Large enterprise
engaddr 영문 도로명주소
예) 129, Samseong-ro Yeongtong-gu Suwon-si Gyeonggi
engaddr2 영문 도로명주소(공장)
예) 129, Samseong-ro Yeongtong-gu Suwon-si Gyeonggi
engaddr3 영문 도로명주소(영업소)
예) 11, Seocho-daero 74-gil Seocho-gu Seoul
engentrnm 영문 업체명
예) Samsung Electronics Co.,Ltd.
engreprnm 영문 대표자명
예) Gwon,O Hyeon/Yun,Bu Geun/Sin,Jong Gyun
epr_cnu_yn 기업존속여부
예) Y
etbDate 설립일자
예) 19690113
etl_ipc_yn 외부감사여부
예) Y
faBseDate 재무기준일자
예) 20161231
fadivcd 재무구분코드
예) 0
fax 팩스번호
예) 031-200-1105
fax2 팩스번호(공장)
예) 031-200-1105
fax3 팩스번호(영업소)
예) 02-2255-0117
gicd 그룹코드
예) 511
grpnm 삼성 그룹명
homepurl 홈페이지URL
예) www.samsung.com/sec
hupegbn 일반과세자 휴폐업구분
idscd 산업코드
예) C26422
idscdid 산업분류코드
예) 09C2642200
kiscode 업체코드
예) 380725
kor_itemnm 종목명
예) 삼성전자
koraddr 도로명주소
koraddr2 도로명주소(공장)
koraddr3 도로명주소(영업소)
korentrnm 업체명
korIdscdnm 산업코드명
예) 이동전화기 제조업
korreprcd 대표자인물코드
korreprnm 대표자명
logo 로고URL
ltg_date 상장일자
ltgmktdivcd 상장시장구분코드
상장시장구분코드 (1 : 코스피 2 : 코스닥 3 : 코넥스 9 : 대상아님 )
mainpdtpcl 주요상품내역
mainupche 주력업체
nolt_engaddr 영문지번주소
nolt_engaddr2 영문지번주소(공장)
nolt_engaddr3 영문지번주소(영업소)
nolt_koraddr 지번주소
nolt_koraddr2 지번주소(공장)
nolt_koraddr3 지번주소(영업소)
nts_sbqcdivcd 휴폐업구분코드
휴폐업구분코드 (00 : 미등록, 01 : 부가가치세 간이과세자, 02 : 부가가치세 면세과세자, 03 : 부가가치제 일반과세자, 04 : 비영리법인 또는 단체국가기관, 05 : 폐업자, 06 : 휴업자, 07 : 고유번호식별단체, 98 : ERROR, 99 : 기타 )
obz_date 개업일자
opt_entrnm 삼성전자 정제업체명
sbn_date 창업일자
sbqc_date 휴폐업일자
scl 기업규모
sforeign 특수기업정보 - 외투기업
sido 시도
stacmm 결산월
stkcd 주식코드
tel 전화번호
tel2 전화번호(공장)
tel3 전화번호(영업소)
upt_dtm 갱신일시
x x좌표(TM 좌표계)
x2 공장 x좌표(TM 좌표계)
x3 영업소 x좌표(TM 좌표계)
y y좌표(TM 좌표계)
y2 공장 y좌표(TM 좌표계)
y3 영업소 y좌표(TM 좌표계)
zarcd 우편구역번호(본사)
예) 16677
zarcd2 우편구역번호(공장)
예) 16677
zarcd3 우편구역번호(영업소)
예) 6620
zcd 우편번호
zcd2 우편번호(공장)
zcd3 우편번호(영업소)
zipareaseq 우편구역일련번호(본사)
예) 001
zipareaseq2 우편구역일련번호(공장)
예) 001
zipareaseq3 우편구역일련번호(영업소)
예) 001
Examples
삼성전자(KISCODE : 380725)의 기업개요 조회
GET https://sandbox
apigw.koscom.co.kr/v1/nice/companyOutlineIfo/companyOutline?kiscode=380725
Output
{
"items":
{
"count": "1",
"item": [
{
"amnisuyn": "N",
"bizno": "1248100998",
"bnk_brnm": "삼성센터",
"bnknm": "우리은행",
"chulja": "0",
"crpno": "1301110006246",
"crprgrnstscd": "00",
"dtlcont": "삼성디지털이미징(주)( 77925)를 흡수합병함 : (20100401) 삼성광주전자(주)(451940)를 흡수합병함 : (20110101) 삼성엘이디(주)( 82053)를 흡수합병함 :
(20120403) 에쓰이에이치에프코리아(주)(372678)를 흡수합병함 : (20121201),
삼성반도체통신(주)를 흡수합병함 : 881101",
"eml": "",
"empnum": "98080",
"empnum_bse_date": "20170630",
"eng_bnknm": "Woori Bank",
"eng_grpnm": "Samsung",
"eng_idscdnm": "Manufacture of Mobile Phone",
"eng_itemnm": "SamsungElec",
"eng_mainpdtpcl": "Comm.& Semiconductor/Computer,
Display/Consumer Electronics,
Rambus DRAM,
FLASH & SMART MADIA",
"eng_scl": "Large enterprise",
"engaddr": "129,
Samseongro Yeongtonggu Suwonsi Gyeonggi",
"engaddr2": "129,
Samseongro Yeongtonggu Suwonsi Gyeonggi",
"engaddr3": "11,
Seochodaero 74gil Seochogu Seoul",
"engentrnm": "Samsung Electronics Co.,
Ltd.",
"engreprnm": "Gwon,
O Hyeon/Yun,
Bu Geun/Sin,
Jong Gyun",
"epr_cnu_yn": "Y",
"etbDate": "19690113",
"etl_ipc_yn": "Y",
"faBseDate": "20161231",
"fadivcd": "00",
"fax": "0312001105",
"fax2": "0312001105",
"fax3": "0222550117",
"gicd": "511",
"grpnm": "삼성",
"homepurl": "www.samsung.com/sec",
"hupegbn": "일반과세자",
"idscd": "C26422",
"idscdid": "09C2642200",
"kiscode": "380725",
"korIdscdnm": "이동전화기 제조업",
"kor_itemnm": "삼성전자",
"koraddr": "경기 수원시 영통구 삼성로 129",
"koraddr2": "경기 수원시 영통구 삼성로 129",
"koraddr3": "서울 서초구 서초대로74길 11",
"korentrnm": "삼성전자(주)",
"korreprcd": "056963/122523/144893",
"korreprnm": "권오현/윤부근/신종균",
"logo":
"http://image.kisline.com/logos/busi_b/s_8/thum/th_1248100998.jpg",
"ltg_date": "19750611",
"ltgmktdivcd": "1",
"mainpdtpcl": "휴대폰,
컴퓨터,
네트워크시스템,
핵심칩,
반도체부품,
디스플레이패널,
가전제품,
의료기기,
프린터 제조",
"mainupche": "삼성전자(주)",
"nolt_engaddr": "416,
Maetan3dong Yeongtonggu Suwonsi Gyeonggi",
"nolt_engaddr2": "416,
Maetan3dong Yeongtonggu Suwonsi Gyeonggi",
"nolt_engaddr3": "132010,
Seocho2dong Seochogu Seoul",
"nolt_koraddr": "경기 수원시 영통구 매탄3동 416번지",
"nolt_koraddr2": "경기 수원시 영통구 매탄3동 416번지",
"nolt_koraddr3": "서울 서초구 서초2동 132010번지 삼성전자빌딩",
"nts_sbqcdivcd": "03",
"obz_date": "19690113",
"opt_entrnm": "삼성전자",
"repr_regno": "",
"sbn_date": "",
"sbqc_date": "",
"scl": "대기업",
"sido": "경기",
"stacmm": "12",
"stkcd": "005930",
"tel": "0312001114",
"tel2": "0312001114",
"tel3": "0222550114",
"x": "204614.000000",
항목명 한글명필수여부 비고
kiscode 조회하고자 하는 업체의 KISCODE를 입력
필수
stacdivcd 결산구분 필수 결산구분(F : 1분기, B : 반기, T : 3분기, K : 결산)
fatpcd 재무제표유형 필수 재무제표유형(0:개별, 1:연결)
항목명 한글명 비고
"x2": "204614.000000",
"x3": "202303.000000",
"y": "417311.000000",
"y2": "417311.000000",
"y3": "443829.000000",
"zarcd": "16677",
"zarcd2": "16677",
"zarcd3": "06620",
"zcd": "443803",
"zcd2": "443803",
"zcd3": "137965",
"zipareacdseq2": "001",
"zipareacdseq3": "001"
}
]
}
}
기업재무분석정보 API
FinancialRateBaseDate
개요
기업분석기준일자를 조회한다.
URI
/v1/nice/companyFinancialAnal/financialRateBaseDate
Request Parameters
Reponse Parameters
stac_date 결산일자 예) 20161231
Examples
삼성전자의 기업재무분석정보 기준일자를 조회 (결산구분 : 1분기, 재무제표 유형 : 개별)
GET https://sandbox
apigw.koscom.co.kr/v1/nice/companyFinancialAnalIfo/financialRateBaseDate?
kiscode=380725&stacdivcd=F&fatpcd=0
Output
{
"items":
{
"count": "112",
"item": [
{
"stac_date": "20170630"
},
{
"stac_date": "20170331"
},
{
"stac_date": "20161231"
},
.
.
.
{
"stac_date": "19751231"
}
]
}
}
FinancialRate
개요
기업재무분석정보를 조회한다.
URI
/v1/nice/companyFinancialAnal/financialRate
Request Parameters
항목명 한글명필수여부 비고
kiscode 조회하고자 하는 업체의 KISCODE를 입력
필수
stacdivcd 결산구분 결산구분(F : 1분기, B : 반기, T : 3분기, K : 결산)
yr 조회범위 조회범위(3 : 3개년(기본), 5 : 5개년)
fatpcd 재무제표유형 재무제표유형(0:개별, 1:연결)
stac_date 결산일자
항목명 한글명 비고
biyul0 비율0
biyul1 비율1
biyul3 비율3
biyul4 비율4
biyul6 비율6
biyul7 비율7
bogosu 재무보고서코드
chk_cont 확인내용
cont 설명
engentrnm 영문 업체명
fa_ogx_yn 재무원본여부
fadivcd 재무구분코드
farptcd 재무보고서코드
Reponse Parameters
항목명 한글명 비고
farptitemcd 재무항목코드
han0 한국은행평균값0
han1 한국은행평균값1
han2 한국은행평균값2
han3 한국은행산업평균값3
han6 한국은행산업평균값6
hang 재무항목코드
korentrnm 업체
name_eng 영문 항목명
name_kor 항목명
nice0 NICE산업평균0
nice1 NICE산업평균1
nice2 NICE산업평균2
nice3 Nice재무비율값3
nice6 Nice재무비율값6
s_seq 일련번호
seq 순서
stac_date 결산일자
stac_yyyy 결산년도
stacdivcd 결산구분코드
upchecd KIS코드
Examples
삼성전자의 기업재무분석정보를 조회 (결산구분 : 1분기, 재무제표유형 : 개별, 조회범위 : 3년(기본) )
GET https://sandbox
apigw.koscom.co.kr/v1/nice/companyFinancialAnalIfo/financialRate?
kiscode=380725&stacdivcd=F&yr=0&fatpcd=0&stac_date=0
Output
{
"items":
{
"allsvcpdtcd": "KLP",
"count": "0",
"divcd": "1",
"eprdatasvcstscd": "03",
"fadivcd": "00",
"farptcd": "19",
"farptitemcd": "19",
"fatpcd": "0",
"hdrcnt": "0",
"idscdid": "09C2642200",
"kiscode": "380725",
"mrl_bse_cd": "",
"nyr": "0",
"sanupscd_full": "C26422",
"sanupscd1": "C",
"sanupscd2": "26422",
"squery": "",
"squery2": "",
"squery3": "",
"squery4": "",
"squery5": "",
"stac_date": "0",
"stacdivcd": "F",
"tp_cd": "I",
"ver": "0",
"yr": "0"
}
}
기업재무정보 API
FinancialStateTableBaseDate
개요
항목명 한글명필수여부 비고
kiscode 조회하고자 하는 업체의 KISCODE를 입력
bizno 조회하고자 하는 사업자번호
stacdivcd 결산구분 결산구분(F : 1분기, B : 반기, T : 3분기, K : 결산)
fatpcd 재무제표유형 재무제표유형(0:개별, 1:연결)
항목명 한글명 비고
stacdivcd 결산구분 결산구분(F : 1분기, B : 반기, T : 3분기, K : 결산)
stac_yymm 결산년월
stac_date 결산일자 ex) 20161231
재무기준일자를 조회한다.
URI
/v1/nice/companyFinancialIfo/financialStateTableBaseDate
Request Parameters
Reponse Parameters
Examples
삼성전자의 결산구분 1분기의 재무기준일자를 조회
GET https://sandbox
apigw.koscom.co.kr/v1/nice/companyFinancialIfo/financialStateTableBaseDate?
kiscode=380725&bizno=1248100998&stacdivcd=F
Output
항목명 한글명필수여부 비고
kiscode 조회하고자 하는 업체의 KISCODE를 입력
필수
{
"items":
{
"count": "18",
"item": [
{
"stac_date": "20170331",
"stac_yymm": "201703",
"stacdivcd": "F"
},
{
"stac_date": "20160331",
"stac_yymm": "201603",
"stacdivcd": "F"
},
{
"stac_date": "20150331",
"stac_yymm": "201503",
"stacdivcd": "F"
},
.
.
.
{
"stac_date": "20000331",
"stac_yymm": "200003",
"stacdivcd": "F"
}
]
}
}
FinancialStateTableBaseDate
개요
재무상태표를 조회한다.
URI
/v1/nice/companyFinancialIfo/financialStateTable
Request Parameters
항목명 한글명필수여부 비고
fatpcd 재무제표유형 재무제표유형(0:개별, 1:연결)
yr 조회범위 조회범위(3 : 3개년(기본), 5 : 5개년)
amtuit 금액단위 금액단위(1:원, 2:천원, 3:백만원, 4:억원, 기본 - 2)
stac_date 결산일자
stacdivcd 결산구분 결산구분(F : 1분기, B : 반기, T : 3분기, K : 결산)
항목명 한글명 비고
allsvcpdtcd 미사용
amtuit 금액단위 금액단위(1:원, 2:천원, 3:백만원, 4:억원, 기본 - 2)
audit_eng 영문 감사의견
audit_kor 감사의견
cmprt0 구성비0
cmprt1 구성비1
cmprt2 구성비2
com_farpt_yn 공통재무보고서여부
date 일자
eprdatasvcstscd 미사용
fa_ogx_yn 재무원본여부
farptcd 재무보고서코드
farptitemcd 재무항목코드
Reponse Parameters
항목명 한글명 비고
fatpcd 재무유형코드
fvl0 제무항목값0
fvl1 제무항목값1
fvl2 제무항목값2
indrt0 증감율0
indrt1 증감율1
indrt2 증감율2
kiscode 업체코드
monunit 금액단위
mrl_bse_cd 자료기준코드
mtd_cd 방식코드 방식코드(F : 전체, M : 분석, S : 약식)
name_eng 영문 항목명
name_kor 항목명
nyr 수익율
slct_tp 조회유형
squery 적용쿼리
squery2 적용쿼리2
st_date 시작일자
stac_date 결산일자
stac_yyyy 결산년도
stacdivcd 결산구분코드
tlevel 재무계정레벨
항목명 한글명 비고
tp_cd 기업공개구분명
upchecd KIS코드
value 값
ver 미사용
yr 년도
Examples
삼성전자의 1분기 재무상태표를 조회
GET https://sandbox
apigw.koscom.co.kr/v1/nice/companyFinancialIfo/financialStateTable?
kiscode=380725&stacdivcd=F&yr=0&fatpcd=0
Output
{
"items":
{
"allsvcpdtcd": "KLP",
"amtuit": "2",
"com_farpt_yn": "N",
"count": "0",
"eprdatasvcstscd": "03",
"farptitemcd": "11",
"fatpcd": "0",
"hdrcnt": "0",
"kiscode": "380725",
"mrl_bse_cd": "",
"mtd_cd": "F",
"nyr": "0",
"slct_tp": "I",
"squery": "",
"squery2": "",
"stac_date": "20170331",
"stacdivcd": "F",
"tp_cd": "I",
"ver": "1",
"yr": "0"
}
}
