Merge pull request #101 from boostcampwm-2024/feature/api/stockTradeH…

…istory-#55

[BE] 6.04 매수/매도 요청 현황 API 구현

BE/src/stock/trade/history/dto/daily-stock-trade-history-data.dto.ts

@@ -0,0 +1,27 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+export class DailyStockTradeHistoryDataDto {
+  @ApiProperty({ description: '주식 영업 일자' })
+  stck_bsop_date: string;
+
+  @ApiProperty({ description: '주식 시가' })
+  stck_oprc: string;
+
+  @ApiProperty({ description: '주식 최고가' })
+  stck_hgpr: string;
+
+  @ApiProperty({ description: '주식 최저가' })
+  stck_lwpr: string;
+
+  @ApiProperty({ description: '주식 종가' })
+  stck_clpr: string;
+
+  @ApiProperty({ description: '누적 거래량' })
+  acml_vol: string;
+
+  @ApiProperty({ description: '전일 대비 부호' })
+  prdy_vrss_sign: string;
+
+  @ApiProperty({ description: '전일 대비율' })
+  prdy_ctrt: string;
+}

BE/src/stock/trade/history/dto/daily-stock-trade-history-ouput.dto.ts

@@ -0,0 +1,45 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+export class DailyStockTradeHistoryOutputDto {
+  @ApiProperty({ description: '주식 영업 일자' })
+  stck_bsop_date: string;
+
+  @ApiProperty({ description: '주식 시가' })
+  stck_oprc: string;
+
+  @ApiProperty({ description: '주식 최고가' })
+  stck_hgpr: string;
+
+  @ApiProperty({ description: '주식 최저가' })
+  stck_lwpr: string;
+
+  @ApiProperty({ description: '주식 종가' })
+  stck_clpr: string;
+
+  @ApiProperty({ description: '누적 거래량' })
+  acml_vol: string;
+
+  @ApiProperty({ description: '전일 대비 거래량 비율' })
+  prdy_vrss_vol_rate: string;
+
+  @ApiProperty({ description: '전일 대비' })
+  prdy_vrss: string;
+
+  @ApiProperty({ description: '전일 대비 부호' })
+  prdy_vrss_sign: string;
+
+  @ApiProperty({ description: '전일 대비율' })
+  prdy_ctrt: string;
+
+  @ApiProperty({ description: 'HTS 외국인 소진율' })
+  hts_frgn_ehrt: string;
+
+  @ApiProperty({ description: '외국인 순매수 수량' })
+  frgn_ntby_qty: string;
+
+  @ApiProperty({ description: '락 구분 코드' })
+  flng_cls_code: string;
+
+  @ApiProperty({ description: '누적 분할 비율' })
+  acml_prtt_rate: string;
+}

BE/src/stock/trade/history/dto/daily-stock-trade-history-response.dto.ts

@@ -0,0 +1,8 @@
+import { DailyStockTradeHistoryOutputDto } from './daily-stock-trade-history-ouput.dto';
+
+/**
+ * 주식현재가 일자별 API 응답값 정제 후 FE에 보낼 DTO
+ */
+export class DailyStockTradeHistoryResponseDto {
+  output: DailyStockTradeHistoryOutputDto[];
+}

BE/src/stock/trade/history/dto/stock-trade-history-data.dto.ts → BE/src/stock/trade/history/dto/today-stock-trade-history-data.dto.ts

@@ -1,6 +1,6 @@
 import { ApiProperty } from '@nestjs/swagger';
 
