解析されたイベントクイックスタート

Parsed Eventsを初めて使用する場合は、まずParsed Streamsのメンタルモデルをお読みください。Parsed Eventsは、同じデコード済み命令をREST経由で返します。

クイックスタート

Get Access

Parsed Eventsはすべてのプランで利用でき、1リクエストあたり10クレジットです。Helius DashboardからAPIキーを取得し、https://mainnet.helius-rpc.comにリクエストを送信します。プロジェクトのAPIキーで認証し、クエリパラメータとしてapi-keyを渡します。

トランザクションを解析

署名をPOST /v1/parsed-events/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
  }'

結果を読む

レスポンスは、要求された各署名に対して1つの結果を含み、入力順に並びます。各結果にはsignature、parserStatus、およびparsedまたはparserErrorのいずれかが含まれます:

[
  {
    "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
    "parserStatus": "OK",
    "parsed": {
      "slot": 433950192,
      "blockTime": 1784487060,
      "fee": 2005000,
      "feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      "transactionStatus": "OK",
      "nativeTransfers": [
        {
          "fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
          "toUserAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
          "amount": 1500000000000
        }
      ],
      "tokenTransfers": [
        {
          "fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
          "toUserAccount": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
          "fromTokenAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
          "toTokenAccount": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
          "rawTokenAmount": 1498500000000,
          "decimals": 9,
          "tokenStandard": "Fungible",
          "mint": "So11111111111111111111111111111111111111112"
        }
      ],
      "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": [
        {
          "instructionIndex": 5,
          "innerInstructionIndex": 2,
          "stackHeight": 3,
          "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "rawAccounts": [
            "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
            "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
            "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE"
          ],
          "rawData": "3JvpRSxKFyKV",
          "summary": {
            "type": "transfer",
            "description": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE transferred 470.2293 SOL from 7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE to 8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
            "parsedData": null
          },
          "programName": "token",
          "instructionName": "transfer",
          "decoded": {
            "args": {
              "amount": "470229300000"
            },
            "accounts": [
              {
                "name": "source_account",
                "pubkey": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
                "isSigner": false,
                "isWritable": true
              },
              {
                "name": "destination_account",
                "pubkey": "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
                "isSigner": false,
                "isWritable": true
              },
              {
                "name": "owner_or_delegate",
                "pubkey": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
                "isSigner": true,
                "isWritable": false
              }
            ]
          }
        },
        {
          "instructionIndex": 5,
          "innerInstructionIndex": 1,
          "stackHeight": 2,
          "programId": "BiSoNHVpsVZW2F7rx2eQ59yQwKxzU5NvBcmKshCSUypi",
          "rawAccounts": [
            "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
            "8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
            "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
            "2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
            "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
            "EpdaePzdqRkMtdZJquVPUWgyoJ5YEEpYALki6dv9VBrt",
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
            "Sysvar1nstructions1111111111111111111111111",
            "J1to1yufRnoWn81KYg1XkTWzmKjnYSnmE2VY8DGUJ9Qv"
          ],
          "rawData": "67t827t7UwAMHa6U18HnBBLj",
          "summary": null,
          "programName": "bison_fi",
          "instructionName": null,
          "decoded": null
        }
      ]
    }
  }
]

この例は2つのインストラクションに絞られています: ルート内のデコードされたトークン転送と、カタログが知っているがデコードできない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メソッドも、https://mainnet.helius-rpc.comにある/v1/parsed-events/配下のPOSTを介してJSONボディを受け付け、api-keyクエリパラメーターで認証します。リクエストボディでは不明なフィールドが拒否されるため、入力ミスが黙って無視されることはなく、明示的にエラーになります。

トランザクションを解析

POST /v1/parsed-events/transactionsは、署名を使って完全なSolanaトランザクションを取得し、Parsed Streamsを支えるものと同じIDLベースの命令デコーダーでデコードして、リクエストされた署名ごとに1つの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の場合、各結果にrawTransactionとして生のSolanaトランザクションペイロードを含めます。

注意事項

processedコミットメントはサポートされていません。
rawTransactionは、includeRawTransactionがtrueでない限り省略されます。
トランザクション実行エラーは依然として解析可能です。その場合、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の場合、各結果にrawTransactionとして生のSolanaトランザクションペイロードを含めます。

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

取引

トランザクションの送信

Wallet-as-a-Service

プライバシー

リソース

解析されたイベントクイックスタート

クイックスタート

ガイド

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

REST リファレンス

トランザクションを解析

リクエストボディ

注意事項

解析済みトランザクション履歴

リクエストボディ

ページネーション

​クイックスタート

​ガイド

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

​REST リファレンス

​トランザクションを解析

​リクエストボディ

​注意事項

​解析済みトランザクション履歴

​リクエストボディ

​ページネーション

クイックスタート

ガイド

REST リファレンス

トランザクションを解析

リクエストボディ

注意事項

解析済みトランザクション履歴

リクエストボディ

ページネーション