取引履歴

Enhanced Transactions APIはメンテナンスモードのレガシープロダクトです。動作はしますが、新しいパーサータイプや機能は追加されません。新しいビルドには、トランザクション履歴とバックフィルにはgetTransactionsForAddressを、人が読みやすいウォレットデータの取得にはWallet APIを使用してください。

概要

Transaction Historyエンドポイントは、任意のSolanaアドレスの人が読みやすい取引履歴を返します。生のインストラクションデータやアカウントリストを扱う代わりに、構造化された情報を取得できます。

取引で何が起こったか（転送、スワップ、NFT活動）。
関与したアカウント。
転送されたSOLまたはトークンの量。
関連するメタデータ（トークンミントアドレス、トークン名、トークンシンボルなど）。

[GET]リクエストを[/v0/addresses/{address}/transactions]に送信します。このエンドポイントはgetTransactionsForAddressRPCメソッドによって駆動されています。

使用タイミング

アドレスの取引履歴をユーザーに表示する（ウォレット、ポートフォリオトラッカー、エクスプローラ）。
自分のデコーダーを作成することなく、事前解析済みの人が読みやすい履歴が必要。
取引タイプ、時間範囲、またはスロット範囲で履歴をフィルタリングする必要がある。
ウォレットの完全なトークン履歴、関連するトークンアカウント（ATA）を含む必要がある—下記参照。

新しいビルドには、サーバーサイドフィルタリングとトークンアカウントのルックアップが備わったモダンなHeliusネイティブパスであるgetTransactionsForAddressを使用してください。

クイックスタート

APIキーを取得

dashboard.helius.devでサインアップしてAPIキーをコピーします。

アドレストランザクションエンドポイントを取得

任意のSolanaアドレスの取引履歴を取得します。

JavaScript
Python

const fetchWalletTransactions = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K"; // Replace with target wallet
  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY`;

  const response = await fetch(url);
  const transactions = await response.json();
  console.log("Wallet transactions:", transactions);
};

fetchWalletTransactions();

import requests

def fetch_wallet_transactions():
    wallet_address = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K"  # Replace with target wallet
    url = f"https://mainnet.helius-rpc.com/v0/addresses/{wallet_address}/transactions?api-key=YOUR_API_KEY"

    response = requests.get(url)
    transactions = response.json()
    print("Wallet transactions:", transactions)

fetch_wallet_transactions()

フィルタリングとページネーション

以下の[type]、時間、スロットフィルタで結果を絞り、高ボリュームアドレスをシグネチャカーソルでページ送りします。

ネットワークサポート

ネットワーク	サポート	保存期間
メインネット	はい	無制限
開発ネット	はい	2週間
テストネット	いいえ	該当なし

リクエストパラメータ

パラメータ	説明	デフォルト	例
`limit`	返す取引数 (1-100)	10	`&limit=25`
`before-signature`	このシグネチャより前の取引を取得（[`sort-order=desc`]と使用）	-	`&before-signature=sig123...`
`after-signature`	このシグネチャより後の取引を取得（[`sort-order=asc`]と使用）	-	`&after-signature=sig456...`
`type`	取引タイプでフィルタ	-	`&type=NFT_SALE`
`sort-order`	結果のソート順序	`desc`	`&sort-order=asc`
`token-accounts`	関連トークンアカウントの取引をフィルタ	`none`	`&token-accounts=balanceChanged`
`commitment`	コミットメントレベル	`finalized`	`&commitment=confirmed`

時間に基づくフィルタリング

パラメータ	説明	例
`gt-time`	このUnixタイムスタンプ後のトランザクション	`&gt-time=1656442333`
`gte-time`	このUnixタイムスタンプ以降のトランザクション	`&gte-time=1656442333`
`lt-time`	このUnixタイムスタンプ前のトランザクション	`&lt-time=1656442333`
`lte-time`	このUnixタイムスタンプ以前のトランザクション	`&lte-time=1656442333`

スロットに基づくフィルタリング

パラメータ	説明	例
`gt-slot`	このスロット後のトランザクション	`&gt-slot=148277128`
`gte-slot`	このスロット以降のトランザクション	`&gte-slot=148277128`
`lt-slot`	このスロット前のトランザクション	`&lt-slot=148277128`
`lte-slot`	このスロット以前のトランザクション	`&lte-slot=148277128`

フィルタリングの注意:

時間パラメーターはUnixタイムスタンプ（エポック以降の秒数）を使用し、スロットパラメーターはSolanaスロット番号を使用します。
同一リクエストで時間ベースとスロットベースのフィルタを組み合わせることはできません。
昇順には[sort-order=asc]、降順には[sort-order=desc]を使用します。
おおよその期間を知っているときは時間またはスロットフィルタを使用し、[limit]と組み合わせてページサイズを制御します。

フィルター

トランザクションタイプでフィルター

NFT販売、トークン転送、スワップなど、特定の取引タイプのみを取得します。

NFT販売
トークン転送
スワップ

const fetchNftSales = async () => {
  const tokenAddress = "GjUG1BATg5V4bdAr1csKys1XK9fmrbntgb1iV7rAkn94"; // NFT mint address
  const url = `https://mainnet.helius-rpc.com/v0/addresses/${tokenAddress}/transactions?api-key=YOUR_API_KEY&type=NFT_SALE`;

  const response = await fetch(url);
  const nftSales = await response.json();
  console.log("NFT sale transactions:", nftSales);
};

