获取合约交易记录
获取历史合约成交记录 (鉴权类型:NONE, 参见接口权限)
请求格式
GET https://api-cloud.bitmart.com/contract/v1/ifcontract/trades
请求限制
参见 速率限制详细
请求参数
| 参数 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| contractID | long | 是 | 合约 ID |
解释说明
请求示例
curl https://api-cloud.bitmart.com/contract/v1/ifcontract/trades?contractID=1
响应详情
| 字段 | 类型 | 描述 |
|---|---|---|
| order_id | long | 订单 id |
| trade_id | long | 成交 id |
| contract_id | long | 合约 id |
| deal_price | string | 成交价 |
| deal_vol | string | 成交的合约张数 |
| make_fee | string | make fee |
| take_fee | string | take fee |
| created_at | string | 创建时间 |
| way | string | 交易方向 |
| 1:买为 taker,开多买开空卖 | ||
| 2:买为 taker,开多买平多卖 | ||
| 3:买为 taker,平空买开空卖 | ||
| 4: 买为 taker,平空买平多卖 | ||
| 5:卖为 taker,开空卖,开多买 | ||
| 6: 卖为 taker,开空卖,平空买 | ||
| 7:卖为 taker,平多卖,开多买 | ||
| 8: 卖为 taker,平多卖,平空买 | ||
| fluctuation | string | 对行情的影响 |
解释说明
way 1~4 都是买为 taker ,5~8 都是卖为 taker
fluctuation,对行情的影响,如本次交易前的最新交易价是 10,本次交易的交易价是 11,则 fluctuation 为"1"
返回数据格式示例
{
"code": 1000,
"trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
"message": "OK",
"data": {
"trades": [
{
"order_id": 10116361,
"trade_id": 10116363,
"contract_id": 1,
"deal_price": "16",
"deal_vol": "10",
"make_fee": "0.04",
"take_fee": "0.12",
"created_at": null,
"way": 5,
"fluctuation": "0"
}
]
}
}