Current Orders

Query Current Orders

Query user's current unfinished order list.

HTTP Request

GET

/api/perp-trade-api/curr-info/orders

Request Frequency Restriction:

• Recommended: no more than 10 times per second

Authentication Required:

• JWT Token required
• X-Wallet-Address header required

Request Headers

Name	Type	Required	Description
Authorization	string	Yes	JWT Token, format: Bearer {token}
X-Wallet-Address	string	Yes	Wallet address

Request Parameters

Name	Type	Required	Description
symbol	string	No	Trading pair, e.g., ETH-PERP, if not provided, query all trading pairs
pageNum	integer	No	Page number, default is 1
pageSize	integer	No	Page size, default is 20

Response Fields Description

Returns paginated response, containing:

Name	Type	Description
total	long	Total number of records
pageNum	integer	Current page number
pageSize	integer	Page size
list	array	Order list

Each order contains:

Name	Type	Description
id	long	Order ID
clientId	string	Client ID
orderStatus	string	Order status
hash	string	Order hash
symbol	string	Trading pair
orderType	string	Order type
creator	string	User address
side	string	Trading direction
price	string	Price
quantity	string	Quantity
leverage	string	Leverage
fee	string	Fee
filledFee	string	Filled fee
createdAt	long	Creation time (milliseconds)
updatedAt	long	Update time (milliseconds)
filledQty	string	Filled quantity
avgFillPrice	string	Average fill price
openQty	string	Unfilled quantity
orderValue	string	Order value
triggerConditionType	string	Trigger condition type
triggerPrice	string	Trigger price
triggerDirection	integer	Trigger direction
reduceOnly	boolean	Whether reduce-only
planOrderType	string	Plan order type
planType	string	Plan type
planBatchId	long	Plan batch ID

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 10,
    "pageNum": 1,
    "pageSize": 20,
    "list": [
      {
        "id": 123456,
        "clientId": "my-order-001",
        "orderStatus": "NEW",
        "hash": "0xabc123...",
        "symbol": "ETH-PERP",
        "orderType": "LIMIT",
        "creator": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
        "side": "BUY",
        "price": "2500",
        "quantity": "1",
        "leverage": "5",
        "fee": "0",
        "filledFee": "0",
        "createdAt": 1700000000000,
        "updatedAt": 1700000000000,
        "filledQty": "0",
        "avgFillPrice": "0",
        "openQty": "1",
        "orderValue": "2500",
        "reduceOnly": false,
        "planOrderType": "open"
      }
    ]
  }
}