Get Liquidation Records
Get liquidation records (Authentication type: KEYED, See Interface Permission)
Request Format
GET https://api-cloud.bitmart.com/contract/v1/ifcontract/userLiqRecords
Request Limit
Request Parameter
| Field | Type | Required? | Description |
|---|---|---|---|
| contractID | long | Yes | Contract ID |
| orderID | long | No | Order ID, all records are returned if orderID is not passed |
Instruction
Request example
curl https://api-cloud.bitmart.com/contract/v1/ifcontract/userLiqRecords?contractID=1&orderID=1000232
Response Data
| Field | Type | Description |
|---|---|---|
| order_id | long | Order ID |
| contract_id | long | Contract ID |
| position_id | long | Position ID |
| account_id | int | Account ID |
| type | int | Liquidation type, 1: Partial liquidation, 2: Liquidation, 3: ADL active, 4: ADL passive |
| trigger_price | string | Trigger price |
| order_price | string | Order price |
| mmr | string | Maintenance margin rate at liquidation |
| subsidies | string | Liquidation system subsidy amount |
| created_at | string | Create time |
Note
1.The parameter combinations of the request are as follows:
a. If no parameter is passed, it means to obtain all the user's liquidation records
b. Only the contractID is passed, which means that the user's record of liquidation for this contract is obtained
c. Only orderID is passed, which means that the user's record of liquidation for this order is obtained
Example of returned data format
{
"code": 1000,
"trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
"message": "OK",
"data": {
"records": [
{
"order_id": 10539098,
"contract_id": 1,
"position_id": 10539088,
"account_id": 10,
"type": 1,
"trigger_price": "16",
"order_price": "16",
"mmr": "0.0013",
"subsidies": "0.018",
"created_at": "2018-07-23T11:55:56.715305Z"
}
]
}
}