获取历史成交数据

限速规则 10次/1s (IP)

描述

以交易对维度获取历史成交数据。startTime和endTime时间间隔不可超过7天。
仅支持获取30天内数据。30天以上数据可以通过我们官网下载。

HTTP请求

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

请求示例

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

请求参数

参数名	参数类型	是否必须	描述
symbol	String	是	交易对名称，如"BTCUSDT"
idLessThan	String	否	成交ID，返回小于指定'tradeId'的记录
startTime	String	否	成交数据的时间起始点，即获取该时间戳以后的历史成交数据。Unix毫秒时间戳格式，例如1690196141868
endTime	String	否	成交数据的时间终止点，即获取该时间戳以后的历史成交数据。Unix毫秒时间戳格式，例如1690196141868
limit	String	否	查询条数 默认500，最大1000

返回示例

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

返回参数

返回字段	参数类型	字段说明
symbol	String	交易对名称
tradeId	String	成交单ID 降序排列
side	String	交易方向 buy 买入 sell 卖出
price	String	成交价格 数值保留两位小数
size	String	成交数量
ts	String	成交时间，Unix毫秒时间戳，例如1690196141868