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

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

クイックスタート

アクセスを取得

解析されたイベントはクローズドベータです。プロジェクトで有効になっていることを確認してください。クローズドベータに参加するには、こちらに申し込むください。APIキーをプロジェクトに認証し、クエリパラメータとしてapi-keyを渡します。

トランザクションを解析

署名をtransactionsのボディフィールドに渡します:

JavaScript
cURL

const parseTransactions = async () => {
  const url = "https://<ENDPOINT>/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://<ENDPOINT>/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": [
        {
          "topIxIdx": 5,
          "innerIxIdx": 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
              }
            ]
          }
        },
        {
          "topIxIdx": 5,
          "innerIxIdx": 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 /transaction-historyはアドレス用の同じTransactionResultアイテムを返します。通常、新しいものから始まります:

JavaScript
cURL

const fetchTransactionHistory = async () => {
  const url = "https://<ENDPOINT>/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://<ENDPOINT>/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でクエリ

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

REST リファレンス

両方のエンドポイントは、Heliusチームが共有するエンドポイントで、api-keyクエリパラメータで認証されたJSONボディを受け入れます。リクエストボディは未知のフィールドを拒否するので、タイプミスは静かに無視されるのではなく、明示的に失敗します。

トランザクションを解析

POST /transactionsは署名で完全なSolanaトランザクションを取得し、それらを解析ストリームを支える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 /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 リファレンス

トランザクションを解析

リクエストボディ

注意事項

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

リクエストボディ

ページネーション