xca문서
엔드포인트

지갑

지갑의 30일 트레이딩 프로필: 손익, 승률, 보유 시간, 자금 출처.

GET/api/v1/wallets/{address}

XCA가 지갑에 대해 만든 프로필을 반환해요. 지갑 프로필은 토큰을 스캔할 때(상위 홀더 대상) 또는 앱에서 요청할 때 만들어져요. 프로필이 없는 지갑을 조회하면 404 오류가 반환돼요.

파라미터#

addresspath필수
지갑 주소.string

요청#

curl -s "https://app.xca.fun/api/v1/wallets/HN7cABqLq46Es1jh92dQQisAq662SmxELLLsHHe4YWrH" \
  -H "Authorization: Bearer $XCA_API_KEY"
직접 실행
실제 요청을 보내려면 API 키를 붙여넣으세요.

응답#

address
지갑 주소.string
isSmart
지갑이 스마트 머니 기준을 충족해요.boolean
pnl30dUsd
최근 30일 손익(USD).number | null
pnl30dPct
최근 30일 손익(%).number | null
winRate
수익 거래 비율(0~1).number | null
trades30d
최근 30일 거래 횟수.number | null
avgHoldSec
평균 보유 시간(초).number | null
walletAgeDays
첫 트랜잭션 이후 지난 일수.number | null
fundedBy
이 지갑에 처음 자금을 보낸 지갑.string | null
lastProfiledAt
프로필 생성 시각.string

응답 예시#

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

상태 코드#

200성공
400validation — 파라미터나 요청 본문이 유효하지 않아요. error.issues 값을 확인하세요.
401unauthorized — API 키가 없거나, 형식이 잘못됐거나, 폐기됐어요.
402planRequired — 플랜에 API 접근 권한이나 이 기능이 포함되어 있지 않아요.
404notFound — 토큰이 아직 스캔되지 않았거나 지갑 프로필이 아직 없어요.
429rateLimited — 분당 요청이 너무 많거나 월간 할당량을 모두 사용했어요.

참고 사항#

  • pnl30dPct, avgHoldSec 필드는 플랜에 상세 손익이, fundedBy 필드는 클러스터 기능이 포함되어 있어야 하며, 그렇지 않으면 null이에요.
  • isSmart 값은 스마트 머니 기준을 충족한 지갑을 나타내요. 최근 30일 동안 수익을 냈고, 승률이 높고, 거래 횟수가 충분한 지갑이에요.