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

See Detailed Rate 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"
      }
    ]
  }
}

results matching ""

    No results matching ""