const fetchTokenTransfers = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K"; // Wallet address
  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&type=TRANSFER`;

  const response = await fetch(url);
  const transfers = await response.json();
  console.log("Transfer transactions:", transfers);
};

const fetchSwapTransactions = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K"; // Wallet address
  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&type=SWAP`;

  const response = await fetch(url);
  const swaps = await response.json();
  console.log("Swap transactions:", swaps);
};

サポートされている取引タイプの完全なリストについては、Transaction History APIリファレンスを参照してください。

ランタイムタイプフィルタリング

タイプフィルタリングはランタイムで行われます：APIは順にトランザクションを検索し、少なくとも50件のマッチングアイテムを見つけるまで続けます。検索ウィンドウ内で一致が見つからない場合、検索を続けるためのシグネチャを伴うエラーを返します。これは期待される動作であり、失敗ではありません。

現在の検索ウィンドウ内で一致するトランザクションが見つからない場合、APIは次のようなエラーレスポンスを返します。

{
  "error": "Failed to find events within the search period. To continue search, query the API again with the `before-signature` parameter set to 2UKbsu95YzxGjUGYRg2znozmmVADVgmnhHqzDxq8Xfb3V5bf2NHUkaXGPrUpQnRFVHVKbawdQXtm4xJt9njMDHvg."
}

続行するには、エラーメッセージからのシグネチャを使用し、次回のリクエストで適切なパラメータ（降順には[before-signature]、昇順には[after-signature]）を使用してください。

タイプフィルターの継続ループ（完全な例）

