Financial_IT

Description

본 프로젝트는 Kospi, Kosdaq 정보를 각 로직을 사용하여 생성된 결과를 API로 클라이언트에게 전송한다. Kospi, Kosdaq 데이터는 크롤링을 통해 MariaDB에 저장하였으며 JPA를 통해 데이터에 로직을 적용한다.

---

Environment

Framework: Spring Boot 2.6.4

Project: Gradle

Packaging: Jar

IDE: Intellij

ORM: JPA(Hibernate, Spring Data JPA)

DBMS: MariaDB

Dependencies: Spring Web, Spring Data JPA, Lombok

---

Installation

./gradlew build
cd build/libs
java -jar hello-spring-0.0.1-SNAPSHOT.jar

gradlew build
cd build/libs
java -jar hello-spring-0.0.1-SNAPSHOT.jar

---

Core Feature

1. 해당 종목의 테마 이름

• 해당종목의 테마이름 조회

URL	localhost:8080/stock/theme?codeName={종목명}
Content-Type	None
Request Method	GET

• Query String

파라미터명	타입	필수여부	설명
codeName	String	Y	조회하고자하는 종목명

• Response body

엘리먼트 명	타입	Depth	배열구분	설명	값 구분
status	String	1	N	응답 상태 코드
Result	String	1	N	응답 상태에 대한 결과값	Success : 성공(정상)Fail : 실패(오류)
description	String	1	N	응답 결과에 대한 설명
theme	String	1	N	요청된 종목코드 종목의 테마명

• 샘플 JSON예제

실패할 경우 샘플
{"status": "400", "result":"fail","description":"BAD REQUEST"}
{"status": "404", "result":"fail","description":"NOT FOUND"}

성공할 경우 샘플
{"status": "200", "result": "sucess", "description": "OK", "theme": "반도체_생산"}

2. 코스피/코스닥 상위 5종목 시총 합

URL	localhost:8080/stock/marketcap/sum?market={시장종류}
Content-Type	None
Request Method	GET

• Query String

파라미터명	타입	필수여부	설명
market	String	Y	조회하고자하는 시장종류

• Response body

엘리먼트 명	타입	Depth	배열 구분	설명	값 구분
status	String	1	N	응답 상태 코드
result	String	1	N	응답 상태에 대한 결과값	Success : 성공(정상)Fail : 실패(오류)
description	String	1	N	응답 결과에 대한 설명
sum	String	1	N	요청된 시장의 상위 5종목의 시가총액 합

• 샘플 JSON예제

실패할 경우 샘플
{"status": "400", "result":"fail","description":"BAD REQUEST"}
{"status": "404", "result":"fail","description":"NOT FOUND"}

성공할 경우 샘플
{"status": "200", "result": "sucess", "description": "OK", "sum":"3929161"}

3. 코스피/코스닥 상위 30개 종목 코드 및 종목명

URL	localhost:8080/stock/code/30?market={시장종류}
Content-Type	None
Request Method	GET

- Query String

파라미터명	타입	필수여부	설명
market	String	Y	조회하고자하는 시장종류

• Response body

엘리먼트 명	타입	Depth	배열 구분	설명	값 구분
status	String	1	N	응답 상태 코드
result	String	1	N	응답 상태에 대한 결과값	Success : 성공(정상)Fail : 실패(오류)
description	String	1	N	응답 결과에 대한 설명
data	Array	1	Y	요청된 시장의 상위 30종목의 종목코드와 종목명
code	String	2	N	종목코드
codeName	String	2	N	종목명

• 샘플 JSON예제

실패할 경우 샘플
{"status": "400", "result":"fail","description":"BAD REQUEST"}
{"status": "404", "result":"fail","description":"NOT FOUND"}

성공할 경우 샘플
{"status":"200","result":"success","description":"OK","data":[{"code":"245620","code_name":"EDGC"},{"code":"083450","code_name":"GST"},{"code":"028150","code_name":"GS홈쇼핑"}, ... ,{"code":"023910","code_name":"대한약품"},{"code":"006620","code_name":"동구바이오제약"}]}

4. 종목코드로 기업 종합 정보 조회

URL	localhost:8080/stock/code/detail?code={종목코드}
Content-Type	None
Request Method	GET

• Query String

파라미터명	타입	필수여부	설명
code	String	Y	조회하고자하는 종목코드

• Response body

엘리먼트명	타입	Depth	배열구분	설명	값 구분
status	String	1	N	응답 상태 코드
result	String	1	N	응답 상태에 대한 결과값	Success : 성공(정상)Fail : 실패(오류)
description	String	1	N	응답 결과에 대한 설명
data	Object	1	N	응답 결과 데이터
code	String	2	N	종목코드
codeName	String	2	N	종목명
thema_name	String	2	N	테마 이름
sub_price	String	2	N	대용가
roe	String	2	N	ROE
per	String	2	N	per

• 샘플 JSON예제

실패할 경우 샘플
{"status": "400", "result":"fail","description":"BAD REQUEST"}
{"status": "404", "result":"fail","description":"NOT FOUND"}

성공할 경우 샘플
{"status":"200","result":"success","description":"OK","data":{"code":"091990","code_name":"셀트리온헬스케어","thema_name":null,"sub_price":134320.0,"roe":3.9,"per":378.41}}