Endpoint’ler

Holder’lar

Taranmış bir token’ın sınıflandırılmış holder’ları; PnL, giriş zamanı ve fon kaynağıyla birlikte, sayfa sayfa.

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

Bir token’ın analiz edilmiş holder’larını sıralarına göre, XCA’nın her cüzdana atadığı sınıfla birlikte döndürür. Token’ın önceden taranmış olması gerekir; aksi halde 404 alırsın.

Parametreler#

chainpathzorunlu

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

addresspathzorunlu

Token’ın mint adresi.string

pagequery

Sayfa numarası, 1’den başlar.integer ≥ 1varsayılan: 1

pageSizequery

Sayfa başına holder sayısı.10 | 25 | 50 | 100varsayılan: 100

classquery

Yalnızca bu sınıftaki holder’ları döndürür.ALL | HolderClassvarsayılan: ALL

İstek#

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

Dene

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

chainpathaddresspathpagequerypageSizequeryclassquery

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

Yanıt#

rows

Bu sayfadaki holder’lar.HolderRow[]

rank

Bakiyeye göre sıra; 1 en büyüğüdür.number

address

Cüzdan adresi.string | null

sharePct

Elde tutulan arz payı.number

valueUsd

Elde tutulan miktarın değeri, USD.number | null

class

XCA’nın cüzdana atadığı sınıf.HolderClass | "HIDDEN"

flags

Cüzdanın ek özellikleri.string[]

entryAt

İlk alımın zamanı.string | null

entryBlock

Lansman ile ilk alım arasındaki blok sayısı (sniper’larda bu sayı küçüktür).number | null

pnl30dUsd

30 günlük gerçekleşmiş ve gerçekleşmemiş 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

avgHoldSec

Ortalama tutma süresi, saniye.number | null

trades30d

30 gündeki işlem sayısı.number | null

fundedBy

Bu cüzdana ilk fonu gönderen cüzdan.string | null

clusterId

Cüzdanın ait olduğu küme.string | null

profiled

Tam bir cüzdan profili mevcut.boolean

total

Filtreye uyan görünür holder’lar.number

lockedCount

Planının limiti nedeniyle gizlenen holder’lar.number

page

Mevcut sayfa.number

pageSize

Sayfa başına holder sayısı.number

visibleLimit

Planının gösterdiği en büyük holder sayısı; -1 tümü anlamına gelir.number

Örnek yanıt#

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

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.

Holder sınıfları#

`SMART_MONEY`	Son 30 günde kârlı, kazanma oranı yüksek trader.
`REGULAR`	Dikkat çekici bir şey yok.
`DEV`	Token’ın yaratıcısı.
`DEV_BUNDLE`	Yaratıcıyla birlikte alım yaptı ya da yaratıcı tarafından fonlandı.
`SNIPER`	Lansmandan sonraki ilk bloklarda aldı.
`FRESH`	Çok kısa süre önce oluşturulmuş cüzdan.
`POOL`	Likidite havuzu, vault ya da bonding curve.
`CEX`	Merkezi borsa cüzdanı.
`BURN`	Yakım adresi.

Bilmekte fayda var#

Planın, en büyük holder’lardan kaçını görebileceğini sınırlar; total yalnızca görünenleri sayar, lockedCount ise kaç tane daha olduğunu söyler.
SNIPER, DEV_BUNDLE, SMART_MONEY veya FRESH ile filtreleme yapmak için planında ilgili özelliğin bulunması gerekir; aksi halde 402 alırsın.
Planının göremediği bir sınıf HIDDEN olarak döner.
PnL alanları planın PnL seviyesine bağlıdır: temel seviye pnl30dUsd ve winRate verir, detaylı seviye bunlara pnl30dPct, avgHoldSec ve trades30d ekler.