const fetchFilteredTransactions = async (sortOrder = 'desc') => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";
  const transactionType = "NFT_SALE";
  let continuationSignature = null;
  let allFilteredTransactions = [];
  let maxRetries = 10; // Prevent infinite loops
  let retryCount = 0;

  // Determine which parameter to use based on sort order
  const continuationParam = sortOrder === 'asc' ? 'after-signature' : 'before-signature';

  while (retryCount < maxRetries) {
    // Build URL with optional continuation parameter
    let url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&type=${transactionType}&sort-order=${sortOrder}`;

    if (continuationSignature) {
      url += `&${continuationParam}=${continuationSignature}`;
    }

    try {
      const response = await fetch(url);
      const data = await response.json();

      // Check if we received an error about search period
      if (data.error && data.error.includes("Failed to find events within the search period")) {
        // Extract the signature from the error message
        const signatureMatch = data.error.match(/parameter set to ([A-Za-z0-9]+)/);

        if (signatureMatch && signatureMatch[1]) {
          console.log(`No results in this period. Continuing search from: ${signatureMatch[1]}`);
          continuationSignature = signatureMatch[1];
          retryCount++;
          continue; // Continue searching with new signature
        } else {
          console.log("No more transactions to search");
          break;
        }
      }

      // Check if we received transactions
      if (Array.isArray(data) && data.length > 0) {
        console.log(`Found ${data.length} ${transactionType} transactions`);
        allFilteredTransactions = [...allFilteredTransactions, ...data];

        // Set continuation signature for next page
        continuationSignature = data[data.length - 1].signature;
        retryCount = 0; // Reset retry count since we found results
      } else {
        console.log("No more transactions found");
        break;
      }

    } catch (error) {
      console.error("Error fetching transactions:", error);
      break;
    }
  }

  console.log(`Total ${transactionType} transactions found: ${allFilteredTransactions.length}`);
  return allFilteredTransactions;
};

// Usage examples:
// Descending order (newest first) - uses 'before-signature' parameter
fetchFilteredTransactions('desc');

// Ascending order (oldest first) - uses 'after-signature' parameter
fetchFilteredTransactions('asc');

キーとなるポイント：

タイプフィルタを使用すると、APIは一度に最大50件のトランザクションを検索します。
一致が見つからなかった場合、次回の検索を続行するためにエラーメッセージからのシグネチャを使用します。
降順で検索する場合は[before-signature]を使用します（デフォルト、新しい順）。
昇順で検索する場合は[after-signature]を使用します（古い順）—年代順の検索には必須です。
無限ループを防ぐために最大リトライ制限を実装します。

例

以下のシナリオは、時間とスロットの範囲、ソート順序、ATA、および複合フィルターをカバーします。

時間範囲でフィルタ

特定の時間ウィンドウ内のトランザクションを取得します。

過去24時間
特定の日付範囲

const fetchRecentTransactions = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";
  const now = Math.floor(Date.now() / 1000);
  const oneDayAgo = now - (24 * 60 * 60);

  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&gte-time=${oneDayAgo}&lte-time=${now}`;

  const response = await fetch(url);
  const transactions = await response.json();
  console.log("Transactions from last 24 hours:", transactions);
};

const fetchTransactionsByDateRange = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";

  // January 1, 2024 to January 31, 2024
  const startTime = Math.floor(new Date('2024-01-01').getTime() / 1000);
  const endTime = Math.floor(new Date('2024-01-31').getTime() / 1000);

  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&gte-time=${startTime}&lte-time=${endTime}`;

  const response = await fetch(url);
  const transactions = await response.json();
  console.log("Transactions in January 2024:", transactions);
};

スロット範囲でフィルタ

特定のスロット範囲内のトランザクションを取得します。

const fetchTransactionsBySlotRange = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";
  const startSlot = 148000000;
  const endSlot = 148100000;

  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&gte-slot=${startSlot}&lte-slot=${endSlot}`;

  const response = await fetch(url);
  const transactions = await response.json();
  console.log(`Transactions between slots ${startSlot} and ${endSlot}:`, transactions);
};

ソート順序を変更

昇順（古い順）でトランザクションを取得します。

const fetchOldestTransactions = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";
  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&sort-order=asc&limit=10`;

  const response = await fetch(url);
  const transactions = await response.json();
  console.log("10 oldest transactions:", transactions);
};

関連トークンアカウントの転送を含む

関連トークンアドレス（ATA）を含むウォレットの完全な履歴をクエリします。

const fetchTransactionsWithATA = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";

  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&token-accounts=balanceChanged&sort-order=desc&limit=50`;

  const response = await fetch(url);
  const transactions = await response.json();
  console.log("Most recent transactions (including ATA transfers)", transactions);
};

複数のフィルタを組み合わせる

時間範囲とカスタムソート順序でタイプフィルタリングを組み合わせます。

