국내주식 - 기본시세

한국투자증권에서 제공하는 API 중 국내주식 기본시세 카테고리에는 주식 시장 분석을 위한 핵심 데이터들이 풍부하게 포함되어 있습니다. 이 API들을 활용하면 종목 분석부터 시장 트렌드 파악까지 다양한 분석이 가능합니다.

주요 API 소개

1. 주식현재가 시세 API

종목의 기본적인 가격 정보와 주요 재무 지표를 제공합니다.

{
  "stck_prpr": "57600",           // 현재가
  "prdy_vrss": "-1200",           // 전일대비 변동
  "prdy_vrss_sign": "5",          // 전일대비 부호
  "prdy_ctrt": "-2.04",           // 전일대비 변동률
  "per": "10.25",                 // PER(주가수익비율)
  "pbr": "1.23",                  // PBR(주가순자산비율)
  "eps": "5621.00",               // EPS(주당순이익)
  "bps": "46792.00"               // BPS(주당순자산가치)
}

2. 국내주식기간별시세 API

일별/주별/월별 시세 데이터를 제공하여 중장기 추세 분석에 활용할 수 있습니다.

{
  "stck_bsop_date": "20240315",   // 거래일자
  "stck_oprc": "58200",           // 시가
  "stck_hgpr": "58900",           // 고가
  "stck_lwpr": "57400",           // 저가
  "stck_clpr": "57600",           // 종가
  "acml_vol": "15234567"          // 거래량
}

3. 주식당일분봉조회 API

당일 분봉 데이터를 제공하여 단기 가격 움직임을 분석할 수 있습니다.

{
  "stck_cntg_hour": "141500",     // 시간
  "stck_prpr": "57800",           // 현재가
  "stck_oprc": "57700",           // 시가
  "stck_hgpr": "57900",           // 고가
  "stck_lwpr": "57600",           // 저가
  "cntg_vol": "245689"            // 체결량
}

4. 주식현재가 투자자 API

개인, 외국인, 기관 등 투자 주체별 매매 동향을 파악할 수 있습니다.

{
  "prsn_ntby_qty": "-287624",     // 개인 순매수량
  "frgn_ntby_qty": "797458",      // 외국인 순매수량
  "orgn_ntby_qty": "-503653",     // 기관 순매수량
  "prsn_ntby_tr_pbmn": "-37176",  // 개인 순매수 거래대금
  "frgn_ntby_tr_pbmn": "102959",  // 외국인 순매수 거래대금
  "orgn_ntby_tr_pbmn": "-64984"   // 기관 순매수 거래대금
}

5. 주식현재가 호가/예상체결 API

매수/매도 호가 정보를 통해 시장 심리와 단기 수급 상황을 파악할 수 있습니다.

{
  "askp1": "57700",               // 매도호가1
  "bidp1": "57600",               // 매수호가1
  "askp_rsqn1": "45678",          // 매도호가 잔량1
  "bidp_rsqn1": "34567",          // 매수호가 잔량1
  "total_askp_rsqn": "325789",    // 총 매도호가 잔량
  "total_bidp_rsqn": "298456"     // 총 매수호가 잔량
}

6. 주식일별분봉조회 API

과거 특정 일자의 분봉 데이터를 제공하여 과거 패턴 분석에 활용할 수 있습니다.

{
  "stck_bsop_date": "20240310",   // 거래일자
  "stck_cntg_hour": "100000",     // 시간
  "stck_prpr": "59300",           // 현재가
  "stck_oprc": "59200",           // 시가
  "stck_hgpr": "59400",           // 고가
  "stck_lwpr": "59100",           // 저가
  "cntg_vol": "56789"             // 체결량
}

주식 시장 분석 활용 방안

1. 기본 정보 분석

주식현재가 시세 API를 통해 종목의 기본 정보와 재무 지표를 조회하고 분석할 수 있습니다. PER, PBR, EPS, BPS 등의 지표를 통해 종목의 가치를 평가하고, 52주 최고/최저가 대비 현재 가격의 위치를 파악하여 매수/매도 타이밍을 판단할 수 있습니다.

2. 투자자 동향 분석

주식현재가 투자자 API를 통해 개인, 외국인, 기관의 매매 동향을 파악할 수 있습니다. 이를 통해 주요 투자 주체의 순매수/순매도 패턴을 분석하고, 시장의 큰 흐름을 예측하는 데 활용할 수 있습니다. 특히 외국인과 기관의 움직임은 시장의 방향성을 결정하는 중요한 지표가 될 수 있습니다.

3. 기술적 지표 계산

분봉 데이터와 일별 시세 데이터를 활용하여 이동평균선, RSI(상대강도지수), MACD(이동평균수렴확산지수) 등 다양한 기술적 지표를 계산할 수 있습니다. 이러한 지표들은 종목의 추세와 모멘텀을 판단하는 데 도움이 됩니다.

# 이동평균선 계산 예시 코드
def calculate_moving_average(price_data, window):
    return sum(price_data[-window:]) / window

# 20일 이동평균선 계산
ma_20 = calculate_moving_average(daily_prices, 20)

4. 시장 심리 분석

호가 API를 이용하여 매수/매도 세력의 강도를 분석할 수 있습니다. 매수호가 잔량과 매도호가 잔량의 비율을 통해 단기적인 시장 심리와 방향성을 예측할 수 있습니다. 예를 들어, 매수호가 잔량이 매도호가 잔량보다 크게 많다면 단기적으로 상승 압력이 있다고 볼 수 있습니다.

# 호가 강도 계산 예시
bid_ask_ratio = total_bidp_rsqn / total_askp_rsqn
if bid_ask_ratio > 1.5:
    sentiment = "매수세 강함"
elif bid_ask_ratio < 0.7:
    sentiment = "매도세 강함"
else:
    sentiment = "중립적"

5. 종합 분석 리포트 제공

여러 API의 데이터를 종합하여 종목의 현황과 전망을 분석하는 리포트를 생성할 수 있습니다. 기본 정보, 투자자 동향, 기술적 지표, 시장 심리 등을 종합적으로 고려하여 투자 의사결정에 도움이 되는 인사이트를 제공할 수 있습니다.

종합 AI 분석 시스템 구축 방안

한국투자증권 API에서 제공하는 다양한 데이터를 활용하여 인공지능 기반의 종합 분석 시스템을 구축할 수 있습니다. 이러한 시스템은 다음과 같은 구성요소로 이루어질 수 있습니다:

1. 데이터 수집 모듈: 한국투자증권 API를 통해 실시간 및 과거 데이터를 수집
2. 전처리 모듈: 수집된 데이터를 정제하고 분석에 적합한 형태로 가공
3. 분석 모듈: 각종 지표 계산 및 패턴 분석을 수행
4. 예측 모듈: 머신러닝 모델을 활용한 가격 및 추세 예측
5. 시각화 모듈: 분석 결과를 직관적인 차트와 그래프로 표현
6. 알림 모듈: 중요한 시그널 발생 시 사용자에게 알림 제공

이러한 종합 분석 시스템은 개인 투자자부터 전문 트레이더까지 다양한 사용자에게 유용한 정보를 제공할 수 있습니다.

결론

한국투자증권 API는 주식 시장 분석을 위한 풍부한 데이터를 제공합니다. 이러한 데이터를 효과적으로 활용한다면 시장의 트렌드를 파악하고 투자 의사결정에 도움이 되는 유용한 인사이트를 얻을 수 있습니다. 특히 AI와 빅데이터 기술을 접목한다면 더욱 정교한 분석과 예측이 가능해질 것입니다.