Endpoints

Holders

Holders clasificados de un token escaneado, con PnL, momento de entrada y origen de los fondos, página por página.

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

Devuelve los holders analizados de un token ordenados por posición, con la clase que XCA asignó a cada billetera. El token debe haberse escaneado; de lo contrario, recibes 404.

Parámetros#

chainpathobligatorio

Identificador de la red. Por ahora, solo solana."solana"

addresspathobligatorio

Dirección del token (mint).string

pagequery

Número de página, a partir de 1.integer ≥ 1por defecto: 1

pageSizequery

Holders por página.10 | 25 | 50 | 100por defecto: 100

classquery

Devuelve solo los holders de esta clase.ALL | HolderClasspor defecto: ALL

Solicitud#

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

Pruébalo

Clave de APIObtener clave de APISe guarda solo en esta pestaña del navegador y se envía únicamente a la API de XCA.

chainpathaddresspathpagequerypageSizequeryclassquery

Pega tu clave de API para enviar una solicitud real.

Respuesta#

rows

Holders de esta página.HolderRow[]

rank

Posición según el saldo; 1 es el mayor.number

address

Dirección de la billetera.string | null

sharePct

Porcentaje del suministro en su poder.number

valueUsd

Valor de la tenencia, en USD.number | null

class

Clase que XCA asignó a la billetera.HolderClass | "HIDDEN"

flags

Rasgos adicionales de la billetera.string[]

entryAt

Momento de la primera compra.string | null

entryBlock

Bloques entre el lanzamiento y la primera compra (los snipers tienen valores bajos).number | null

pnl30dUsd

PnL realizado y no realizado en 30 días, en USD.number | null

pnl30dPct

PnL en 30 días, en porcentaje.number | null

winRate

Proporción de operaciones con ganancia, de 0 a 1.number | null

avgHoldSec

Tiempo promedio de tenencia, en segundos.number | null

trades30d

Operaciones en 30 días.number | null

fundedBy

Billetera que envió los primeros fondos a esta.string | null

clusterId

Clúster al que pertenece la billetera.string | null

profiled

Existe un perfil completo de la billetera.boolean

total

Holders visibles que coinciden con el filtro.number

lockedCount

Holders ocultos por el límite de tu plan.number

page

Página actual.number

pageSize

Holders por página.number

visibleLimit

Cuántos top holders muestra tu plan; -1 significa todos.number

Respuesta de ejemplo#

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

Códigos de estado#

200Éxito

400validation — Un parámetro o el cuerpo de la solicitud no es válido; consulta error.issues.

401unauthorized — La clave de API falta, está mal formada o fue revocada.

402planRequired — Tu plan no incluye acceso a la API o a esta función.

404notFound — El token aún no se escaneó o la billetera aún no se perfiló.

429rateLimited — Demasiadas solicitudes por minuto o se agotó la cuota mensual.

Clases de holders#

`SMART_MONEY`	Trader rentable en los últimos 30 días, con un win rate alto.
`REGULAR`	Nada destacable.
`DEV`	El creador del token.
`DEV_BUNDLE`	Compró junto con el creador o recibió fondos del creador.
`SNIPER`	Compró en los primeros bloques tras el lanzamiento.
`FRESH`	Billetera creada hace muy poco.
`POOL`	Pool de liquidez, bóveda o bonding curve.
`CEX`	Billetera de un exchange centralizado.
`BURN`	Dirección de quema.

Ten en cuenta#

Tu plan limita cuántos top holders puedes ver; total cuenta solo los visibles y lockedCount indica cuántos más hay.
Filtrar por SNIPER, DEV_BUNDLE, SMART_MONEY o FRESH requiere la función correspondiente en tu plan; de lo contrario, recibes 402.
Una clase que tu plan no puede ver se devuelve como HIDDEN.
Los campos de PnL dependen del nivel de PnL del plan: el básico incluye pnl30dUsd y winRate; el detallado agrega pnl30dPct, avgHoldSec y trades30d.