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 і достатньо угод.