Order List

INFO

Primarily query unfilled or partially filled orders in real-time.

HTTP Request

POST `/v1/trade/order-list`

NOTE

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

Request Parameters

Parameter	Required	Type	Comments
coin	false	string	Values: `BTCUSDT`, `ETHUSDT`, `SOLUSDT`, `XRPUSDT` `1000PEPEUSDT`, `WLDUSDT`, `DOGEUSDT`, `STPTUSDT`, `SUIUSDT`, `ADAUSDT`, `ARBUSDT`, `XLMUSDT`, `HIVEUSDT`, `ONDOUSDT`
limit	false	integer	LImit for data size per page. [`1`, `50`]. Default: `10`
page	false	integer	Refer to the next page request parameter

Response Parameters

Parameter	Type	Comments
statusCode	number	`200`
result	object	Result object containing data and pagination
result.list	array	Array of order objects
result.list[].id	number	Order ID
result.list[].coin	string	Trading pair symbol
result.list[].leverage	string	Leverage value
result.list[].orderType	string	Order type: `limit`, `market`
result.list[].side	string	Position side: `long`, `short`
result.list[].entryPrice	string	Entry price
result.list[].marginMode	string	Margin mode: `Isolated`, `Cross`
result.list[].exitPrice	string	Exit price
result.list[].size	string	Position size
result.list[].tradeType	string	Trade type: `open`, `close`
result.list[].tradingFee	string	Trading fee
result.list[].createdTime	number	Order creation timestamp (Unix time in ms)
result.pagination	object	Pagination information
result.pagination.page	number	Current page number
result.pagination.limit	number	Items per page
result.pagination.totalRecords	number	Total number of records
result.pagination.totalPages	number	Total number of pages
message	string	Response message

Request Example

GET /v1/trade/order-list  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": 8,
        "coin": "BTCUSDT",
        "leverage": "1.00",
        "orderType": "limit",
        "side": "long",
        "entryPrice": "80155.89000000",
        "marginMode": "Isolated",
        "exitPrice": "80155.89000000",
        "size": "0.01300000",
        "tradeType": "open",
        "tradingFee": "0.21500000",
        "createdTime": 1742398872000
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "totalRecords": 1,
      "totalPages": 1
    }
  },
  "message": "OK"
}

Order List

HTTP Request

POST /v1/trade/order-list

Request Parameters

Response Parameters

Request Example

Response Example

On this page

POST `/v1/trade/order-list`