-export class StockTradeHistoryDataDto {
+export class TodayStockTradeHistoryDataDto {
   @ApiProperty({ description: '주식 체결 시간' })
   stck_cntg_hour: string;
 

BE/src/stock/trade/history/dto/stock-trade-history-output.dto.ts → BE/src/stock/trade/history/dto/today-stock-trade-history-output.dto.ts

@@ -1,6 +1,6 @@
 import { ApiProperty } from '@nestjs/swagger';
 
-export class StockTradeHistoryOutputDto {
+export class TodayStockTradeHistoryOutputDto {
   @ApiProperty({ description: '주식 체결 시간' })
   stck_cntg_hour: string;
 

BE/src/stock/trade/history/dto/today-stock-trade-history-response.dto.ts

@@ -0,0 +1,13 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { TodayStockTradeHistoryOutputDto } from './today-stock-trade-history-output.dto';
+
+/**
+ * 주식현재가 체결 API 응답값 정제 후 FE에 보낼 DTO
+ */
+export class TodayStockTradeHistoryResponseDto {
+  @ApiProperty({
+    type: TodayStockTradeHistoryOutputDto,
+    description: '상승률 순위',
+  })
+  output: TodayStockTradeHistoryOutputDto[];
+}

BE/src/stock/trade/history/interface/inquire-daily-price.interface.ts

@@ -0,0 +1,23 @@
+export interface InquireDailyPriceOutputData {
+  stck_bsop_date: string;
+  stck_oprc: string;
+  stck_hgpr: string;
+  stck_lwpr: string;
+  stck_clpr: string;
+  acml_vol: string;
+  prdy_vrss_vol_rate: string;
+  prdy_vrss: string;
+  prdy_vrss_sign: string;
+  prdy_ctrt: string;
+  hts_frgn_ehrt: string;
+  frgn_ntby_qty: string;
+  flng_cls_code: string;
+  acml_prtt_rate: string;
+}
+
+export interface InquireDailyPriceApiResponse {
+  output: InquireDailyPriceOutputData[];
+  rt_cd: string;
+  msg_cd: string;
+  msg1: string;
+}

BE/src/stock/trade/history/stock-trade-history.controller.ts

@@ -1,15 +1,16 @@
 import { Controller, Get, Param } from '@nestjs/common';
 import { ApiOperation, ApiParam, ApiResponse } from '@nestjs/swagger';
 import { StockTradeHistoryService } from './stock-trade-history.service';
-import { StockTradeHistoryResponseDto } from './dto/stock-trade-history-response.dto';
+import { TodayStockTradeHistoryResponseDto } from './dto/today-stock-trade-history-response.dto';
+import { DailyStockTradeHistoryDataDto } from './dto/daily-stock-trade-history-data.dto';
 
 @Controller('/api/stocks')
 export class StockTradeHistoryController {
   constructor(
     private readonly stockTradeHistoryService: StockTradeHistoryService,
   ) {}
 
-  @Get(':stockCode/trade-history')
+  @Get(':stockCode/today-trade-history')
   @ApiOperation({ summary: '단일 주식 종목에 대한 주식현재가 체결 API' })
   @ApiParam({
     name: 'stockCode',
@@ -21,9 +22,27 @@ export class StockTradeHistoryController {
   @ApiResponse({
     status: 200,
     description: '단일 주식 종목에 대한 주식현재가 체결값 조회 성공',
-    type: StockTradeHistoryResponseDto,
+    type: TodayStockTradeHistoryResponseDto,
   })
-  getStockDetail(@Param('stockCode') stockCode: string) {
-    return this.stockTradeHistoryService.getStockTradeHistory(stockCode);
+  getTodayStockTradeHistory(@Param('stockCode') stockCode: string) {
+    return this.stockTradeHistoryService.getTodayStockTradeHistory(stockCode);
+  }
+
+  @Get(':stockCode/daily-trade-history')
+  @ApiOperation({ summary: '단일 주식 종목에 대한 일자별 주식현재가 API' })
+  @ApiParam({
+    name: 'stockCode',
+    required: true,
+    description:
+      '종목 코드\n\n' +
+      '(ex) 005930 삼성전자 / 005380 현대차 / 001500 현대차증권',
+  })
+  @ApiResponse({
+    status: 200,
+    description: '단일 주식 종목에 대한 일자별 주식현재가 조회 성공',
+    type: DailyStockTradeHistoryDataDto,
+  })
+  getDailyStockTradeHistory(@Param('stockCode') stockCode: string) {
+    return this.stockTradeHistoryService.getDailyStockTradeHistory(stockCode);
   }
 }