Solanaウォレットのすべての転送を取得する方法

ウォレットAPIはベータ版です。エンドポイントとレスポンス形式は変更される可能性があります。

概要

トークン転送エンドポイントは、Solanaウォレットのすべてのトークン転送アクティビティを取得し、送信者と受信者の詳細情報を含みます。完全なトランザクション履歴とは異なり、このエンドポイントは転送に特化しているため、支払い追跡や転送監視に最適です。このエンドポイントは1リクエストあたり最大100件の転送を返します（デフォルトは50件）。cursorパラメータを使用し、次のページを取得し、さらに結果があるかどうかを確認するにはpagination.hasMoreを参照してください。

使用例

トークン転送APIを使用する必要がある状況:

支払いの追跡: 支払い処理業者のために入金を監視します。
転送フィードの構築: 簡単な「送信/受信」アクティビティフィードを表示します。
特定のトークンを監視: 特定のトークン（例: USDC支払い）の転送を追跡します。
相手方を特定: 誰がトークンを送信または受信したかを確認します。
領収書の生成: 送信者/受信者の詳細を含む領収書を作成します。
不審な活動を検出: 異常な転送パターンを監視します。

クイックスタート

基本的な転送クエリ

最近の入出金転送を取得:

JavaScript
Python
cURL

const getWalletTransfers = async (address) => {
  const url = `https://api.helius.xyz/v1/wallet/${address}/transfers?api-key=YOUR_API_KEY`;

  const response = await fetch(url);
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const data = await response.json();

  console.log(`Found ${data.data.length} transfers`);

  // Display recent transfers
  data.data.forEach(transfer => {
    const date = new Date(transfer.timestamp * 1000).toLocaleString();
    const direction = transfer.direction === 'in' ? 'Received' : 'Sent';
    const counterparty = transfer.counterparty.slice(0, 8) + '...';

    console.log(`\n${direction} - ${date}`);
    console.log(`Amount: ${transfer.amount} ${transfer.symbol || transfer.mint.slice(0, 8) + '...'}`);
    console.log(`${transfer.direction === 'in' ? 'From' : 'To'}: ${counterparty}`);
    console.log(`Signature: ${transfer.signature.slice(0, 20)}...`);
  });

  return data;
};

getWalletTransfers("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");

import requests
from datetime import datetime

def get_wallet_transfers(address: str):
    url = f"https://api.helius.xyz/v1/wallet/{address}/transfers"
    headers = {"X-Api-Key": "YOUR_API_KEY"}

    response = requests.get(url, headers=headers)
    response.raise_for_status()

    data = response.json()

    print(f"Found {len(data['data'])} transfers")

    # Display recent transfers
    for transfer in data['data']:
        date = datetime.fromtimestamp(transfer['timestamp']).strftime('%Y-%m-%d %H:%M:%S')
        direction = 'Received' if transfer['direction'] == 'in' else 'Sent'
        counterparty = transfer['counterparty'][:8] + '...'
        symbol = transfer.get('symbol') or transfer['mint'][:8] + '...'

        print(f"\n{direction} - {date}")
        print(f"Amount: {transfer['amount']} {symbol}")
        print(f"{'From' if transfer['direction'] == 'in' else 'To'}: {counterparty}")
        print(f"Signature: {transfer['signature'][:20]}...")

    return data

get_wallet_transfers("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY")

curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/transfers?api-key=YOUR_API_KEY"

方向別にフィルタ

クライアントサイドで結果をフィルタリングし、入金または出金転送のみ取得:

入金のみ
出金のみ

const getIncomingTransfers = async (address) => {
  const data = await getWalletTransfers(address);

  const incoming = data.data.filter(t => t.direction === 'in');

  console.log(`Received ${incoming.length} incoming transfers`);

  incoming.forEach(transfer => {
    console.log(`Received ${transfer.amount} ${transfer.symbol} from ${transfer.counterparty.slice(0, 8)}...`);
  });

  return incoming;
};

