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 mengembalikan403 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:- JavaScript
- Python
- cURL
Format respons
Respons yang berhasil menjelaskan transfer SOL masuk pertama ke dompet: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 adalahnull.funderType: kategori penyandang dana (misalnya,exchange,defi-protocol); nilainya adalahnulljika tidak ada dalam basis data identitas.mint: alamat mint token (So11111111111111111111111111111111111111111untuk SOL).symbol: simbol token (selaluSOLuntuk transaksi pendanaan).amount: jumlah awal SOL yang diterima (mudah dibaca, misalnya0.05SOL).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
BidangfunderType menunjukkan kategori dompet yang mendanai alamat tersebut. Semua nilai dari Kategori Identitas didukung.
Supported funder types
Supported funder types
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
funderNamedanfunderType, tetapi Anda dapat memanggil endpoint Identity pada alamatfunderuntuk 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.
timestampmenunjukkan 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.