Trade

Trade History

INFO

Query the trade history for executed and cancelled orders.

HTTP Request

GET /v1/trade/trade-history

NOTE

Don't include trailing slash / at the end of the endpoint. Doing so can result in a "not found" error.

Request Parameters

ParameterRequiredTypeComments
pageoptionalintegerPage number
limitoptionalintegerLimit of records per page

Response Parameters

ParameterTypeComments
statusCodenumber200
resultobjectResult object containing list and pagination
result.listarrayArray of trade history objects
result.list[].idnumberposition ID
result.list[].coinstringTrading pair symbol
result.list[].sidestringPosition side: long, short
result.list[].leveragestringLeverage value
result.list[].tradePricestringTrade execution price
result.list[].sizestringTrade size
result.list[].tradeTypestringTrade type: open, add, partial_close, full_close
result.list[].orderTypestringorder type: market, limit
result.list[].tradingFeestringTrading fee
result.list[].statusstringTrade status: executed, cancelled
result.list[].createdTimenumberTrade timestamp (Unix time in ms)
result.paginationobjectPagination information
result.pagination.pagenumberCurrent page number
result.pagination.nextPagenumberNext page number
result.pagination.limitnumberItems per page
result.pagination.totalRecordsnumberTotal number of records
result.pagination.totalPagesnumberTotal number of pages
messagestringResponse message

Request Example

GET /v1/trade/trade-history HTTP/1.1
Host: api.heatmex.com
X-HEATMEX-SIGN: XXXXX
X-HEATMEX-API-KEY: XXXXX
Content-Type: application/json

Response Example

{
  "statusCode": 200,
  "result": {
    "list": [
      {
        "id": 11,
        "coin": "BTCUSDT",
        "side": "long",
        "leverage": "100.00",
        "tradePrice": "86578.00000000",
        "size": "0.11300000",
        "tradeType": "full_close",
        "orderType": "market",
        "tradingFee": "0.97833140",
        "status": "executed",
        "createdTime": 1766030427000
      },
      {
        "id": 11,
        "coin": "BTCUSDT",
        "side": "long",
        "leverage": "100.00",
        "tradePrice": "86598.80000000",
        "size": "0.11300000",
        "tradeType": "open",
        "orderType": "market",
        "tradingFee": "0.97856644",
        "status": "executed",
        "createdTime": 1766030427000
      }
    ],
    "pagination": {
      "page": 1,
      "nextPage": 2,
      "limit": 2,
      "totalRecords": 18,
      "totalPages": 9
    }
  },
  "message": "OK"
}

On this page