const getOutgoingTransfers = async (address) => {
  const data = await getWalletTransfers(address);

  const outgoing = data.data.filter(t => t.direction === 'out');

  console.log(`Made ${outgoing.length} outgoing transfers`);

  outgoing.forEach(transfer => {
    console.log(`Sent ${transfer.amount} ${transfer.symbol} to ${transfer.counterparty.slice(0, 8)}...`);
  });

  return outgoing;
};

クエリパラメータ

パラメータ	タイプ	デフォルト	説明
`limit`	integer	50	返される最大転送数 (1-100)
`cursor`	string	-	前回のレスポンスからのページネーションクリューザー

レスポンス形式

{
  "data": [
    {
      "signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
      "timestamp": 1704067200,
      "direction": "in",
      "counterparty": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
      "mint": "So11111111111111111111111111111111111111111",
      "symbol": "SOL",
      "amount": 1.5,
      "amountRaw": "1500000000",
      "decimals": 9
    },
    {
      "signature": "4aHu2qwD8Jtj4xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
      "timestamp": 1704067100,
      "direction": "out",
      "counterparty": "2ojv9BAiHUrvsm9gxDe7fJSzbNZSJcxZvf8dqmWGHG8S",
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "amount": 100.0,
      "amountRaw": "100000000",
      "decimals": 6
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
  }
}

フィールドノート

direction: クエリしているウォレットに対して相対的です。inはトークンが受信された（入金）ものです；outはトークンが送信された（出金）ものです。
counterparty: in転送の場合は送信者；out転送の場合は受信者です。
amount: 人間が読める転送額です。既にdecimalsで割られています。表示用にこれを使用します（例:1.5 SOL, 100.0 USDC）。
amountRaw: 調整前の生の整数文字列として同じ金額です（例: 1.5 SOLの場合、"1500000000"）。浮動小数点の精度損失を避けるために文字列としてシリアライズされています。オンチェーンの指示や正確な算術のためにこれを使用します: amount = parseInt(amountRaw) / 10**decimals。
mint: トークンミントアドレス（ネイティブSOLの場合、So11111111111111111111111111111111111111111）。
symbol: トークンシンボル。すべてのトークンにあるわけではありません；symbolがnullの場合はミントアドレスにフォールバックします。

使用ケース

マーチャントの支払い履歴を追跡

USDCの入金を監視:

const trackMerchantPayments = async (merchantWallet) => {
  const data = await getWalletTransfers(merchantWallet);

  // Filter for incoming USDC transfers
  const usdcPayments = data.data.filter(t =>
    t.direction === 'in' &&
    t.mint === 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // USDC
  );

  console.log(`Received ${usdcPayments.length} USDC payments`);

  const totalReceived = usdcPayments.reduce((sum, t) => sum + t.amount, 0);
  console.log(`Total USDC Received: $${totalReceived.toFixed(2)}`);

  // Display each payment
  usdcPayments.forEach(payment => {
    const date = new Date(payment.timestamp * 1000).toLocaleString();
    console.log(`${date}: $${payment.amount} from ${payment.counterparty}`);
  });

  return {
    count: usdcPayments.length,
    total: totalReceived,
    payments: usdcPayments
  };
};

支払い領収書を生成

特定の転送について詳細な領収書を作成:

const generatePaymentReceipt = async (address, signature) => {
  const data = await getWalletTransfers(address);

  const transfer = data.data.find(t => t.signature === signature);

  if (!transfer) {
    console.log('Transfer not found');
    return null;
  }

  const receipt = {
    receiptId: transfer.signature.slice(0, 16),
    date: new Date(transfer.timestamp * 1000).toISOString(),
    type: transfer.direction === 'in' ? 'Payment Received' : 'Payment Sent',
    amount: `${transfer.amount} ${transfer.symbol || 'tokens'}`,
    from: transfer.direction === 'in' ? transfer.counterparty : address,
    to: transfer.direction === 'out' ? transfer.counterparty : address,
    transactionUrl: `https://orbmarkets.io/tx/${transfer.signature}`
  };

  console.log('--- PAYMENT RECEIPT ---');
  Object.entries(receipt).forEach(([key, value]) => {
    console.log(`${key}: ${value}`);
  });

  return receipt;
};

不審な転送パターンを監視

異常な転送活動を検出:

const detectSuspiciousActivity = async (address) => {
  const data = await getWalletTransfers(address);

  const recentTransfers = data.data.filter(t => {
    const hourAgo = Date.now() / 1000 - 3600;
    return t.timestamp > hourAgo;
  });

  // Check for high frequency
  if (recentTransfers.length > 100) {
    console.log(`Warning: ${recentTransfers.length} transfers in the last hour`);
  }

  // Check for large amounts
  const largeTransfers = recentTransfers.filter(t => {
    // Assuming USDC/stablecoins
    return t.amount > 10000 && t.decimals === 6;
  });

  if (largeTransfers.length > 0) {
    console.log(`Warning: ${largeTransfers.length} large transfers (>$10k) in the last hour`);
  }

  // Check for transfers to same address
  const counterparties = recentTransfers.map(t => t.counterparty);
  const duplicates = counterparties.filter((item, index) => counterparties.indexOf(item) !== index);

  if (duplicates.length > 5) {
    console.log(`Warning: Multiple transfers to the same address`);
  }

  return {
    recentCount: recentTransfers.length,
    largeTransfers: largeTransfers.length,
    suspiciousPatterns: duplicates.length > 5
  };
};

転送活動フィードを構築

ユーザーフレンドリーな活動フィードを作成:

const buildTransferFeed = async (address) => {
  const data = await getWalletTransfers(address);

  const feed = data.data.map(transfer => {
    const date = new Date(transfer.timestamp * 1000);
    const timeAgo = getTimeAgo(date);

    return {
      id: transfer.signature,
      direction: transfer.direction,
      title: transfer.direction === 'in' ? 'Received' : 'Sent',
      subtitle: `${transfer.amount} ${transfer.symbol || 'tokens'}`,
      description: transfer.direction === 'in'
        ? `from ${transfer.counterparty.slice(0, 8)}...`
        : `to ${transfer.counterparty.slice(0, 8)}...`,
      timeAgo,
      explorerUrl: `https://orbmarkets.io/tx/${transfer.signature}`
    };
  });

  return feed;
};

function getTimeAgo(date) {
  const seconds = Math.floor((new Date() - date) / 1000);

  if (seconds < 60) return 'Just now';
  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ago`;
  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;
  return `${Math.floor(seconds / 86400)}d ago`;
}

支払いを調整

期待される支払いに対する転送を照合:

const reconcilePayments = async (address, expectedPayments) => {
  const data = await getWalletTransfers(address);

  const recentTransfers = data.data.filter(t =>
    t.direction === 'in' &&
    t.mint === 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // USDC
  );

  const reconciliation = expectedPayments.map(expected => {
    const match = recentTransfers.find(t =>
      Math.abs(t.amount - expected.amount) < 0.01 &&
      t.counterparty === expected.from
    );

    return {
      orderId: expected.orderId,
      expectedAmount: expected.amount,
      status: match ? 'Received' : 'Pending',
      receivedAmount: match?.amount,
      signature: match?.signature,
      timestamp: match?.timestamp
    };
  });

  console.log('Payment Reconciliation:');
  reconciliation.forEach(r => {
    console.log(`Order ${r.orderId}: ${r.status}`);
  });

  return reconciliation;
};

// Example usage
const expected = [
  { orderId: 'ORDER-001', amount: 100.00, from: 'ABC...' },
  { orderId: 'ORDER-002', amount: 250.50, from: 'XYZ...' }
];

reconcilePayments("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY", expected);

ページネーション

転送が多いウォレットの場合、cursorパラメータとpagination.hasMoreで結果をページングします:

const getAllTransfers = async (address) => {
  let allTransfers = [];
  let cursor = null;

  do {
    const url = cursor
      ? `https://api.helius.xyz/v1/wallet/${address}/transfers?api-key=YOUR_API_KEY&cursor=${cursor}`
      : `https://api.helius.xyz/v1/wallet/${address}/transfers?api-key=YOUR_API_KEY`;

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

    allTransfers = allTransfers.concat(data.data);
    cursor = data.pagination.hasMore ? data.pagination.nextCursor : null;

    console.log(`Fetched ${allTransfers.length} transfers so far...`);

  } while (cursor);

  console.log(`\nTotal transfers: ${allTransfers.length}`);
  return allTransfers;
};

