用户成交记录

获取用户成交历史 (鉴权类型:KEYED, 参见接口权限)

请求格式

GET https://api-cloud.bitmart.com/spot/v1/trades

请求限制

参见 速率限制详细

请求参数

字段 类型 是否必填 描述
symbol string 必填 交易对(如:BTC_USDT)

查询单个订单的成交记录的特殊参数

字段 类型 是否必填 描述
order_id long 选填 订单 id

解释说明

订单没有成交或者撤销返回的记录将是空列表。


查询所有订单的成交记录的特殊参数

字段 类型 是否必填 描述
offset int 选填 当前页 从 1 开始
limit int 选填 每页返回数量(取值范围1-100)

解释说明

只能获取最近200条订单,请求超出200条会返回空响应. (offset * limit > 200)


请求示例

https://api-cloud.bitmart.com/spot/v1/trades?symbol=BTC_USDT&limit=10&offset=1

响应详情

字段 类型 描述
orders List 订单列表
detail_id long 成交 id
order_id long 订单 id
symbol string 交易对 symbol
create_time long 成交时间 (毫秒表示)
side string 订单方向
buy=买入
sell=卖出
price_avg string 成交均价
notional string 成交价格
size string 成交数量
fees string 手续费
fee_coin_name string 手续费计价币名称
exec_type string 该账单是maker还是taker产生的。M表示Maker,T表示Taker

返回数据格式示例

{
    "message":"OK",
    "code":1000,
    "trace":"a06a5c53-8e6f-42d6-8082-2ff4718d221c",
    "data":{
        "current_page":1,
        "trades":[
            {
                "detail_id":256348632,
                "order_id":2147484350,
                "symbol":"BTC_USDT",
                "create_time":1590462303000,
                "side":"buy",
                "fees":"0.00001350",
                "fee_coin_name":"BTC",
                "notional":"88.00000000",
                "price_avg":"8800.00",
                "size":"0.01000",
                "exec_type":"M"
            },
            ...
        ]
    }
}

results matching ""

    No results matching ""