Public Trading History

Get recent public trading records in Bybit. You could download archived USDT contract trade records here.

HTTP Request

GET /derivatives/v3/public/recent-trade

Request Parameters

Parameter	Required	Type	Comments
category	false	string	Product type.linear,inverse,option category not passed or =linear,inverse, then symbol is required category=option, then symbol is optional
symbol	false	string	Symbol name
baseCoin	false	string	Base coin. Default: BTC. Valid only when category=option
optionType	false	string	Option type. Call or Put. Valid only when category=option
limit	false	integer	Limit for data size per page. [1, 1000]. Default: 500

Response Parameters

Parameter	Type	Comments
category	string	Product type
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
> isBlockTrade	boolean	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

Request Example

linear

GET /derivatives/v3/public/recent-trade?category=linear&symbol=BTCUSDT&limit=1 HTTP/1.1
Host: api.bybit.com

Response Example

linear

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "category": "linear",
        "list": [
            {
            "execId": "5706445b-8543-59bc-8988-93e0f4a3f0f9",
            "symbol": "BTCUSDT",
            "price": "16814.50",
            "size": "0.001",
            "side": "Buy",
            "time": "1671970297430",
            "isBlockTrade": false
        }
    ]
},
    "retExtInfo": {},
    "time": 1671970297723
}