Get Market Trades

Rate limit: 10 req/sec/IP

Description

Get Market Trades
It supports to get the data within 30days. You can download the older data on our web

HTTP Request

• GET /api/v2/spot/market/fills-history

Request Example

curl "https://api.bitget.com/api/v2/spot/market/fills-history?symbol=BTCUSDT&limit=20&startTime=1678965010861&endTime=1678965910861"

Request Parameters

Parameter	Type	Required	Description
symbol	String	Yes	Trading pair name, e.g. BTCUSDT
limit	String	No	number of data returned. Default: 500, maximum: 1000
idLessThan	String	No	Order ID, returns records less than the specified 'tradeId'.
startTime	String	No	startTime, Unix millisecond timestamp e.g. 1690196141868 startTime and endTime should be within 7days.
endTime	String	No	endTime, Unix millisecond timestamp e.g. 1690196141868 startTime and endTime should be within 7days.

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695808949356,
    "data": [
        {
            "symbol": "BTCUSDT",
            "tradeId": "1",
            "side": "buy",
            "price": "2.38735",
            "size": "2470.6224",
            "ts": "1622097282536"
        },
        {
            "symbol": "BFTUSDT",
            "tradeId": "2",
            "side": "sell",
            "price": "2.38649",
            "size": "3239.7976",
            "ts": "1622097280642"
        }
    ]
}

Response Parameters

Parameter	Type	Description
symbol	String	Trading pair
tradeId	String	Order ID Descending
side	String	Direction Buy Sell
price	String	Order price
size	String	Filled quantity
ts	String	Transaction time, Unix millisecond timestamp, e.g. 1690196141868