const fetchFilteredTransactionsAdvanced = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";

  // Get NFT sales from the last 7 days, oldest first
  const now = Math.floor(Date.now() / 1000);
  const sevenDaysAgo = now - (7 * 24 * 60 * 60);

  const url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&type=NFT_SALE&gte-time=${sevenDaysAgo}&sort-order=asc&limit=50`;

  const response = await fetch(url);
  const transactions = await response.json();
  console.log("NFT sales from last 7 days (oldest first):", transactions);
};

ページネーション

高ボリュームのアドレスでは、各バッチの最後のシグネチャをカーソルとして使用して結果をページングします。

const fetchAllTransactions = async () => {
  const walletAddress = "2k5AXX4guW9XwRQ1AKCpAuUqgWDpQpwFfpVFh3hnm2Ha"; // Replace with target wallet
  const baseUrl = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY`;
  let url = baseUrl;
  let lastSignature = null;
  let allTransactions = [];

  while (true) {
    if (lastSignature) {
      url = baseUrl + `&before-signature=${lastSignature}`;
    }

    const response = await fetch(url);

    // Check response status
    if (!response.ok) {
      console.error(`API error: ${response.status}`);
      break;
    }

    const transactions = await response.json();

    if (transactions && transactions.length > 0) {
      console.log(`Fetched batch of ${transactions.length} transactions`);
      allTransactions = [...allTransactions, ...transactions];
      lastSignature = transactions[transactions.length - 1].signature;
    } else {
      console.log(`Finished! Total transactions: ${allTransactions.length}`);
      break;
    }
  }

  return allTransactions;
};

時間範囲内でページネーションを行うには、各リクエストで時間フィルタを維持し、各ループで[before-signature]カーソルを進めます。

const fetchAllTransactionsInTimeRange = async () => {
  const walletAddress = "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K";
  const startTime = Math.floor(new Date('2024-01-01').getTime() / 1000);
  const endTime = Math.floor(new Date('2024-01-31').getTime() / 1000);

  let beforeSignature = null;
  let allTransactions = [];

  while (true) {
    let url = `https://mainnet.helius-rpc.com/v0/addresses/${walletAddress}/transactions?api-key=YOUR_API_KEY&gte-time=${startTime}&lte-time=${endTime}&limit=100`;

    if (beforeSignature) {
      url += `&before-signature=${beforeSignature}`;
    }

    const response = await fetch(url);
    const transactions = await response.json();

    if (!Array.isArray(transactions) || transactions.length === 0) {
      break;
    }

    allTransactions = [...allTransactions, ...transactions];
    beforeSignature = transactions[transactions.length - 1].signature;

    console.log(`Fetched ${transactions.length} transactions, total: ${allTransactions.length}`);
  }

  console.log(`Total transactions in time range: ${allTransactions.length}`);
  return allTransactions;
};

次のステップ

getTransactionsForAddress

トランザクション履歴とバックフィルのモダンなHeliusネイティブ代替品。

Wallet API

RESTエンドポイントで人が読みやすいウォレットデータを提供：残高、履歴、転送。

Parse Transactions

1つ以上の取引シグネチャを解析して人が読みやすいデータに変換します。

Getting Data overview

SolanaデータをクエリするためのHeliusオプションすべてを比較。

はじめに

データストリーミングとイベントリスニング

データ API & RPC

トレーディング

トランザクションの送信

ウォレット・アズ・ア・サービス

ガイド

リソース

概要

使用タイミング

クイックスタート

ネットワークサポート

リクエストパラメータ

時間に基づくフィルタリング

スロットに基づくフィルタリング

関連トークンアカウント

フィルター

トランザクションタイプでフィルター

ランタイムタイプフィルタリング

例

ページネーション

次のステップ

getTransactionsForAddress

Wallet API

Parse Transactions

Getting Data overview

​概要

​使用タイミング

​クイックスタート

​ネットワークサポート

​リクエストパラメータ

​時間に基づくフィルタリング

​スロットに基づくフィルタリング

​関連トークンアカウント

​フィルター

​トランザクションタイプでフィルター

​ランタイムタイプフィルタリング

​例

​ページネーション

​次のステップ

getTransactionsForAddress

Wallet API

Parse Transactions

Getting Data overview

概要

使用タイミング

クイックスタート

ネットワークサポート

リクエストパラメータ

時間に基づくフィルタリング

スロットに基づくフィルタリング

関連トークンアカウント

フィルター

トランザクションタイプでフィルター

ランタイムタイプフィルタリング

例

ページネーション

次のステップ