Get Recent Filled List

Get a list of recent 1000 fills in the last 24 hours. If you need to get your recent traded order history with low latency, you may query this endpoint.

HTTP REQUEST

GET /api/v1/recentFills

Example

GET /api/v1/recentFills

{
  "code": "200000",
  "data": [
    {
      "symbol": "XBTUSDM", //Symbol of the contract
      "tradeId": "5ce24c1f0c19fc3c58edc47c", //Trade ID
      "orderId": "5ce24c16b210233c36ee321d", //Order ID
      "side": "sell", //Transaction side
      "liquidity": "taker", // Liquidity-taker or maker
      "forceTaker": true, //Whether to force processing as a taker
      "price": "8302", //Filled price
      "size": 10, //Filled amount
      "value": "0.001204529", //Order value
      "feeRate": "0.0005", //Floating rate
      "fixFee": "0.00000006", //Fixed fees
      "feeCurrency": "XBT", //Charging currency
      "stop": "", //A mark to the stop order type
      "fee": "0.0000012022", //Transaction fee
      "orderType": "limit", //Order type
      "tradeType": "trade", //Trade type (trade, liquid, cancel, ADL or settlement)
      "createdAt": 1558334496000, //Time the order created
      "settleCurrency": "XBT", //settlement currency
      "openFeePay": "0.002",
      "closeFeePay": "0.002",
      "tradeTime": 1558334496000000000, //trade time in nanosecond
	  "marginMode": "ISOLATED" // Added field for margin mode: ISOLATED (isolated), CROSS (cross margin).
    }
  ]
}

API KEY PERMISSIONS

This endpoint requires the General permission.

REQUEST URL

This endpoint support Futures URL

REQUEST RATE LIMIT

Futures weight：3

PARAMETERS

Param	Type	Mandatory	Description
symbol	String	No	Symbol of the contract

RESPONSES

Param	Description
symbol	Symbol of the contract
tradeId	Trade ID
orderId	Order ID
side	Transaction side
liquidity	Liquidity- taker or maker
forceTaker	Whether to force processing as a taker
price	Filled price
size	Filled amount
value	Order value
feeRate	Floating fees
fixFee	Fixed fees(Deprecated field, no actual use of the value field)
feeCurrency	Charging currency
stop	A mark to the stop order type
fee	Transaction fee
orderType	Order type
tradeType	Trade type (trade, liquid, cancel, ADL or settlement)
createdAt	Time the order created
settleCurrency	Transaction fee
tradeTime	trade time in nanosecond
openFeePay	Opening transaction fee
closeFeePay	Closing transaction fee
marginMode	Margin mode: ISOLATED (isolated), CROSS (cross margin).