> For the complete documentation index, see [llms.txt](https://docs.wildmeta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wildmeta.ai/trading-terminal/x402-support-and-extension/data-provider/historical-orders.md).

# Historical Orders

## `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**

```json
{
  "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
}
```