# 交易資訊

### <mark style="color:blue;">交易物件</mark>

以下端點（`POST Transfers` 和 `POST Transaction Details`）使用共用的 交易物件 (Transaction Object) 來回應。以下是**交易物件**的結構：

欄位：

| 欄位                   | 類別                                                                                       | 說明                                     |
| -------------------- | ---------------------------------------------------------------------------------------- | -------------------------------------- |
| fromAddress          | string                                                                                   | 傳送地址                                   |
| toAddress            | string                                                                                   | 接收地址                                   |
| layer                | [TransactionLayer](/traditional-chinese/secureapi/can-kao-zi-liao.md#transactionlayer)   | 交易層（`L1Transaction` 或 `L2Transaction`） |
| initiatedAt          | string                                                                                   | ISO8601 格式的日期                          |
| confirmededAt        | string                                                                                   | 以 ISO8601 格式確認的日期                      |
| amount               | string                                                                                   | 交易金額（以字串形式，以避免精確度問題）                   |
| coinSymbol           | [NetworkSymbol](/traditional-chinese/secureapi/can-kao-zi-liao.md#networksymbol)         | 交易的網路 (L1) (例如 `ETH`)                  |
| status               | [TransactionStatus](/traditional-chinese/secureapi/can-kao-zi-liao.md#transactionstatus) | 交易狀態 (`Pending`、`Confirmed`或`Failed`)  |
| txHash               | string                                                                                   | L1 交易的網路哈希值 (L2 可選擇使用)                 |
| feesPaid             | string                                                                                   | 在網絡上支付礦工費（L2 可選）                       |
| l2TxnHash            | string                                                                                   | Akashic 交易哈希值 (L1 和 L2)                |
| tokenSymbol          | [TokenSymbol](/traditional-chinese/secureapi/can-kao-zi-liao.md#tokensymbol)             | 代幣交易的代幣符號（可選）                          |
| reason               | string                                                                                   | 失敗原因 (如果狀態為 `Failed`)                  |
| internalFee          | object                                                                                   | Akashic 費用詳細資訊（可選）                     |
| internalFee.deposit  | string                                                                                   | 存款費用（可選）                               |
| internalFee.withdraw | string                                                                                   | 提款費用（可選）                               |
| identifier           | string                                                                                   | 存款的使用者識別碼(identifier)（可選）              |

範例：

```json
{
  "fromAddress": "string",
  "toAddress": "string",
  "layer": "string",
  "initiatedAt": "string",
  "confirmededAt": "string",
  "amount": "string",
  "coinSymbol": "string",
  "status": "string",
  "txHash": "string",
  "feesPaid": "string",
  "l2TxnHash": "string",
  "tokenSymbol": "string",
  "reason": "string",
  "internalFee": {
    "deposit": "string",
    "withdraw": "string"
  },
  "identifier": "string"
}
```

### <mark style="color:blue;">取得交易詳細資料</mark>

端點： `POST /getTransactionDetails`

說明： 擷取個別交易的詳細資訊。如果沒有找到所查詢雜湊的交易，則返回 `null`。

請求參數：

| 參數       | 類別     | 需要 | 說明                      |
| -------- | ------ | -- | ----------------------- |
| l2TxHash | string | 是  | 交易的 L2 AkashicChain 哈希值 |

回應： 返回單一交易物件或 `null`。

### <mark style="color:blue;">取得傳輸 (Get Transfers)</mark>

端點： `POST /getTransfers`

說明： 擷取所有或部分交易，可選擇 `layer`、`status`、`startDate`、`endDate` 或 `hideSmallTransactions` 篩選。支援 `page` 和 `limit`。`hideSmallTransactions` 參數排除價值低於 1 美元的交易。

請求參數：

| 參數                    | 類別                                                                                       | 需要 | 說明                                        |
| --------------------- | ---------------------------------------------------------------------------------------- | -- | ----------------------------------------- |
| page                  | number                                                                                   | 否  | 用於分頁的頁碼                                   |
| limit                 | number                                                                                   | 否  | 每頁的交易筆數                                   |
| layer                 | [TransactionLayer](/traditional-chinese/secureapi/can-kao-zi-liao.md#transactionlayer)   | 否  | 依交易層（`L1Transaction` 或 `L2Transaction`）篩選 |
| status                | [TransactionStatus](/traditional-chinese/secureapi/can-kao-zi-liao.md#transactionstatus) | 否  | 依交易狀態篩選 (`Pending`、已`Confirmed`或`Failed`) |
| startDate             | string                                                                                   | 否  | ISO8601 格式的開始日期                           |
| endDate               | string                                                                                   | 否  | ISO8601 格式的結束日期                           |
| hideSmallTransactions | boolean                                                                                  | 否  | 不包括價值低於 1 美元的交易                           |
| identifier            | string                                                                                   | 否  | 依 `identifier` 篩選結果                       |
| referenceId           | string                                                                                   | 否  | 依 referenceId 篩選結果                        |

> 注意：最小 `limit` 為 10，預設行為為 `hideSmallTransactions` .

回應： 傳回一個交易物件陣列。

```json
[
  {
    "fromAddress": "string",
    "toAddress": "string",
    "layer": "string",
    "initiatedAt": "string",
    "confirmededAt": "string",
    "amount": "string",
    "coinSymbol": "string",
    "status": "string",
    "txHash": "string",
    "feesPaid": "string",
    "l2TxnHash": "string",
    "tokenSymbol": "string",
    "reason": "string",
    "internalFee": {
      "deposit": "string",
      "withdraw": "string"
    },
    "identifier": "string"
  }
]
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akashicpay.com/traditional-chinese/secureapi/han-shi-functions/jiao-yi-zi-xun.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.