Get Trades by Order
Order trade history
(Authentication type: KEYED, See Interface Permission)
Request Format
GET https://api-cloud.bitmart.com/contract/v1/ifcontract/orderTrades
Request Limit
Request Parameter
Field | Type | Required? | Description |
---|---|---|---|
contractID | long | Yes | Contract ID |
orderID | long | Yes | Order ID |
Instruction
Request example
curl https://api-cloud.bitmart.com/contract/v1/ifcontract/orderTrades?contractID=1&orderID=2064344648
Response Data
Field | Type | Description |
---|---|---|
order_id | long | Order ID |
trade_id | long | Trade ID |
contract_id | int | Contract ID |
deal_price | string | Deal price |
deal_vol | string | Deal volume |
make_fee | string | Maker fee |
take_fee | string | Taker fee |
created_at | string | Create time |
way | int | Order side 1: Open long (buy), 2: Close short (buy), 3: Close long (sell), 4: Open short (sell) |
fluctuation | string | Impact on the market |
Note
Fluctuation is the impact on the market. Example: the latest price before this trade is 10, the price of this trade is 11, then the fluctuation is "1".
Users must log in before they can query the transaction records of their orders.
Example of returned data format
{
"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": "2020-05-13T08:51:15.59541Z",
"way": 5,
"fluctuation": "0"
}
]
}
}