Get Recent Trade History

Description

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

If you need to get your recently traded order history with low latency, you may query this endpoint.

Responses

🟢200OK

application/json

Body

code

string

required

data

array [object {24}]

required

symbol

string

required

Symbol of the contract. Please refer to Get Symbol endpoint: symbol

tradeId

string

required

Trade ID

orderId

string

required

Order ID

side

enum<string>

required

Transaction side

Allowed values:

buysell

liquidity

enum<string>

required

Liquidity-taker or -maker

Allowed values:

takermaker

forceTaker

boolean

required

Whether to force processing as a taker

price

string

required

Filled price

size

integer

required

Filled amount

value

string

required

Order value

openFeePay

string

required

Opening transaction fee

closeFeePay

string

required

Closing transaction fee

stop

string

required

A mark to the stop order type

feeRate

string

required

Fee Rate

fixFee

string

required

Fixed fees (Deprecated field, no actual use of the value field)

feeCurrency

string

required

Charging currency

marginMode

enum<string>

required

Margin mode: ISOLATED (isolated), CROSS (cross margin).

Allowed values:

ISOLATEDCROSS

fee

string

required

Transaction fee

settleCurrency

string

required

Settle Currency

orderType

enum<string>

required

Order type

Allowed values:

marketlimit

displayType

enum<string>

required

Order Type

Allowed values:

limitmarketlimit_stopmarket_stop

tradeType

enum<string>

required

Trade type (trade, liquid, cancel, adl or settlement)

Allowed values:

tradecancelliquidadlsettlement

subTradeType

string

required

Deprecated field, no actual use of the value field

tradeTime

integer <int64>

required

Trade time in nanoseconds

createdAt

integer <int64>

required

Order creation time

Example

{
  "code": "200000",
  "data": [
    {
      "symbol": "XBTUSDTM",
      "tradeId": "1784277229880",
      "orderId": "236317213710184449",
      "side": "buy",
      "liquidity": "taker",
      "forceTaker": false,
      "price": "67430.9",
      "size": 1,
      "value": "67.4309",
      "openFeePay": "0.04045854",
      "closeFeePay": "0",
      "stop": "",
      "feeRate": "0.00060",
      "fixFee": "0",
      "feeCurrency": "USDT",
      "marginMode": "ISOLATED",
      "fee": "0.04045854",
      "settleCurrency": "USDT",
      "orderType": "market",
      "displayType": "market",
      "tradeType": "trade",
      "subTradeType": null,
      "tradeTime": 1729155616320000000,
      "createdAt": 1729155616493
    },
    {
      "symbol": "XBTUSDTM",
      "tradeId": "1784277132002",
      "orderId": "236317094436728832",
      "side": "buy",
      "liquidity": "taker",
      "forceTaker": false,
      "price": "67445",
      "size": 1,
      "value": "67.445",
      "openFeePay": "0",
      "closeFeePay": "0.040467",
      "stop": "",
      "feeRate": "0.00060",
      "fixFee": "0",
      "feeCurrency": "USDT",
      "marginMode": "ISOLATED",
      "fee": "0.040467",
      "settleCurrency": "USDT",
      "orderType": "market",
      "displayType": "market",
      "tradeType": "trade",
      "subTradeType": null,
      "tradeTime": 1729155587944000000,
      "createdAt": 1729155588104
    }
  ]
}

Get Recent Trade History

Request

Request samples

Responses