Endpoint

Holder

Daftar holder token yang sudah dipindai beserta kelasnya, PnL, waktu entry, dan sumber dana, per halaman.

GET/api/v1/tokens/{chain}/{address}/holders

Mengembalikan holder hasil analisis sebuah token, diurutkan berdasarkan peringkat, beserta kelas yang ditetapkan XCA untuk setiap dompet. Token harus sudah dipindai; jika belum, kamu akan mendapat 404.

Parameter#

chainpathwajib

ID chain. Untuk saat ini hanya solana."solana"

addresspathwajib

Alamat mint token.string

pagequery

Nomor halaman, dimulai dari 1.integer ≥ 1bawaan: 1

pageSizequery

Jumlah holder per halaman.10 | 25 | 50 | 100bawaan: 100

classquery

Hanya kembalikan holder dengan kelas ini.ALL | HolderClassbawaan: ALL

Permintaan#

curl -s "https://app.xca.fun/api/v1/tokens/solana/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/holders?class=SMART_MONEY&pageSize=25" \
  -H "Authorization: Bearer $XCA_API_KEY"

Coba langsung

Kunci APIDapatkan kunci APIHanya disimpan di tab browser ini dan hanya dikirim ke API XCA.

chainpathaddresspathpagequerypageSizequeryclassquery

Tempel kunci API-mu untuk mengirim permintaan sungguhan.

Respons#

rows

Holder di halaman ini.HolderRow[]

rank

Posisi berdasarkan saldo, 1 adalah yang terbesar.number

address

Alamat dompet.string | null

sharePct

Porsi suplai yang dipegang.number

valueUsd

Nilai kepemilikan, dalam USD.number | null

class

Kelas yang ditetapkan XCA untuk dompet ini.HolderClass | "HIDDEN"

flags

Ciri tambahan dompet.string[]

entryAt

Waktu pembelian pertama.string | null

entryBlock

Jumlah blok antara peluncuran dan pembelian pertama (sniper punya angka kecil).number | null

pnl30dUsd

PnL realized dan unrealized selama 30 hari, dalam USD.number | null

pnl30dPct

PnL selama 30 hari, dalam persen.number | null

winRate

Porsi trade yang menghasilkan profit, dari 0 sampai 1.number | null

avgHoldSec

Rata-rata durasi hold, dalam detik.number | null

trades30d

Jumlah trade selama 30 hari.number | null

fundedBy

Dompet yang pertama kali mendanai dompet ini.string | null

clusterId

Klaster tempat dompet ini berada.string | null

profiled

Profil dompet lengkap tersedia.boolean

total

Jumlah holder terlihat yang cocok dengan filter.number

lockedCount

Jumlah holder yang disembunyikan oleh batas paketmu.number

page

Halaman saat ini.number

pageSize

Jumlah holder per halaman.number

visibleLimit

Jumlah top holder yang ditampilkan paketmu; -1 berarti semua.number

Contoh respons#

{
  "rows": [
    {
      "rank": 4,
      "address": "5Hr7wZg7oBpVhH5nngRqzr5W7ZFUfCsfEhbziZJak7fr",
      "sharePct": 1.92,
      "valueUsd": 3641200,
      "class": "SMART_MONEY",
      "flags": [
        "smart"
      ],
      "entryAt": "2023-01-04T18:22:10.000Z",
      "entryBlock": null,
      "pnl30dUsd": 48210.7,
      "pnl30dPct": 31.4,
      "winRate": 0.64,
      "avgHoldSec": 1209600,
      "trades30d": 37,
      "fundedBy": "FWznbcNXWQuHTawe9RxvQ2LdCENssh12dsznf4RiouN5",
      "clusterId": null,
      "profiled": true
    }
  ],
  "total": 7,
  "lockedCount": 0,
  "page": 1,
  "pageSize": 25,
  "visibleLimit": -1
}

Kode status#

200Berhasil

400validation — Ada parameter atau body yang tidak valid; lihat error.issues.

401unauthorized — Kunci API tidak disertakan, salah format, atau sudah dicabut.

402planRequired — Paketmu tidak menyertakan akses API atau fitur ini.

404notFound — Token belum dipindai atau dompet belum dibuatkan profil.

429rateLimited — Terlalu banyak permintaan per menit, atau kuota bulanan sudah habis.

Kelas holder#

`SMART_MONEY`	Trader yang profit selama 30 hari dengan win rate tinggi.
`REGULAR`	Tidak ada yang menonjol.
`DEV`	Pembuat token.
`DEV_BUNDLE`	Membeli bersamaan dengan pembuat token atau didanai oleh pembuat token.
`SNIPER`	Membeli di beberapa blok pertama setelah peluncuran.
`FRESH`	Dompet yang baru saja dibuat.
`POOL`	Pool likuiditas, vault, atau bonding curve.
`CEX`	Dompet milik exchange terpusat.
`BURN`	Alamat burn.

Perlu diketahui#

Paketmu membatasi jumlah top holder yang terlihat; total hanya menghitung holder yang terlihat, sedangkan lockedCount menunjukkan berapa banyak lagi yang tersembunyi.
Filter berdasarkan SNIPER, DEV_BUNDLE, SMART_MONEY, atau FRESH memerlukan fitur yang sesuai di paketmu; jika tidak ada, kamu akan mendapat 402.
Kelas yang tidak bisa dilihat dengan paketmu dikembalikan sebagai HIDDEN.
Field PnL bergantung pada level PnL paketmu: level dasar memberikan pnl30dUsd dan winRate, level detail menambahkan pnl30dPct, avgHoldSec, dan trades30d.