ベストプラクティス

特定のトークンのためにクライアントサイドでフィルタリングします。 APIはすべてのトークン転送を返します。特定のトークン（例えばUSDCやSOL）を追跡するためにmintアドレスでフィルタリングします。
Identity APIと組み合わせます。 人間が読める名前を表示するために、Identityエンドポイントを使用します。
最近の転送をキャッシュします。 転送データは変わりません。結果をキャッシュし、最後のクエリ以降に新しい転送のみを取得します。
完全な履歴を取得するためにページネーションします。 転送が数千件あるウォレットを効率的に処理するためにページネーションを実装します。
シンボルがない場合に対応します。 すべてのトークンにsymbolフィールドがあるわけではありません。symbolがnullの場合はミントアドレスにフォールバックします。

転送とトランザクション履歴の違い

特徴	転送	トランザクション履歴
フォーカス	トークン転送のみ	すべてのトランザクションタイプ
データ	送信者/受信者情報	すべてのトークンの残高変化
使用ケース	支払い追跡	完全なアクティビティログ
パフォーマンス	より速く、シンプル	より包括的

支払いのみに関心がある場合は転送を使用してください。完全な残高変化データが必要な場合はトランザクション履歴を使用してください。

よくあるエラー

エラーコード	説明	解決策
400	無効なウォレットアドレス形式	アドレスが有効なbase58 Solanaアドレスであることを確認します
401	APIキーが欠落しているか無効です	リクエストにAPIキーが含まれていることを確認します
429	レートリミットを超えました	リクエストの頻度を減らすか、プランをアップグレードしてください

