xcaDocs
Эндпоинты

Кошельки

Торговый профиль кошелька за 30 дней: PnL, win rate, время удержания и источник финансирования.

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
Кошелёк проходит пороги smart money.boolean
pnl30dUsd
PnL за 30 дней, USD.number | null
pnl30dPct
PnL за 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 требуют подробного PnL в тарифе, fundedBy — кластеров; иначе они равны null.
  • isSmart отмечает кошельки, проходящие пороги smart money: прибыль за 30 дней, высокий win rate и достаточно сделок.