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

# 解析交易

> 使用 Helius 增强交易 API 将 Solana 交易签名解析为结构化的可读数据。

<Warning>
  增强事务API是一个处于维护模式的旧版产品。它仍然可用，这些页面也仍然可以访问，但它不再接收新的解析器类型或功能工作。其继任者是[解析事件](/docs/zh/parsed-events)，通过IDL目录解码指令，目前处于封闭测试阶段。您还可以使用[`getTransactionsForAddress`](/docs/zh/rpc/gettransactionsforaddress)进行交易历史记录和回填，并使用[钱包API](/docs/zh/wallet-api/overview)获取人类可读的钱包数据。
</Warning>

## 概述

解析交易终端将原始交易签名转换为结构化的、可读的信息。无需手动解码指令数据和帐户列表，即可获得关于转账、交换、NFT 活动等的详细信息。

发送一个 `POST` 请求到 `/v0/transactions` ，每次调用最多可包含 100 个签名。

## 使用时机

* 你拥有一个或多个交易签名，并希望获得预解析的、可读的输出。
* 你正在向用户显示单笔交易的详细信息（钱包、探索器）。
* 你需要事件摘要（SOL/代币转移，NFT 活动），无需编写自己的解析器。

对于新的构建，[`getTransaction`](/docs/zh/api-reference/rpc/http/gettransaction) 返回原始交易，[`getTransactionsForAddress`](/docs/zh/rpc/gettransactionsforaddress) 是现代历史路径。

## 快速开始

<Steps>
  <Step title="获取你的 API 密钥">
    在 [dashboard.helius.dev](https://dashboard.helius.dev) 注册并复制你的 API 密钥。
  </Step>

  <Step title="POST 签名到 /v0/transactions">
    在 `transactions` 的 body 字段中传递一个签名数组。

    <Tabs>
      <Tab title="JavaScript">
        ```javascript theme={"system"}
        const parseTransaction = async () => {
          const url = "https://mainnet.helius-rpc.com/v0/transactions/?api-key=YOUR_API_KEY";

          const response = await fetch(url, {
            method: 'POST',
            headers: {
              'Content-Type': 'application/json',
            },
            body: JSON.stringify({
              transactions: ["5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP"],
            }),
          });

          const data = await response.json();
          console.log("Parsed transaction:", data);
        };

        parseTransaction();
        ```
      </Tab>

      <Tab title="Python">
        ```python theme={"system"}
        import requests
        import json

        def parse_transaction():
            url = "https://mainnet.helius-rpc.com/v0/transactions/?api-key=YOUR_API_KEY"

            payload = {
                "transactions": ["5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP"]
            }

            response = requests.post(url, json=payload)
            data = response.json()
            print("Parsed transaction:", data)

        parse_transaction()
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="读取解析的响应">
    每个交易返回包括描述、类型、转账和事件摘要。请参见下面的[响应](#响应)。
  </Step>
</Steps>

## 请求参数

<ParamField body="transactions" type="string[]" required>
  要解析的交易签名数组。每次请求最多可包含 100 个签名。
</ParamField>

## 响应

每个解析的交易包括一个人类可读的描述以及结构化的转移和事件数据：

```json theme={"system"}
{
  "description": "Transfer 0.1 SOL to FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
  "type": "TRANSFER",
  "source": "SYSTEM_PROGRAM",
  "fee": 5000,
  "feePayer": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
  "signature": "5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP",
  "slot": 171341028,
  "timestamp": 1674080473,
  "nativeTransfers": [
    {
      "fromUserAccount": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
      "toUserAccount": "FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
      "amount": 100000000
    }
  ],
  "events": {
    "sol": {
      "from": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
      "to": "FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
      "amount": 0.1
    }
  }
}
```

每个解析的交易包括：

* **`description`** — 人类可读的事件摘要。
* **`type`** — 交易类别 (`TRANSFER`, `SWAP`, `NFT_SALE` 等)。
* **`source`** — 执行交易的程序。
* **`fee`** / **`feePayer`** — 以 lamports 计算的交易费用及支付账户。
* **`nativeTransfers`** — 账户之间的 SOL 转移。
* **`tokenTransfers`** — SPL 代币转移。
* **`events`** — 高级事件摘要。
* **`slot`** / **`timestamp`** — 交易处理时间。

有关完整的字段目录和所有支持的交易类型，请参见 [Parse Transactions API 参考](/docs/zh/api-reference/enhanced-transactions/gettransactions)。

## 下一步

<CardGroup cols={2}>
  <Card title="交易历史" icon="clock-rotate-left" href="/docs/zh/enhanced-transactions/transaction-history">
    获取某个地址的人类可读交易历史，支持过滤和分页。
  </Card>

  <Card title="getTransactionsForAddress" icon="clock-rotate-left" href="/docs/zh/rpc/gettransactionsforaddress">
    交易历史和回填的现代 Helius 原生替代方法。
  </Card>

  <Card title="钱包 API" icon="wallet" href="/docs/zh/wallet-api/overview">
    REST 端点提供人类可读的钱包数据：余额、历史和转账。
  </Card>

  <Card title="数据获取概述" icon="database" href="/docs/zh/getting-data">
    比较查询 Solana 数据的所有 Helius 选项。
  </Card>
</CardGroup>