次のステップ

ウォレット履歴

トランザクションごとの残高変化を含む完全なトランザクション履歴。

ウォレットAPI概要

すべてのウォレットAPIエンドポイントと共通規約。

APIリファレンス

トークン転送のリクエストとレスポンススキーマ。

はじめに

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

データ API & RPC

トレーディング

トランザクションの送信

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

ガイド

リソース

Solanaウォレットのすべての転送を取得する方法

概要

使用例

クイックスタート

基本的な転送クエリ

方向別にフィルタ

クエリパラメータ

レスポンス形式

フィールドノート

使用ケース

マーチャントの支払い履歴を追跡

支払い領収書を生成

不審な転送パターンを監視

転送活動フィードを構築

支払いを調整

ページネーション

ベストプラクティス

転送とトランザクション履歴の違い

よくあるエラー

次のステップ

ウォレット履歴

ウォレットAPI概要

APIリファレンス

​概要

​使用例

​クイックスタート

​基本的な転送クエリ

​方向別にフィルタ

​クエリパラメータ

​レスポンス形式

​フィールドノート

​使用ケース

​マーチャントの支払い履歴を追跡

​支払い領収書を生成

​不審な転送パターンを監視

​転送活動フィードを構築

​支払いを調整

​ページネーション

​ベストプラクティス

​転送とトランザクション履歴の違い

​よくあるエラー

​次のステップ

ウォレット履歴

ウォレットAPI概要

APIリファレンス

概要

使用例

クイックスタート

基本的な転送クエリ

方向別にフィルタ

クエリパラメータ

レスポンス形式

フィールドノート

使用ケース

マーチャントの支払い履歴を追跡

支払い領収書を生成

不審な転送パターンを監視

転送活動フィードを構築

支払いを調整

ページネーション

ベストプラクティス

転送とトランザクション履歴の違い

よくあるエラー

次のステップ