국내주식 - 순위분석

한국투자증권은 투자 의사결정에 도움이 되는 다양한 정보를 제공하는 API를 제공하고 있습니다. 여러 API 중에서 특히 주식 순위 분석과 관련된 주요 API들을 자세히 살펴보겠습니다.

1. 국내주식 거래량 순위 API

• API 경로: /uapi/domestic-stock/v1/quotations/volume-rank
• 트랜잭션 ID: FHPST01710000
• Method: GET
• 최대 조회건수: 30건

주요 요청 파라미터

• FID_COND_MRKT_DIV_CODE: 시장 구분 코드 (J: 주식)
• FID_INPUT_ISCD: 종목코드 (0000: 전체)
• FID_DIV_CLS_CODE: 분류 구분 (0: 전체, 1: 보통주, 2: 우선주)
• FID_BLNG_CLS_CODE: 소속 구분 (0: 평균거래량, 1: 거래증가율 등)
• FID_TRGT_CLS_CODE: 대상 구분 코드 (증거금 관련 필터링)
• FID_TRGT_EXLS_CLS_CODE: 대상 제외 구분 코드

응답 데이터

{
  "hts_kor_isnm": "삼성전자",           // 종목명
  "mksc_shrn_iscd": "005930",         // 종목코드
  "data_rank": "1",                   // 순위
  "stck_prpr": "65100",               // 현재가
  "prdy_vrss_sign": "5",              // 전일대비 부호
  "prdy_vrss": "-300",                // 전일대비
  "prdy_ctrt": "-0.46",               // 전일대비율(%)
  "acml_vol": "8958147",              // 누적 거래량
  "prdy_vol": "12334657",             // 전일 거래량
  "lstn_stcn": "5969782550",          // 상장주식수
  "vol_inrt": "72.63",                // 거래량증가율(%)
  "vol_tnrt": "0.15",                 // 거래량 회전율(%)
  "acml_tr_pbmn": "584861890300"      // 누적 거래대금
}

활용 방안

1. 거래량 급증 종목 발굴: 거래량 증가율이 높은 종목을 찾아 모멘텀 전략 수립
2. 유동성 분석: 거래량 회전율을 통해 종목의 유동성 파악
3. 자금 흐름 분석: 거래대금 정보를 통해 시장 자금 흐름 분석

2. 국내주식 등락률 순위 API

• API 경로: /uapi/domestic-stock/v1/ranking/fluctuation
• 트랜잭션 ID: FHPST01700000
• Method: GET
• 최대 조회건수: 30건

주요 요청 파라미터

• fid_cond_mrkt_div_code: 시장 구분 코드 (J: 주식)
• fid_input_iscd: 종목코드 (0000: 전체, 0001: 코스피, 1001: 코스닥)
• fid_rank_sort_cls_code: 순위 정렬 구분 (0: 상승률순, 1: 하락률순 등)
• fid_input_cnt_1: 누적일수 (0: 전체)
• fid_prc_cls_code: 가격 구분 코드

응답 데이터

{
  "stck_shrn_iscd": "000040",         // 종목코드
  "data_rank": "1",                   // 순위
  "hts_kor_isnm": "KR모터스",          // 종목명
  "stck_prpr": "1821",                // 현재가
  "prdy_vrss": "197",                 // 전일대비
  "prdy_vrss_sign": "2",              // 전일대비 부호
  "prdy_ctrt": "12.13",               // 전일대비율(%)
  "acml_vol": "2267183",              // 누적 거래량
  "stck_hgpr": "1861",                // 최고가
  "hgpr_hour": "100214",              // 최고가 시간
  "stck_lwpr": "1301",                // 최저가
  "lwpr_hour": "090239",              // 최저가 시간
  "lwpr_vrss_prpr_rate": "39.97",     // 최저가 대비 현재가 비율(%)
  "cnnt_ascn_dynu": "1",              // 연속 상승 일수
  "cnnt_down_dynu": "0"               // 연속 하락 일수
}

활용 방안

1. 급등/급락 종목 분석: 상승률/하락률 상위 종목 파악
2. 모멘텀 전략 구축: 연속 상승/하락 일수 기반 모멘텀 투자 전략 수립
3. 바닥/천정 분석: 최저가/최고가 대비 현재가 비율을 통한 매매 타이밍 판단

3. 국내주식 시가총액 상위 API

• API 경로: /uapi/domestic-stock/v1/ranking/market-cap
• 트랜잭션 ID: FHPST01740000
• Method: GET
• 최대 조회건수: 30건

주요 요청 파라미터

• fid_cond_mrkt_div_code: 시장 구분 코드 (J: 주식)
• fid_div_cls_code: 분류 구분 (0: 전체, 1: 보통주, 2: 우선주)
• fid_input_iscd: 종목코드 (0000: 전체, 0001: 코스피, 1001: 코스닥)

응답 데이터

