bybit . API V5 . rest . Get Public Recent Trading History . 틱 데이터

 

 

 

bybit . API V5 . rest . Get Public Recent Trading History . 체결 틱 데이터

 

개요 

- 바이비트 거래소의 모든 종목의 최근 체결 틱 데이터 확보가능. 

- 실시간 웹소켓으로 확보되는 실시간 시세(채결 틱) 데이터의 현재시점 이전 과거 틱 데이터들 확보가능하다.  본인의 프로그램이 실시간 시세 데이터를 활용하는 경우, 프로그램 실행 시점 이전의 과거 틱데이터가 필요한 경우 본 request 로 과거 틱 데이터 확보한다. 

 

 

 

HTTP Request

GET /v5/market/recent-trade

 

 

요청인자

Parameter	Required	Type	Comments
category	true	string	Product type. spot,linear,inverse,option
symbol	false	string	Symbol name, like BTCUSDT, uppercase only required for spot/linear/inverse optional for option
baseCoin	false	string	Base coin, uppercase only Apply to option only If the field is not passed, return BTC data by default
optionType	false	string	Option type. Call or Put. Apply to option only
limit	false	integer	Limit for data size per page spot: [1,60], default: 60 others: [1,1000], default: 500

 

 

추가설명 

 

limit : 반환 받을 틱 데이터 수량.

현물 : limit 지정하지 않으면 기본 60개, 지정 가능 최대 수량 60개,

현물 외 모든 종목 : limit 지정하지 않으면 기본 500개, 지정 가능 최대 수량 1000개. 

 

참고. 

신경망 기반 학습 등  대규모 틱 데이터가 필요한 경우 본 요청으로 확보 가능한 틱 데이터 수량이 요청한 시점 기준 과거 1000개 만 수집가능하므로 많이 부족하다.  더 많은 틱 데이터 필요한 경우에는 웹소켓 기반 실시간 틱데이터 수신하면서 본인의 방식대로(예 : 파일로 저장, DB 에 저장등) 별도 저장해둔 틱데이터 이용해야 한다.  

 

 

 

요청 코드 예. - 파이썬 pybit 이용. 

from pybit.unified_trading import HTTP
session = HTTP(testnet=True)
print(session.get_public_trade_history(
    category="spot",
    symbol="BTCUSDT",
    limit=1,
))

 

 

응답 데이터

Parameter	Type	Comments
category	string	Products category
list	array	Object
> execId	string	Execution ID
> symbol	string	Symbol name
> price	string	Trade price
> size	string	Trade size
> side	string	Side of taker Buy, Sell
> time	string	Trade time (ms)
> isBlockTrade	boolean	Whether the trade is block trade
> mP	string	Mark price, unique field for option
> iP	string	Index price, unique field for option
> mIv	string	Mark iv, unique field for option
> iv	string	iv, unique field for option

 

응답 데이터 예 

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "category": "spot",
        "list": [
            {
                "execId": "2100000000007764263",
                "symbol": "BTCUSDT",
                "price": "16618.49",
                "size": "0.00012",
                "side": "Buy",
                "time": "1672052955758",
                "isBlockTrade": false
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672053054358
}

 

 

 

 

 

상위정리

 

bybit api v5 . 활용방법 정리

 

 

 

 

 

 

 

 

 

 

---

첫 등록 : 2024.08.21

최종 수정 : 

단축 주소 : https://igotit.tistory.com/5767

---