Ендпоінти

Скани

Запуск скану токена або оновлення застарілого звіту.

POST/api/v1/scans

Ставить у чергу повний аналіз токена і повертає його поточний стан. Виклик можна безпечно повторювати: він ніколи не запускає другий скан, поки триває перший.

Параметри#

chainbody

Ідентифікатор мережі. Поки що лише solana."solana"за замовчуванням: "solana"

addressbodyобов'язково

Адреса токена (mint), який треба просканувати.string

Запит#

curl -s -X POST "https://app.xca.fun/api/v1/scans" \
  -H "Authorization: Bearer $XCA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"solana","address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}'

Спробувати

API-ключОтримати API-ключЗберігається лише в цій вкладці браузера й надсилається лише в XCA API.

chainbodyaddressbody

Встав свій API-ключ, щоб надіслати справжній запит.

Відповідь#

status

Стан скану."NONE" | "QUEUED" | "RUNNING" | "DONE" | "ERROR"

depth

Глибина звіту, який скан створює чи оновлює."LIGHT" | "FULL" | null

step

Поточний крок скану.string | null

progress

Прогрес від 0 до 100.number

stale

Наявний звіт старший за час життя кешу.boolean

upgrading

LIGHT-звіт доповнюється до FULL.boolean

limitReached

Денний ліміт сканів вичерпано; повертається стан старішого звіту.boolean

Приклад відповіді#

{
  "status": "QUEUED",
  "depth": null,
  "step": "queued",
  "progress": 0,
  "stale": false,
  "upgrading": false,
  "limitReached": false
}

Коди статусів#

200Успіх

400validation — Некоректний параметр або тіло запиту; дивись error.issues.

401unauthorized — API-ключ відсутній, некоректний або відкликаний.

402planRequired — Тариф не включає доступ до API або цю функцію.

429rateLimited — Забагато запитів на хвилину або вичерпано місячну квоту.

503unavailable — Техобслуговування або в постачальника даних закінчилася потужність.

Як поводиться#

Свіжий звіт: одразу повертає DONE і не витрачає ліміт сканів.
Скан уже йде: повертає QUEUED або RUNNING зі step і progress.
Інакше: ставить новий скан у чергу і витрачає один скан із денного ліміту.
Денний ліміт вичерпано, але є старіший звіт: повертає його стан з limitReached = true.

Очікування результату#

Опитуй GET /tokens/{chain}/{address} раз на 3–5 секунд, доки статус не стане DONE або ERROR. Більшість сканів завершується за хвилину.

Сканування з очікуваннямЗапусти скан, ввічливо опитуй і отримай готовий звіт.

Кроки скану#

`queued`	Чекає в черзі.
`market`	Отримує ціну, ліквідність і дані mint.
`holders`	Читає список холдерів.
`trades`	Читає найперші угоди, щоб знайти снайперів.
`profiles`	Профілює найбільших холдерів: фінансування, вік, PnL.
`classify`	Призначає класи й будує кластери.
`dev`	Перевіряє попередні запуски творця.
`save`	Рахує Holder Score і зберігає звіт.
`done`	Готово.
`error`	Помилка.

Поки XCA на техобслуговуванні або в постачальника даних закінчилася потужність, скани повертають 503 unavailable. Спробуй пізніше.