xcaDocs
Endpoints

Carteiras

Perfil de trading de 30 dias de uma carteira: PnL, win rate, tempo de hold e origem dos fundos.

GET/api/v1/wallets/{address}

Retorna o perfil que o XCA montou para uma carteira. As carteiras são perfiladas durante os scans de tokens (os maiores holders) e sob demanda no app; uma carteira que nunca foi perfilada retorna 404.

Parâmetros#

addresspathobrigatório
Endereço da carteira.string

Requisição#

curl -s "https://app.xca.fun/api/v1/wallets/HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH" \
  -H "Authorization: Bearer $XCA_API_KEY"
Testar
Cole sua chave de API para enviar uma requisição real.

Resposta#

address
Endereço da carteira.string
isSmart
A carteira atende aos critérios de smart money.boolean
pnl30dUsd
PnL em 30 dias, em USD.number | null
pnl30dPct
PnL em 30 dias, em porcentagem.number | null
winRate
Proporção de trades lucrativos, de 0 a 1.number | null
trades30d
Trades em 30 dias.number | null
avgHoldSec
Tempo médio de hold, em segundos.number | null
walletAgeDays
Dias desde a primeira transação.number | null
fundedBy
Carteira que enviou os primeiros fundos para esta.string | null
lastProfiledAt
Quando o perfil foi montado.string

Exemplo de resposta#

{
  "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 status#

200Sucesso
400validation — Um parâmetro ou o corpo da requisição é inválido; veja error.issues.
401unauthorized — A chave de API está ausente, malformada ou revogada.
402planRequired — O seu plano não inclui acesso à API ou a este recurso.
404notFound — O token ainda não foi escaneado ou a carteira ainda não foi perfilada.
429rateLimited — Requisições demais por minuto, ou a cota mensal se esgotou.

Bom saber#

  • pnl30dPct e avgHoldSec exigem PnL detalhado no seu plano, e fundedBy exige clusters; caso contrário, eles vêm como null.
  • isSmart marca as carteiras que atendem aos critérios de smart money: lucrativas em 30 dias, com win rate alto e trades suficientes.