xcaDocs
Endpoint

Dompet

Profil trading 30 hari sebuah dompet: PnL, win rate, durasi hold, dan sumber dana.

GET/api/v1/wallets/{address}

Mengembalikan profil yang dibuat XCA untuk sebuah dompet. Profil dompet dibuat saat pemindaian token (untuk holder terbesar) dan saat diminta di aplikasi; dompet yang belum pernah dibuatkan profil mengembalikan 404.

Parameter#

addresspathwajib
Alamat dompet.string

Permintaan#

curl -s "https://app.xca.fun/api/v1/wallets/HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH" \
  -H "Authorization: Bearer $XCA_API_KEY"
Coba langsung
Tempel kunci API-mu untuk mengirim permintaan sungguhan.

Respons#

address
Alamat dompet.string
isSmart
Dompet ini lolos ambang batas smart money.boolean
pnl30dUsd
PnL 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
trades30d
Jumlah trade selama 30 hari.number | null
avgHoldSec
Rata-rata durasi hold, dalam detik.number | null
walletAgeDays
Jumlah hari sejak transaksi pertama.number | null
fundedBy
Dompet yang pertama kali mendanai dompet ini.string | null
lastProfiledAt
Waktu profil dibuat.string

Contoh respons#

{
  "address": "HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH",
  "isSmart": true,
  "pnl30dUsd": 48210.7,
  "pnl30dPct": 31.4,
  "winRate": 0.64,
  "trades30d": 37,
  "avgHoldSec": 1209600,
  "walletAgeDays": 412,
  "fundedBy": "FWznbcNXWQuHTawe9RxvQ2LdCENssh12dsznf4RiouN5",
  "lastProfiledAt": "2026-10-02T08:40:11.000Z"
}

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.

Perlu diketahui#

  • pnl30dPct dan avgHoldSec memerlukan PnL detail di paketmu, sedangkan fundedBy memerlukan fitur klaster; jika tidak, nilainya null.
  • isSmart menandai dompet yang lolos ambang batas smart money: profit selama 30 hari, win rate tinggi, dan jumlah trade yang cukup.