> For the complete documentation index, see [llms.txt](https://docs.catfee.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catfee.io/api-reference/transaction/get-transaction.md).

# 查询订单信息

支持通过订单 ID 或客户端订单 ID 查询当前认证会员的能量直达订单。按订单 ID 查询返回单个订单对象；按客户端订单 ID 查询返回该客户端订单 ID 下所有资源类型的订单列表，包括 ENERGY 和 BANDWIDTH 订单。

## 按订单 ID 查询

使用 `GET /v1/mate/open/transaction/{order_id}`。`order_id` 为创建订单返回的 `data.order_id`，不是代理交易哈希 `data.hash`。

{% openapi src="/files/mASYqPqYbNkoFrs0gDaT" path="/v1/mate/open/transaction/{order\_id}" method="get" %}
[mate-transaction-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-62fdeda133f249e9bd7adbb71207855d05bf6296%2Fmate-transaction-api.json?alt=media)
{% endopenapi %}

## 按客户端订单 ID 查询

使用 `GET /v1/mate/open/transaction?client_order_id=...`。如果创建订单时传入了 `client_order_id`，可使用同一个值查询所有匹配的订单，无需先取得系统返回的订单 ID。

{% openapi src="/files/mASYqPqYbNkoFrs0gDaT" path="/v1/mate/open/transaction" method="get" %}
[mate-transaction-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-62fdeda133f249e9bd7adbb71207855d05bf6296%2Fmate-transaction-api.json?alt=media)
{% endopenapi %}

### 请求参数

参数通过 URL 查询字符串传入，无需请求体。

| 参数                | 类型     | 必填 | 说明                                       |
| ----------------- | ------ | -- | ---------------------------------------- |
| `client_order_id` | string | 是  | 创建订单时传入的客户端订单 ID，长度为 1～64 个字符，不能只包含空白字符。 |

客户端订单 ID 仅在当前会员内匹配。其他会员即使使用相同的客户端订单 ID，也不能查询到您的订单。未传入客户端订单 ID 创建的订单，请使用订单 ID 查询。

### 请求示例

```http
GET /v1/mate/open/transaction?client_order_id=my-order-001 HTTP/1.1
Host: api.catfee.io
CF-ACCESS-KEY: your_api_key
CF-ACCESS-SIGN: generated_signature
CF-ACCESS-TIMESTAMP: current_utc_timestamp
```

两种查询方式均需携带上述三个 API 鉴权头。签名使用 HTTP 方法 `GET` 和完整请求路径；按客户端订单 ID 查询时，路径必须包含 `?client_order_id=...`。参数需正确进行 URL 编码，签名使用的参数顺序和编码应与实际请求一致。详见 [API概览](https://docs.catfee.io/getting-started/buy-energy-via-api-on-catfee/api-overview.md)。

## 响应说明

`code=0` 表示查询成功，`data` 的结构取决于查询方式：

| 查询方式                                                          | `data`                      | 无匹配订单时           |
| ------------------------------------------------------------- | --------------------------- | ---------------- |
| 按订单 ID：`GET /v1/mate/open/transaction/{order_id}`             | 单个订单对象。                     | 返回订单不存在错误。       |
| 按客户端订单 ID：`GET /v1/mate/open/transaction?client_order_id=...` | 当前会员该客户端订单 ID 下所有资源类型的订单数组。 | 返回空数组：`data=[]`。 |

每个订单对象包含 `order_id`、`client_order_id`、`resource_type`、`status`、`payment_status` 和 `confirm_status` 等字段。按客户端订单 ID 查询时，应遍历 `data`，结合每个订单的 `resource_type` 分别处理，不能将 `data` 当作单个订单对象读取。

按客户端订单 ID 查询无匹配订单时，响应示例：

```json
{
  "code": 0,
  "msg": "",
  "data": []
}
```

两种查询方式均不会返回其他会员的订单。参数错误或查询失败时，请结合响应中的 `code` 和 `msg` 处理，详见 [API 错误码与处理说明](https://docs.catfee.io/getting-started/buy-energy-via-api-on-catfee/api-error-codes.md)。

查询成功不代表代理或回收已完成。判断链上处理进度应查看 `confirm_status`；例如 `RECLAIM_CONFIRMED` 表示回收已在链上确认，不能仅凭 `status=CONFIRMED` 判断回收完成。
