바이비트 파이썬 API - 과거 데이터

정의

query kline 함수. 공식 documents에는 "Get kline"이라는 한줄의 설명만 존재한다. 사전에 kline이 무엇인지 검색 할 경우 사람 이름이라는 것 정도로만 나오며, 독일어로 "작다"라는 뜻이라고도 한다. 아무래도 적은 양(200 rows)의 데이터를 불러온다 해서 kline이라는 이름을 붙인 것이 아닌가.... 하는 추측만 해보았다.

query kline은 바이비트 API를 이용하여 데이터를 불러오는 것에 있어 가장 대표적인 함수이다. 따라서 가장 많이 애용하는 함수가 아닌가 싶다.

 

---

 

코드

from pybit import usdt_perpetual
import pandas as pd

session = usdt_perpetual.HTTP("https://api-testnet.bybit.com")

data = session.query_kline(
    symbol="BTCUSDT",
    interval="60",
    from_time=1581231260
)['result']

data = pd.DataFrame(data)

 

 

Request Parameter

parameter	Required	Type	Comment
symbol	true	string	코인명
interval	true	string	데이터 row 마다 시간 단위. 선택지는 1 3 5 15 30 60 120 240 360 720 "D" "M" "W"
from	true	integer	시작 시간. 초로 변환 과정이 필요하다.
limit	false	integer	데이터 크기 제한. 최대 200개 까지 가능하다.

 

Response Parameters

Parameter	Type	Comment
symbol	string	코인명
period	string	데이터 시간 단위
start_at	integer	데이터의 시작 시간
volume	number	거래량
open	integer	시가
high	integer	최고가
low	number	최저가
close	integer	종가
interval	integer	period와 동일
open_time	integer	start_at과 동일
turnover	number	매출액이란 뜻으로, 여기서는 총거래액이다. volume x close 할 경우 같은 수치가 나온다.

 

---

 

결과 예시

	id	symbol	period	interval	start_at	open_time	volume	open	high	low	close	turnover
0	94697447	BTCUSDT	60	60	1654923600	1654923600	306.554	29379.0	29608.5	29144.5	29302.0	9.012539e+06
1	94714844	BTCUSDT	60	60	1654927200	1654927200	154.459	29302.0	29481.5	29099.0	29301.0	4.519811e+06
2	94732652	BTCUSDT	60	60	1654930800	1654930800	117.894	29301.0	29344.5	29102.0	29316.0	3.450637e+06
3	94750002	BTCUSDT	60	60	1654934400	1654934400	572.095	29316.0	29339.0	28958.5	28997.0	1.667900e+07
4	94767605	BTCUSDT	60	60	1654938000	1654938000	869.624	28997.0	29304.0	28635.0	29082.5	2.517868e+07
...	...	...	...	...	...	...	...	...	...	...	...	...
195	98117168	BTCUSDT	60	60	1655625600	1655625600	975.048	18313.5	18824.5	18164.0	18655.0	1.808338e+07
196	98134893	BTCUSDT	60	60	1655629200	1655629200	3653.924	18655.0	19461.0	18483.0	19002.5	6.922116e+07
197	98152407	BTCUSDT	60	60	1655632800	1655632800	2096.858	19002.5	20166.0	18885.0	19900.5	4.123520e+07
198	98169718	BTCUSDT	60	60	1655636400	1655636400	1992.107	19900.5	19992.5	19478.5	19689.5	3.918987e+07
199	98187075	BTCUSDT	60	60	1655640000	1655640000	868.574	19689.5	19928.0	19230.5	19427.0	1.705938e+07
200 rows × 12 columns

 

추가로 참고할만한 글

https://tfrecord.tistory.com/entry/QueryKline-QueryIndexPriceKline-QueryPremiumIndexKline

Query_Kline, Query_Index_Price_Kline, Query_Premium_Index_Kline