xcaDocs
Endpoints

Billeteras

Perfil de trading de una billetera en los últimos 30 días: PnL, win rate, tiempo de tenencia y origen de los fondos.

GET/api/v1/wallets/{address}

Devuelve el perfil que XCA generó para una billetera. Las billeteras se perfilan durante los escaneos de tokens (los mayores holders) y bajo demanda en la app; una billetera que nunca se perfiló devuelve 404.

Parámetros#

addresspathobligatorio
Dirección de la billetera.string

Solicitud#

curl -s "https://app.xca.fun/api/v1/wallets/HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH" \
  -H "Authorization: Bearer $XCA_API_KEY"
Pruébalo
Pega tu clave de API para enviar una solicitud real.

Respuesta#

address
Dirección de la billetera.string
isSmart
La billetera supera los umbrales de smart money.boolean
pnl30dUsd
PnL 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
trades30d
Operaciones en 30 días.number | null
avgHoldSec
Tiempo promedio de tenencia, en segundos.number | null
walletAgeDays
Días desde la primera transacción.number | null
fundedBy
Billetera que envió los primeros fondos a esta.string | null
lastProfiledAt
Cuándo se generó el perfil.string

Respuesta de ejemplo#

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

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.

Ten en cuenta#

  • pnl30dPct y avgHoldSec requieren PnL detallado en tu plan, y fundedBy requiere clústeres; de lo contrario, son null.
  • isSmart marca las billeteras que superan los umbrales de smart money: rentables en 30 días, con un win rate alto y suficientes operaciones.