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

解析されたイベントを初めて使用しますか？まず、解析されたストリームのメンタルモデルを読んでください — 解析されたイベントは、RESTとGraphQLを通じて同じデコードされた命令を返します。

クイックスタート

アクセスを取得

Parsed Eventsはベータ版で、支払いプランで利用可能です。Heliusダッシュボードから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が欠けている場合は、サービスが利用可能なページ範囲の終わりに達しています。

ガイド

Pump.fun ミントを取得

Pump.funでウォレットがデプロイしたすべてのトークンをページングします。

GraphQLでクエリ

アプリが必要とする解析済みフィールドを正確に選択します。

拡張トランザクションからの移行

レガシーAPIからのエンドポイント、パラメータ、および応答のマッピングです。

REST リファレンス

両方のRESTメソッドは/v1/parsed-events/にて、https://mainnet.helius-rpc.comの下でPOSTを介してJSONボディを受け付け、クエリパラメータとしてapi-keyで認証されます。リクエストボディは不明なフィールドを拒否するため、タイプミスは無視されずにエラーとして認識されます。GraphQLクエリはPOST /v1/parsed-events/graphqlに送信します。

トランザクションを解析

POST /v1/parsed-events/transactionsは署名で完全なSolanaトランザクションを取得し、Parsed Streamsを支えるIDLベースの命令デコーダーでデコードし、要求された署名ごとに1つのTransactionResultを返します。同じメソッドはGraphQLでtransactionsとして利用可能です。レスポンス順序は入力順序に一致し、重複する署名も含まれます。欠落したトランザクションおよびアイテムレベルのパーサー失敗はアイテムレベルの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はアドレスの解析されたトランザクション履歴を返します。ページネーション、署名境界、スロット境界、ブロックタイム境界、ソート順序、およびオプションの生トランザクションをサポートします。同じメソッドはGraphQLでtransactionsByAddressとして利用可能です。従来の拡張トランザクションアドレスエンドポイントとは異なり、リクエストパラメータはクエリストリングパラメータではなく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

トレーディング

トランザクションの送信

サービスとしてのウォレット

プライバシー

リソース

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

クイックスタート

ガイド

Pump.fun ミントを取得

GraphQLでクエリ

拡張トランザクションからの移行

REST リファレンス

トランザクションを解析

リクエストボディ

注意事項

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

リクエストボディ

ページネーション

​クイックスタート

​ガイド

Pump.fun ミントを取得

GraphQLでクエリ

拡張トランザクションからの移行

​REST リファレンス

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

​リクエストボディ

​注意事項

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

​リクエストボディ

​ページネーション

クイックスタート

ガイド

REST リファレンス

トランザクションを解析

リクエストボディ

注意事項

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

リクエストボディ

ページネーション