Alpha Vantage API로 주식 정보 가져오기

Alpha Vantage API로 주식 정보 가져오기

Alpha Vantage API로 주식 정보 가져오기

Alpha Vantage API로 주식 정보 가져오는 방법 정리

Alpha Vantage는 무료 및 프리미엄 API를 통해 글로벌 주식, ETF, 펀드, 옵션, 암호화폐 등 다양한 금융 데이터를 제공합니다. 이 글에서는 Alpha Vantage 공식 문서를 기반으로, 주식(Stock) 정보를 가져오는 기본적인 방법을 정리합니다.

1. Alpha Vantage API Key 발급받기

• Alpha Vantage API를 사용하려면 먼저 무료 API Key를 발급받아야 합니다.

• API Key 신청 페이지에서 이메일을 입력하면 즉시 발급받을 수 있습니다1.

2. 주요 주식 데이터 API 종류

Alpha Vantage의 주식 데이터 API는 크게 다음과 같이 구분됩니다.

API 이름	설명	function 파라미터
Intraday(분봉)	1/5/15/30/60분 단위 OHLCV	TIME_SERIES_INTRADAY
Daily(일봉)	일별 OHLCV	TIME_SERIES_DAILY
Daily Adjusted(일봉+수정)	일별 OHLCV + 수정주가, 분할, 배당	TIME_SERIES_DAILY_ADJUSTED
Weekly(주봉)	주간 OHLCV	TIME_SERIES_WEEKLY
Weekly Adjusted(주봉+수정)	주간 OHLCV + 수정주가, 배당	TIME_SERIES_WEEKLY_ADJUSTED
Monthly(월봉)	월간 OHLCV	TIME_SERIES_MONTHLY
Monthly Adjusted(월봉+수정)	월간 OHLCV + 수정주가, 배당	TIME_SERIES_MONTHLY_ADJUSTED
실시간 시세(Quote)	현재가, 거래량 등	GLOBAL_QUOTE
종목 검색(Search)	키워드로 종목 코드 검색	SYMBOL_SEARCH

3. API 호출 기본 구조

Alpha Vantage API는 모두 아래와 같은 GET 요청 형식입니다.

https://www.alphavantage.co/query?function=FUNCTION&symbol=SYMBOL&apikey=APIKEY

• function: 사용할 API 종류(위 표 참고)

• symbol: 종목 코드(예: IBM, AAPL 등)

• apikey: 발급받은 본인 API Key

4. 실전 예시: Python으로 주식 데이터 가져오기

아래는 Python의 requests 라이브러리를 사용해 IBM의 5분봉 데이터를 가져오는 예시입니다.

import requests 
API_KEY = '여기에_본인_API_KEY_입력' 

symbol = 'IBM' interval = '5min' 
url = f'https://www.alphavantage.co/query?function=TIME_SERIES_INTRADAY&symbol={symbol}&interval={interval}&apikey={API_KEY}' 
response = requests.get(url) data = response.json() print(data)`

• 결과는 JSON 형태로 반환됩니다1.

5. 주요 파라미터 정리

공통 파라미터

• function: API 종류(필수)

• symbol: 종목 코드(필수)

• apikey: 본인 API Key(필수)

• datatype: 결과 포맷(json/csv, 기본값 json)

• outputsize: compact(최근 100개)/full(전체, 기본값 compact)

Intraday(분봉) 전용

• interval: 1min, 5min, 15min, 30min, 60min 중 선택(필수)

• adjusted: true/false (분할/배당 반영 여부, 기본값 true)

• extended_hours: true/false (장전/장후 데이터 포함 여부, 기본값 true)

• month: 특정 월 데이터 조회(YYYY-MM 형식)

6. 다양한 언어 지원

공식 문서에는 Python 외에도 Node.js, PHP, C#, .NET 등 다양한 언어 예제가 제공됩니다. 원하는 언어로 쉽게 적용할 수 있습니다.

7. 종목 코드(심볼) 검색

종목 코드를 모를 때는 SYMBOL_SEARCH API를 활용해 키워드로 검색할 수 있습니다.

url = f'https://www.alphavantage.co/query?function=SYMBOL_SEARCH&keywords=microsoft&apikey={API_KEY}' 
response = requests.get(url) data = response.json() print(data)`

• 결과로 관련 종목 코드와 시장 정보가 반환됩니다.

8. 기타 팁

• 무료 API는 분당 호출 제한이 있으니 주의하세요.

• 프리미엄 플랜을 사용하면 실시간(또는 15분 지연) 데이터, 더 많은 요청량, 옵션/ETF 등 추가 데이터에 접근할 수 있습니다.

• 결과 데이터는 JSON 또는 CSV로 받을 수 있어, Pandas 등 데이터 분석 도구와 연동이 쉽습니다.

마무리

Alpha Vantage API는 간단한 HTTP 요청만으로 글로벌 주식 데이터를 무료로 받아볼 수 있는 강력한 도구입니다. 공식 문서의 다양한 예제와 파라미터 설명을 참고하면, 원하는 주식 데이터를 손쉽게 수집할 수 있습니다.

카테고리 다른 글