Endpoint

Pemindaian

Mulai pemindaian token atau perbarui laporan yang sudah kedaluwarsa.

POST/api/v1/scans

Memasukkan analisis lengkap sebuah token ke antrean dan mengembalikan statusnya saat ini. Panggilan ini aman untuk diulang: tidak akan memulai pemindaian kedua selama masih ada yang berjalan.

Parameter#

chainbody

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

addressbodywajib

Alamat mint token yang akan dipindai.string

Permintaan#

curl -s -X POST "https://app.xca.fun/api/v1/scans" \
  -H "Authorization: Bearer $XCA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"solana","address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}'

Coba langsung

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

chainbodyaddressbody

Tempel kunci API-mu untuk mengirim permintaan sungguhan.

Respons#

status

Status pemindaian."NONE" | "QUEUED" | "RUNNING" | "DONE" | "ERROR"

depth

Kedalaman laporan yang dihasilkan atau diperbarui oleh pemindaian."LIGHT" | "FULL" | null

step

Tahap pemindaian saat ini.string | null

progress

Progres dari 0 sampai 100.number

stale

Umur laporan yang ada sudah melewati masa berlaku cache.boolean

upgrading

Laporan LIGHT sedang di-upgrade menjadi FULL.boolean

limitReached

Batas pemindaian harianmu sudah habis; yang dikembalikan adalah status laporan lama.boolean

Contoh respons#

{
  "status": "QUEUED",
  "depth": null,
  "step": "queued",
  "progress": 0,
  "stale": false,
  "upgrading": false,
  "limitReached": false
}

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.

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

503unavailable — Sedang dalam pemeliharaan atau penyedia data kehabisan kapasitas.

Cara kerjanya#

Laporan masih berlaku: langsung mengembalikan DONE dan tidak memakai batas pemindaianmu.
Pemindaian sedang berjalan: mengembalikan QUEUED atau RUNNING beserta step dan progress.
Selain itu: memasukkan pemindaian baru ke antrean dan memakai satu jatah dari batas harianmu.
Batas harian sudah tercapai tetapi ada laporan lama: mengembalikan status laporan tersebut dengan limitReached bernilai true.

Menunggu hasil#

Lakukan polling GET /tokens/{chain}/{address} setiap 3–5 detik sampai statusnya DONE atau ERROR. Sebagian besar pemindaian selesai dalam satu menit.

Pindai token lalu tungguMulai pemindaian, lakukan polling secukupnya, lalu ambil laporan yang sudah jadi.

Tahapan pemindaian#

`queued`	Menunggu di antrean.
`market`	Mengambil data harga, likuiditas, dan mint.
`holders`	Membaca daftar holder.
`trades`	Membaca trade paling awal untuk menemukan sniper.
`profiles`	Membuat profil holder terbesar: sumber dana, usia dompet, PnL.
`classify`	Menetapkan kelas dan menyusun klaster.
`dev`	Memeriksa peluncuran sebelumnya dari pembuat token.
`save`	Menghitung Holder Score dan menyimpan hasilnya.
`done`	Selesai.
`error`	Gagal.

Saat XCA sedang dalam pemeliharaan atau penyedia datanya kehabisan kapasitas, pemindaian mengembalikan 503 unavailable. Coba lagi nanti.