Cara Mendapatkan Semua Transfer Dompet Solana

Wallet API masih dalam tahap Beta. Endpoint dan format respons dapat berubah.

Ikhtisar

Endpoint Token Transfers mengambil semua aktivitas transfer token untuk dompet Solana, termasuk informasi terperinci tentang pengirim dan penerima. Tidak seperti riwayat transaksi lengkap, endpoint ini berfokus secara khusus pada transfer sehingga ideal untuk melacak pembayaran dan memantau transfer. Endpoint mengembalikan hingga 100 transfer per permintaan (default 50). Gunakan parameter cursor dengan pagination.nextCursor untuk mengambil halaman berikutnya, dan baca pagination.hasMore untuk mengetahui apakah hasil lainnya tersedia.

Kapan menggunakannya

Gunakan Token Transfers API saat Anda perlu:

Melacak pembayaran: pantau pembayaran masuk untuk pemroses pembayaran.
Membuat feed transfer: tampilkan feed aktivitas “dikirim/diterima” yang sederhana.
Memantau token tertentu: lacak transfer token tertentu (misalnya, pembayaran USDC).
Mengidentifikasi pihak lawan transaksi: lihat siapa yang mengirim atau menerima token.
Membuat tanda terima: buat tanda terima pembayaran dengan detail pengirim/penerima.
Mendeteksi aktivitas mencurigakan: pantau pola transfer yang tidak biasa.

Panduan memulai cepat

Kueri transfer dasar

Dapatkan transfer masuk dan keluar terbaru:

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"

Filter berdasarkan arah

Filter hasil di sisi klien untuk hanya mendapatkan transfer masuk atau keluar:

Incoming Only
Outgoing Only

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;
};

Parameter kueri

Parameter	Tipe	Default	Deskripsi
`limit`	bilangan bulat	50	Jumlah maksimum transfer yang dikembalikan (1-100)
`cursor`	string	-	Kursor paginasi dari respons sebelumnya

Format respons

{
  "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"
  }
}

Catatan kolom

direction: relatif terhadap dompet yang Anda kueri. in adalah token yang diterima (pembayaran masuk); out adalah token yang dikirim (pembayaran keluar).
counterparty: untuk transfer in, merupakan pengirim; untuk transfer out, merupakan penerima.
amount: jumlah transfer yang mudah dibaca manusia dan sudah dibagi dengan decimals. Gunakan nilai ini untuk tampilan (misalnya, 1.5 SOL, 100.0 USDC).
amountRaw: jumlah yang sama dalam bentuk string bilangan bulat mentah sebelum penyesuaian desimal (misalnya, "1500000000" untuk 1,5 SOL). Diserialisasi sebagai string untuk menghindari hilangnya presisi bilangan floating-point. Gunakan nilai ini untuk instruksi on-chain atau aritmetika presisi: amount = parseInt(amountRaw) / 10**decimals.
mint: alamat mint token (So11111111111111111111111111111111111111111 untuk SOL native).
symbol: simbol token. Tidak semua token memilikinya; gunakan alamat mint sebagai alternatif jika symbol bernilai null.

Kasus penggunaan

Melacak riwayat pembayaran untuk pedagang

Pantau pembayaran USDC yang masuk:

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
  };
};

Membuat tanda terima pembayaran

Buat tanda terima terperinci untuk transfer tertentu:

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;
};

Memantau pola transfer yang mencurigakan

Deteksi aktivitas transfer yang tidak biasa:

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
  };
};

Membuat feed aktivitas transfer