{
  "mksc_shrn_iscd": "005930",         // 종목코드
  "data_rank": "1",                   // 순위
  "hts_kor_isnm": "삼성전자",           // 종목명
  "stck_prpr": "72700",               // 현재가
  "prdy_vrss": "400",                 // 전일대비
  "prdy_vrss_sign": "2",              // 전일대비 부호
  "prdy_ctrt": "0.55",                // 전일대비율(%)
  "acml_vol": "3686661",              // 누적 거래량
  "lstn_stcn": "5969782550",          // 상장주식수
  "stck_avls": "4340032",             // 시가총액(백만원)
  "mrkt_whol_avls_rlim": "15.77"      // 시장 전체 시가총액 비중(%)
}

활용 방안

1. 대형주 분석: 시가총액 상위 종목 파악
2. 시장 비중 분석: 특정 종목의 시장 내 비중 파악
3. 지수 영향력 분석: 시가총액 비중을 통한 지수 영향력 분석

4. 국내주식 시장가치 순위 API

• API 경로: /uapi/domestic-stock/v1/ranking/market-value
• 트랜잭션 ID: FHPST01790000
• Method: GET
• 최대 조회건수: 30건

주요 요청 파라미터

• fid_cond_mrkt_div_code: 시장 구분 코드 (J: 주식)
• fid_input_iscd: 종목코드 (0000: 전체)
• fid_div_cls_code: 분류 구분 코드
• fid_input_option_1: 회계연도 (ex: 2023)
• fid_input_option_2: 분기 구분 (0: 1/4분기, 1: 반기, 2: 3/4분기, 3: 결산)
• fid_rank_sort_cls_code: 정렬 기준 (23: PER, 24: PBR, 25: PCR 등)

응답 데이터

{
  "data_rank": "1",                   // 순위
  "hts_kor_isnm": "효성",              // 종목명
  "mksc_shrn_iscd": "004800",         // 종목코드
  "stck_prpr": "57800",               // 현재가
  "prdy_vrss": "-400",                // 전일대비
  "prdy_vrss_sign": "5",              // 전일대비 부호
  "prdy_ctrt": "-0.69",               // 전일대비율(%)
  "acml_vol": "7453",                 // 누적 거래량
  "per": "19266.67",                  // PER
  "pbr": "0.49",                      // PBR
  "pcr": "11.19",                     // PCR
  "psr": "0.35",                      // PSR
  "eps": "300",                       // EPS
  "eva": "-812.00",                   // EVA
  "ebitda": "2031.00",                // EBITDA
  "stac_month": "12"                  // 결산월
}

활용 방안

1. 가치투자 분석: PER, PBR 등 가치지표 기반 저평가 종목 발굴
2. 업종별 비교분석: 동일 업종 내 가치지표 비교를 통한 상대가치 분석
3. 재무건전성 분석: EBITDA, EVA 등을 통한 기업 재무 건전성 평가

고급 투자 데이터 분석 API

1. 종목별 외인기관 추정가집계 API

• 제공 데이터:
  • 외국인 순매수량(추정)
  • 기관 순매수량(추정)
  • 외국인+기관 합산 순매수량(추정)
• 특징: 장중 외국인/기관 매매동향 실시간 추정
• 활용: 시장의 주요 세력 동향 파악을 통한 단기 전략 수립

2. 국내주식 매물대/거래비중 API

• 제공 데이터:
  • 가격대별 거래량 정보
  • 거래량 비중
• 특징: 특정 가격대 매물 집중도 파악 가능
• 활용: 지지/저항선 분석을 통한 매매 타이밍 결정

3. 종목별 일별 매수매도체결량 API

• 제공 데이터:
  • 매수체결량
  • 매도체결량
• 특징: 최대 100일 동안의 매수/매도 불균형 파악
• 활용: 매수/매도 세력 균형 분석을 통한 추세 예측

종합적인 활용 방안

1. 알고리즘 트레이딩 시스템 구축

   • 거래량, 등락률, 가치지표 등 다양한 데이터를 조합한 매매 알고리즘 개발
   • 외인/기관 동향과 매물대 정보를 결합한 타이밍 전략 수립

2. 포트폴리오 스크리닝 자동화

   • 시가총액, 거래량, 가치지표 등 다중 조건을 활용한 종목 필터링
   • 업종별, 테마별 유망 종목 선별 자동화

3. 시장 모니터링 대시보드 구축

   • 거래량 급증 종목, 등락률 상위 종목 등 실시간 모니터링
   • 외인/기관 매매 동향과 시장 지표를 결합한 시장 심리 지표 개발

4. 종목 분석 리포트 자동화

   • 시가총액, 거래량, 가치지표 등 종합적인 분석 리포트 자동 생성
   • 기술적/기본적 분석을 통합한 종목별 매력도 점수화 시스템 구축

한국투자증권 API를 효과적으로 활용하면 단순 시세 정보를 넘어 다양한 투자 인사이트를 얻을 수 있으며, 이를 기반으로 보다 정교한 투자 전략을 수립할 수 있습니다.