解析事件快速入门

刚开始使用解析事件？请先阅读解析流的心智模型——解析事件通过 REST 返回相同的已解码指令。

快速入门

Get Access

所有套餐均可使用解析事件，每个请求消耗 10 个积分。从 Helius Dashboard 获取你的 API 密钥，并向 https://mainnet.helius-rpc.com 发送请求。使用您的项目API密钥进行身份验证，作为api-key查询参数传递。

解析交易

在POST /v1/parsed-events/transactions的transactions主体字段中传递签名：

JavaScript
cURL

const parseTransactions = async () => {
  const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY";

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

  const data = await response.json();
  console.log(data);
};

parseTransactions();

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "transactions": [
      "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"
    ],
    "includeRawTransaction": false
  }'

读取结果

响应包含每个请求签名的一个结果，按输入顺序排列。每个结果包括signature，parserStatus，以及parsed或parserError：代码_占位符_ea7e44da78fe9e92_结束示例被精简为两条指令：路由中的解码的令牌转移，以及目录已知但无法解码的AMM指令，导致instructionName保持为null，而rawData和rawAccounts仍然可用。查看解析的响应以获取每个字段和完整的示例响应。

获取地址历史记录

POST /v1/parsed-events/transaction-history返回相同的解析结果，适用于触及地址的每笔交易，默认按最新排序：

JavaScript
cURL

const fetchTransactionHistory = async () => {
  const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY";

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      address: "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      limit: 100,
      sortOrder: "desc",
      commitment: "confirmed",
    }),
  });

  const page = await response.json();
  console.log(page.data);
  console.log(page.paginationToken);
};

fetchTransactionHistory();

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
      "address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      "limit": 100,
      "sortOrder": "desc",
      "commitment": "confirmed"
    }'

分页

历史响应将结果包装在一个页面对象中。在下一个请求中传递paginationToken以继续。如果paginationToken缺失，表示服务已达到可用页面范围的末尾。

指南

Fetch Pump.fun Mints

分页获取某个钱包在 Pump.fun 上部署的每个代币。

Migrate from Enhanced Transactions

从旧版 API 迁移时的端点、参数和响应映射。

REST参考

这两种 REST 方法都通过 POST 接受 JSON 请求体，该请求体位于 https://mainnet.helius-rpc.com 的 /v1/parsed-events/ 下，并使用 api-key 查询参数进行身份验证。请求体会拒绝未知字段，因此拼写错误会直接导致失败，而不会被静默忽略。

解析交易

POST /v1/parsed-events/transactions 按签名获取完整的 Solana 交易，使用支持解析流的同一套基于 IDL 的指令解码器进行解码，并为每个请求的签名返回一个 TransactionResult。响应顺序与输入顺序相匹配，包括重复的签名。缺失的交易和每个项目解析失败的结果返回为项目级别的parserStatus: "ERROR"结果：

[
  {
    "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
    "parserStatus": "ERROR",
    "parserError": {
      "code": "transaction_not_found",
      "message": "transaction was not found"
    }
  }
]

请求正文

string[]

必填

要解析的交易签名。最大批次大小为100。

string

默认值:"confirmed"

获取交易时使用的承诺级别。

confirmed
finalized

boolean

默认值:"false"

当true时，包含原始Solana交易负载作为每个结果的rawTransaction。

注意事项

不支持processed承诺。
除非includeRawTransaction为true，否则省略rawTransaction。
交易执行失败仍然可以解析。在这种情况下，parsed.transactionStatus为ERROR，并且当可用时，交易错误会在parsed.error上暴露。
请求级别的验证错误返回错误响应，而不是项目级别的结果。

解析的交易历史

POST /v1/parsed-events/transaction-history 返回某个地址的已解析交易历史记录。它支持分页、签名边界、时隙边界、区块时间边界、排序顺序以及可选的原始交易。与传统的增强交易地址端点不同，请求参数以JSON正文而不是查询字符串参数发送。

请求正文

string

必填

要获取其交易历史的地址。

number

默认值:"100"

要返回的交易数量。必须在1和100之间。

string

返回此签名之前的交易。

string

返回此签名之后的交易。

string

上一个响应返回的游标。

string

默认值:"desc"

返回交易的排序顺序。

asc
desc

string

默认值:"confirmed"

历史记录获取时使用的承诺级别。

confirmed
finalized

boolean

默认值:"false"

当true时，包含原始Solana交易负载作为每个结果的rawTransaction。

object

槽位比较范围。每个范围是可选的：gt，gte，lt，lte。

object

以Unix秒为单位的区块时间比较范围。每个范围是可选的：gt，gte，lt，lte。

分页

响应具有此形状。每个data项目使用解析交易返回的相同TransactionResult格式：

{
  "data": [
    {
      "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
      "parserStatus": "OK",
      "parsed": {
        "slot": 433950192,
        "blockTime": 1784487060,
        "fee": 2005000,
        "feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
        "transactionStatus": "OK",
        "nativeTransfers": [],
        "tokenTransfers": [],
        "summary": {
          "type": "swap",
          "description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
          "parsedData": {
            "type": "swap",
            "protocol": "jupiter",
            "kind": "swap",
            "in_amount": "1500000000000",
            "actual_out_amount": "64672839261950",
            "input_mint": "So11111111111111111111111111111111111111112",
            "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
            "inner_swaps": [
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "470229300000",
                "output_amount": "35579021038",
                "input_mint": "So11111111111111111111111111111111111111112",
                "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "1028270700000",
                "output_amount": "77798063361",
                "input_mint": "So11111111111111111111111111111111111111112",
                "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "14625643887",
                "output_amount": "8348494812168",
                "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "35566391375",
                "output_amount": "20283004384731",
                "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "63185049137",
                "output_amount": "36041340065051",
                "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
              }
            ]
          }
        },
        "instructions": []
      }
    }
  ],
  "paginationToken": "433950192:0"
}

在下一个请求中传递paginationToken以继续。如果paginationToken缺失，服务已达到可用页面范围的末尾。

开始使用

数据流与事件监听

数据 API 与 RPC

交易

发送交易

钱包即服务

隐私

资源

解析事件快速入门

快速入门

指南

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

REST参考

解析交易

请求正文

注意事项

解析的交易历史

请求正文

分页

​快速入门

​指南

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

​REST参考

​解析交易

​请求正文

​注意事项

​解析的交易历史

​请求正文

​分页

快速入门

指南

REST参考

解析交易

请求正文

注意事项

解析的交易历史

请求正文

分页