Buat feed aktivitas yang mudah digunakan:

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`;
}

Merekonsiliasi pembayaran

Cocokkan transfer dengan pembayaran yang diharapkan:

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);

Paginasi

Untuk dompet dengan banyak transfer, telusuri hasil per halaman menggunakan parameter cursor dan 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;
};

Praktik terbaik

Filter token tertentu di sisi klien. API mengembalikan semua transfer token. Filter berdasarkan alamat mint untuk melacak token tertentu seperti USDC atau SOL.
Gabungkan dengan Identity API. Gunakan endpoint Identity untuk menampilkan nama yang mudah dibaca manusia bagi pihak lawan transaksi yang dikenal (bursa, protokol, dan lainnya).
Cache transfer terbaru. Data transfer tidak berubah. Cache hasilnya dan hanya ambil transfer baru sejak kueri terakhir Anda.
Gunakan paginasi untuk riwayat lengkap. Terapkan paginasi untuk menangani dompet dengan ribuan transfer secara efisien.
Tangani simbol yang tidak ada. Tidak semua token memiliki kolom symbol. Gunakan alamat mint sebagai alternatif jika symbol bernilai null.

Transfer dibandingkan dengan riwayat transaksi

Fitur	Transfer	Riwayat Transaksi
Fokus	Hanya transfer token	Semua jenis transaksi
Data	Informasi pengirim/penerima	Perubahan saldo untuk semua token
Kasus penggunaan	Pelacakan pembayaran	Log aktivitas lengkap
Performa	Lebih cepat dan sederhana	Lebih komprehensif

Gunakan Transfers jika Anda hanya perlu menangani pembayaran. Gunakan Transaction History jika Anda memerlukan data perubahan saldo yang lengkap.

Kesalahan umum

Kode Kesalahan	Deskripsi	Solusi
400	Format alamat dompet tidak valid	Pastikan alamat tersebut merupakan alamat Solana base58 yang valid
401	Kunci API tidak ada atau tidak valid	Pastikan kunci API Anda disertakan dalam permintaan
429	Batas laju terlampaui	Kurangi frekuensi permintaan atau tingkatkan paket Anda

Langkah berikutnya

Wallet History

Riwayat transaksi lengkap dengan perubahan saldo per transaksi.

Wallet API Overview

Semua endpoint Wallet API dan konvensi bersama.

API Reference

Skema permintaan dan respons untuk transfer token.

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

Cara Mendapatkan Semua Transfer Dompet Solana

Ikhtisar

Kapan menggunakannya

Panduan memulai cepat

Kueri transfer dasar

Filter berdasarkan arah

Parameter kueri

Format respons

Catatan kolom

Kasus penggunaan

Melacak riwayat pembayaran untuk pedagang

Membuat tanda terima pembayaran

Memantau pola transfer yang mencurigakan

Membuat feed aktivitas transfer

Merekonsiliasi pembayaran

Paginasi

Praktik terbaik

Transfer dibandingkan dengan riwayat transaksi

Kesalahan umum

Langkah berikutnya

Wallet History

Wallet API Overview

API Reference

​Ikhtisar

​Kapan menggunakannya

​Panduan memulai cepat

​Kueri transfer dasar

​Filter berdasarkan arah

​Parameter kueri

​Format respons

​Catatan kolom

​Kasus penggunaan

​Melacak riwayat pembayaran untuk pedagang

​Membuat tanda terima pembayaran

​Memantau pola transfer yang mencurigakan

​Membuat feed aktivitas transfer

​Merekonsiliasi pembayaran

​Paginasi

​Praktik terbaik

​Transfer dibandingkan dengan riwayat transaksi

​Kesalahan umum

​Langkah berikutnya

Wallet History

Wallet API Overview

API Reference

Ikhtisar

Kapan menggunakannya

Panduan memulai cepat

Kueri transfer dasar

Filter berdasarkan arah

Parameter kueri

Format respons

Catatan kolom

Kasus penggunaan

Melacak riwayat pembayaran untuk pedagang

Membuat tanda terima pembayaran

Memantau pola transfer yang mencurigakan

Membuat feed aktivitas transfer

Merekonsiliasi pembayaran

Paginasi

Praktik terbaik

Transfer dibandingkan dengan riwayat transaksi

Kesalahan umum

Langkah berikutnya