Skip to main content
Wallet API masih dalam versi Beta. Endpoint dan format respons dapat berubah.

Ringkasan

Endpoint Wallet Funding Source mengidentifikasi siapa yang pertama kali mendanai dompet Solana dengan menganalisis transfer SOL masuk pertamanya. Endpoint ini berguna untuk atribusi, kepatuhan, memahami hubungan antardompet, dan mengidentifikasi dompet yang didanai oleh bursa. Nama dan kategori penyandang dana berasal dari sistem identitas yang sama dengan yang digunakan oleh endpoint Identity. Jadi, jika penyandang dana merupakan entitas yang dikenal, Anda akan mendapatkan label dan kategori yang mudah dibaca langsung dalam respons. Endpoint ini memerlukan paket berbayar. Permintaan yang dibuat dengan API key paket Free akan mengembalikan 403 Forbidden. Lihat Persyaratan paket untuk tabel cakupan lengkap.

Kapan menggunakannya

Gunakan Wallet Funding Source API untuk:
  • Atribusi dompet: melacak sumber pendanaan dompet baru.
  • Deteksi bursa: mengidentifikasi dompet yang didanai langsung dari bursa tersentralisasi.
  • Kepatuhan dan AML: menandai dompet yang didanai oleh entitas yang dikenal untuk pemeriksaan kepatuhan.
  • Deteksi bot: mengidentifikasi kumpulan bot yang didanai dari sumber yang sama.
  • Analisis airdrop: melacak dompet yang menerima pendanaan awal dari suatu proyek.
  • Deteksi Sybil: menemukan klaster dompet yang didanai oleh alamat yang sama.

Panduan memulai cepat

Pencarian pendanaan dasar

Cari tahu siapa yang mendanai dompet:

Format respons

Respons yang berhasil menjelaskan transfer SOL masuk pertama ke dompet:
Jika dompet belum pernah menerima SOL, API akan mengembalikan 404:

Catatan bidang

  • funder: alamat yang mengirim transfer SOL pertama ke dompet ini.
  • funderName: nama yang mudah dibaca jika penyandang dana merupakan entitas yang dikenal (misalnya, bursa atau protokol); jika tidak, nilainya adalah null.
  • funderType: kategori penyandang dana (misalnya, exchange, defi-protocol); nilainya adalah null jika tidak ada dalam basis data identitas.
  • mint: alamat mint token (So11111111111111111111111111111111111111111 untuk SOL).
  • symbol: simbol token (selalu SOL untuk transaksi pendanaan).
  • amount: jumlah awal SOL yang diterima (mudah dibaca, misalnya 0.05 SOL).
  • amountRaw: jumlah mentah dalam lamport sebagai string (misalnya, "50000000" untuk 0,05 SOL).
  • decimals: jumlah angka di belakang koma untuk token (9 untuk SOL).
  • date: string tanggal berformat ISO 8601 (misalnya, "2024-01-01T00:00:00.000Z").
  • signature: tanda tangan transaksi dari transfer pendanaan.
  • timestamp: stempel waktu Unix (dalam detik) saat dompet didanai.
  • slot: nomor slot Solana saat transaksi pendanaan dikonfirmasi.
  • explorerUrl: tautan langsung untuk melihat transaksi di Orb.

Kasus penggunaan

Mendeteksi dompet yang didanai oleh bursa

Identifikasi dompet yang didanai langsung dari bursa tersentralisasi:

Menemukan klaster dompet (deteksi Sybil)

Identifikasi kelompok dompet yang didanai oleh sumber yang sama:

Melacak penerima airdrop

Analisis asal penerima airdrop:

Membuat linimasa dompet

Buat linimasa yang dimulai sejak dompet dibuat:

Penilaian risiko kepatuhan

Tetapkan skor risiko berdasarkan sumber pendanaan:

Pelacakan atribusi

Lacak sumber yang membuat dompet baru paling banyak:

Jenis penyandang dana

Bidang funderType menunjukkan kategori dompet yang mendanai alamat tersebut. Semua nilai dari Kategori Identitas didukung.
Jenis penyandang dana yang umum:Daftar lengkap mencakup: Airdrop, Authority, Cross-chain Bridge, Casino & Gambling, DAO, DeFi, DePIN, Centralized Exchange, Exploiter/Hackers/Scams, Fees, Fundraise, Game, Genesis Block Distribution, Governance, Hacker, Jito, Key Opinion Leader, Market Maker, Memecoin, Multisig, NFT, Non-Circulating Supply, Oracle, Other, Payments, Proprietary AMM, Restaking, Rugger, Scammer, Spam, Stake Pool, System, Tools, Trading App/Bot, Trading Firm, Transaction Sending, Treasury, Validator, Vault, dan X402.Lihat bagian Kategori Identitas untuk daftar lengkap beserta deskripsinya.

Praktik terbaik

  • Tangani respons 404. Dompet yang belum pernah menerima SOL akan mengembalikan 404. Hal ini wajar untuk dompet yang baru dibuat tetapi belum didanai.
  • Gabungkan dengan Identity API. Respons mencakup funderName dan funderType, tetapi Anda dapat memanggil endpoint Identity pada alamat funder untuk mendapatkan informasi lebih terperinci.
  • Simpan data pendanaan dalam cache. Sumber pendanaan dompet tidak pernah berubah. Simpan data ini secara permanen dalam cache untuk menghindari pemanggilan API berulang.
  • Periksa usia untuk mendapatkan konteks. timestamp menunjukkan waktu dompet pertama kali didanai. Gabungkan usia dengan sumber pendanaan untuk mendapatkan konteks yang lebih baik.

Kesalahan umum

Batasan

  • Endpoint ini hanya melacak transfer SOL pertama ke suatu dompet.
  • Jika dompet dibuat melalui airdrop atau inisialisasi program tanpa transfer SOL, dompet tersebut tidak akan memiliki data pendanaan.
  • Sumber pendanaan menunjukkan penyandang dana langsung, bukan selalu sumber dana utama.
  • Data historis hanya tersedia untuk dompet yang dibuat setelah fitur ini diterapkan.

Langkah berikutnya

Wallet Identity

Uraikan alamat penyandang dana menjadi label, kategori, dan tag lengkap.

Wallet API Overview

Semua endpoint Wallet API dan konvensi bersama.

API Reference

Skema permintaan dan respons untuk pencarian sumber pendanaan.