Python Upbit : get_ohlcv (코인 가격 history 조회하기, 과거 코인 가격 내역 조회)
pyupbit에서 어떤 코인의 과거 가격 내역을 조회하려면 get_ohlcv method를 사용합니다.
Syntax
pyupbit.get_ohlcv(ticker='KRW-BTC',
interval='day',
count=10,
to='YYYYMMDD HH:MM:SS'
period=0.1)ticker = 가격 내역을 조회할 코인의 ticker
interval = 가격 조회 간격을 의미합니다. interval에 지정 가능한 값은 다음과 같습니다.
day = 일봉
minute1 = 1분봉
minute3 = 3분봉
minute5 = 5분봉
minute10 = 10분봉
minute15 = 15분봉
minute30 = 30분봉
minute60 = 60분봉
minute240 = 240분봉
week = 주봉
month = 월봉
count = 최근 몇일지의 데이터를 조회할지를 의미합니다. (default값은 200입니다.)
to = 출력할 max date time을 지정합니다.
period = 데이터 요청 주기 (초) (default 값은 0.1 입니다.)
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC')
print(type(price_history))
print(price_history.columns)
print(price_history)
-- Result
<class 'pandas.core.frame.DataFrame'>
Index(['open', 'high', 'low', 'close', 'volume', 'value'], dtype='object')
open high ... volume value
2021-08-08 09:00:00 50956000.0 51731000.0 ... 8950.681433 4.562136e+11
2021-08-09 09:00:00 50790000.0 53077000.0 ... 10539.781659 5.454869e+11
2021-08-10 09:00:00 52862000.0 53491000.0 ... 9910.238110 5.208785e+11
2021-08-11 09:00:00 52335000.0 53500000.0 ... 10943.968458 5.792028e+11
2021-08-12 09:00:00 52585000.0 53395000.0 ... 13202.592674 6.915387e+11get_ohlcv method로 KRT-BTC(원화마켓 비트코인 시세)를 조회해봤습니다.
그 결과를 좀 보기좋게 표시하자면 위와 같습니다. (결과가 너무 많아서 일부만 나타내었습니다.)
가격 history는 DataFrame 형식으로 return됩니다.
또한 DataFrame의 컬럼은 다음 5개가 있습니다.
- DataFrame index = 기준 날짜/시간
- open = 기준 시간과 시가(시작 가격)
- high = 고가
- low = 저가
- close = 종가
- volume = 거래량 (거래된 코인의 개수)
- value = 거래 금액 (거래된 코인의 개수에 대한 가격)
DataFrame의 index를 보면 시간이 오전 9시로 고정되어있습니다.
따라서 매일 오전 9시 기준 데이터가 쌓이는 것을 볼 수 있습니다.
2022-02-23 09:00:00이라면 2022-02-22 09:00:00 ~ 2022-02-23 09:00:00 기간에 대한 비트코인 가격 정보를 나타내는 것 같습니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='minute1')
interval을 minute1으로 설정했을 경우 1분봉을 조회해줍니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='month')
interval = month로 설정할 경우 월봉을 나타내줍니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='day',
count=3)
count 옵션은 가장 최근 몇개의 데이터를 return할지에 대한 옵션입니다.
count=3으로 설정했기 때문에 3개의 행만 return됩니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='month',
count=3)
월봉도 마찬가지입니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='minute1',
count=10,
to='20220221 15:00:00')
to='20220221 15:00:00으로 설정했습니다.
이 말은 2022-02-21 15:00:00의 1분 전 즉, 2022-02-21 14:59:00 까지의 데이터를 조회합니다.
결국 2022-02-21 15:00:00 보다 이전의 시간 데이터를 조회한다는 의미입니다.
여기서 interval='minute1'이므로 1분봉을 나타내며
count=10이기 때문에 2022-02-21 15:00:00 이전 데이터 10개를 가져온다는 의미입니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='minute1',
count=10,
to='20220221')
to='20220221'처럼 시간을 생략하여 입력하면 시간이 24시로 기본지정됩니다.
2022-02-21 24:00:00 (결국 2022-02-22 00:00:00과 같음.)의 1분 전인 2022-02-21 23:59:00 이전 데이터를 조회해줍니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='day',
count=10,
to='20220221 23:00:00')
to='20220221 15:00:00' 로 설정하고 interval='day'로 설정할 경우엔 위와 같은 결과가 나옵니다.
일봉은 9시 기준으로 나타나지며 2022-02-21 15:00:00 이전 9시 데이터는 가장 최신 데이터가 2022-02-21 09:00:00 입니다.
따라서 가장 아래쪽에 2022-02-21 09:00:00 데이터가 나옵니다.
위 내용을 이해하면 아래 예시처럼 to='20220221 23:00:00' 로 설정해도 결국 2022-02-21 09:00:00 데이터가 가장 최신 데이터로 추출되는 것이 이해될겁니다.
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='day',
count=10,
to='20220221 23:00:00')
import pyupbit as ub
price_history = ub.get_ohlcv(ticker='KRW-BTC',
interval='minute1',
count=10,
to='20220225')
to를 2022-02-25로 지정했습니다. (count는 10으로 지정)
그러면 2022-02-25 23:59:00 이전 시간대의 데이터 중 가장 최신의 데이터를 추출합니다.
근데 현재 시간은 2022-02-24 02:20:00입니다.
따라서 2022-02-25 23:59:00까지의 데이터가 존재하지 않으므로, 존재하는 데이터 중 가장 최신의 데이터부터 10개를 가져오게 됩니다.
참고자료
https://github.com/sharebook-kr/pyupbit
분봉 = https://docs.upbit.com/reference/%EB%B6%84minute-%EC%BA%94%EB%93%A4-1
일봉 = https://docs.upbit.com/reference/%EC%9D%BCday-%EC%BA%94%EB%93%A4-1
주봉 = https://docs.upbit.com/reference/%EC%A3%BCweek-%EC%BA%94%EB%93%A4-1
월봉 = https://docs.upbit.com/reference/%EC%9B%94month-%EC%BA%94%EB%93%A4-1