> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 订单列表

> 分页和筛选列出您的订单

## 订单列表

返回您的订单分页列表，最新的在前。

### 查询参数

<ParamField query="page" type="number">
  页码（默认 1）
</ParamField>

<ParamField query="page_size" type="number">
  每页结果数（默认 50，最大 100）
</ParamField>

<ParamField query="status" type="string">
  按状态筛选（例如 `filled`、`pending`、`failed`）
</ParamField>

<ParamField query="type" type="string">
  按订单类型筛选 —— `energy` 或 `bandwidth`
</ParamField>

### 响应

返回 `orders`（订单对象数组）、`total`、`page` 和 `page_size`。

### 示例

```bash theme={null}
curl "https://api.tronrental.com/v1/orders?type=energy&status=filled&page=1" \
  -H "X-API-Key: your_api_key"
```

```json Response theme={null}
{
  "orders": [
    {
      "id": 12345,
      "type": "energy",
      "target_address": "TRecipientAddress...",
      "volume": 65000,
      "duration": "1h",
      "price_trx": "1.79",
      "status": "filled",
      "delegate_txid": "a1b2c3d4e5f6...",
      "undelegate_txid": null,
      "reclaim_at": null,
      "source": "api",
      "created_at": "2026-06-10T04:30:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 50
}
```