xcaDocs
Endpoint’ler

Cüzdanlar

Bir cüzdanın 30 günlük işlem profili: PnL, kazanma oranı, tutma süresi ve fon kaynağı.

GET/api/v1/wallets/{address}

XCA’nın bir cüzdan için oluşturduğu profili döndürür. Cüzdanların profili token taramaları sırasında (en büyük holder’lar için) ve uygulamada talep üzerine çıkarılır; profili hiç çıkarılmamış bir cüzdan için 404 döner.

Parametreler#

addresspathzorunlu
Cüzdan adresi.string

İstek#

curl -s "https://app.xca.fun/api/v1/wallets/HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH" \
  -H "Authorization: Bearer $XCA_API_KEY"
Dene
Gerçek bir istek göndermek için API anahtarını yapıştır.

Yanıt#

address
Cüzdan adresi.string
isSmart
Cüzdan smart money eşiklerini geçiyor.boolean
pnl30dUsd
30 günlük PnL, USD.number | null
pnl30dPct
30 günlük PnL, yüzde.number | null
winRate
Kârlı işlemlerin oranı, 0 ile 1 arası.number | null
trades30d
30 gündeki işlem sayısı.number | null
avgHoldSec
Ortalama tutma süresi, saniye.number | null
walletAgeDays
İlk işlemden bu yana geçen gün sayısı.number | null
fundedBy
Bu cüzdana ilk fonu gönderen cüzdan.string | null
lastProfiledAt
Profilin oluşturulduğu zaman.string

Örnek yanıt#

{
  "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"
}

Durum kodları#

200Başarılı
400validation — Bir parametre ya da istek gövdesi geçersiz; error.issues alanına bak.
401unauthorized — API anahtarı eksik, hatalı biçimlendirilmiş ya da iptal edilmiş.
402planRequired — Planın API erişimini ya da bu özelliği içermiyor.
404notFound — Token henüz taranmadı ya da cüzdanın profili henüz çıkarılmadı.
429rateLimited — Dakika başına çok fazla istek gönderildi ya da aylık kota doldu.

Bilmekte fayda var#

  • pnl30dPct ve avgHoldSec için planında detaylı PnL, fundedBy için ise kümeler özelliği gerekir; aksi halde bu alanlar null olur.
  • isSmart, smart money eşiklerini geçen cüzdanları işaretler: 30 günde kârlı, kazanma oranı yüksek ve yeterince işlem yapmış cüzdanlar.