Historical Orders

O

GET /address/get_orders/{address}

Description: Retrieve order history for a specific wallet address, including open/close orders, PnL, fees, leverage, and liquidation details. Supports filtering by time range and pagination.

---

Request

HTTP Method: GET Endpoint:

/address/get_orders/{address}

Path Parameter

Name	Type	Description
address	string	Wallet address

Query Parameters

Field	Type	Description
limit	number	Page size
offset	number	Pagination offset
startTime	number	Start timestamp (optional)
endTime	number	End timestamp (optional)

---

Response

Content Type: application/json

Field	Type	Description
list	Order[]	List of orders
total	number	Total records

---

Type: Order

Field	Type	Description
id	number	Order ID
address	string	Wallet address
oid	number	Order OID
orderType	string	Order type (open / close)
symbol	string	Token symbol
side	string	Direction (long / short)
size	number	Order size
price	number	Execution price
leverage	number	Leverage multiplier
isFilled	number	Filled size
filledAt	number	Filled timestamp
createdAt	number	Creation timestamp
closedPnl	number	PnL when the position is closed
fee	number	Trading fee
feeToken	string	Fee token
liquidatedUser	string	Address of the liquidated user (if any)
liquidationMarkPx	string	Mark price at liquidation
liquidationMethod	string	Liquidation method

---

Functionality

This endpoint provides a complete record of trading orders associated with a wallet address. It includes:

• Open and close position orders

• Position size, leverage, and direction (long/short)

• Execution and creation timestamps

• Final PnL for closed trades

• Fee information

• Liquidation details for forced-close events

Useful for building:

• Trade history pages

• PnL analytics

• Portfolio and risk dashboards

• Liquidation monitoring tools

---

Example Request

GET https://openapi.wildmeta.ai/dataprovider/v1/address/get_orders/0xAbC123...?limit=20&offset=0&startTime=1636500000&endTime=1636540000

---

Example Response

{
  "list": [
    {
      "id": 10123,
      "address": "0xAbC123...",
      "oid": 88472,
      "orderType": "open",
      "symbol": "BTC",
      "side": "long",
      "size": 1.25,
      "price": 62400.5,
      "leverage": 10,
      "isFilled": 1.25,
      "filledAt": 1636520000,
      "createdAt": 1636519999,
      "closedPnl": 0,
      "fee": 12.5,
      "feeToken": "USDT",
      "liquidatedUser": "",
      "liquidationMarkPx": "",
      "liquidationMethod": ""
    }
  ],
  "total": 342
}