Endpoint’ler

Taramalar

Bir token için tarama başlat ya da eskimiş bir raporu yenile.

POST/api/v1/scans

Bir token’ın tam analizini kuyruğa alır ve güncel durumunu döndürür. Çağrıyı güvenle tekrarlayabilirsin: bir tarama sürerken asla ikinci bir tarama başlatmaz.

Parametreler#

chainbody

Zincir kimliği. Şimdilik yalnızca solana."solana"varsayılan: "solana"

addressbodyzorunlu

Taranacak token’ın mint adresi.string

İstek#

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

Dene

API anahtarıAPI anahtarı alYalnızca bu tarayıcı sekmesinde tutulur ve yalnızca XCA API’ye gönderilir.

chainbodyaddressbody

Gerçek bir istek göndermek için API anahtarını yapıştır.

Yanıt#

status

Tarama durumu."NONE" | "QUEUED" | "RUNNING" | "DONE" | "ERROR"

depth

Taramanın ürettiği ya da yenilediği raporun derinliği."LIGHT" | "FULL" | null

step

Mevcut tarama adımı.string | null

progress

0 ile 100 arasında ilerleme.number

stale

Mevcut rapor, önbellek ömründen daha eski.boolean

upgrading

LIGHT bir rapor FULL seviyesine yükseltiliyor.boolean

limitReached

Günlük tarama limitin doldu; eski raporun durumu döndürülür.boolean

Örnek yanıt#

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

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.

429rateLimited — Dakika başına çok fazla istek gönderildi ya da aylık kota doldu.

503unavailable — Bakım çalışması var ya da veri sağlayıcısının kapasitesi doldu.

Nasıl davranır#

Güncel rapor varsa: hemen DONE döndürür ve tarama limitini harcamaz.
Tarama sürüyorsa: step ve progress ile birlikte QUEUED veya RUNNING döndürür.
Aksi halde: yeni bir taramayı kuyruğa alır ve günlük limitinden bir tarama harcar.
Günlük limit dolmuş ama daha eski bir rapor varsa: limitReached true olacak şekilde o raporun durumunu döndürür.

Sonucu beklemek#

Durum DONE veya ERROR olana kadar GET /tokens/{chain}/{address} endpoint’ini 3–5 saniyede bir sorgula. Taramaların çoğu bir dakika içinde biter.

Token tara ve bekleBir tarama başlat, makul aralıklarla sorgula ve tamamlanan raporu al.

Tarama adımları#

`queued`	Kuyrukta bekliyor.
`market`	Fiyat, likidite ve mint verileri çekiliyor.
`holders`	Holder listesi okunuyor.
`trades`	Sniper’ları bulmak için ilk işlemler okunuyor.
`profiles`	En büyük holder’ların profili çıkarılıyor: fon kaynağı, cüzdan yaşı, PnL.
`classify`	Sınıflar atanıyor ve kümeler oluşturuluyor.
`dev`	Yaratıcının önceki lansmanları kontrol ediliyor.
`save`	Holder Score hesaplanıyor ve kaydediliyor.
`done`	Tamamlandı.
`error`	Başarısız oldu.

XCA bakımdayken ya da veri sağlayıcısının kapasitesi dolduğunda taramalar 503 unavailable döndürür. Daha sonra tekrar dene.