FreezeCheck Открыть бота →

API

Проверка USDT в вашей системе.

Для обменников, OTC и P2P-команд. Отправьте адрес TRON или хеш транзакции и получите вердикт 🟢 / 🟡 / 🔴 с причинами в JSON. Это тот же движок, что в @freezecheck_bot.

Попробовать за минуту, без кода. В пульте API пробный ключ выдаётся сразу (100 проверок в сутки на 20 дней): вставьте список адресов или загрузите CSV и скачайте результат для Excel. Там же — готовый код на Python, PHP и Node.js. Нужен лимит больше — напишите на hello@freezecheck.org или в Telegram @freezecheck_support.

Запрос

Один адрес, запрос GET. Ключ передавайте в заголовке, а не в ссылке.

curl -H "Authorization: Bearer fc_xxxxxxxx_…" \
  "https://freezecheck.org/api/v1/check?address=TXyz…&lang=ru"
ПараметрЧто это
addressАдрес TRON (T…), который проверяем.
txВместо адреса — хеш транзакции. Проверяем отправителя самого крупного перевода USDT в ней.
langЯзык текстов: ru, en (по умолчанию), uk, es, pt, tr, ar, id, vi, zh.

Можно и заголовок X-API-Key: fc_….

Ответ

{
  "address": "TXyz…",
  "chain": "tron",
  "verdict": "yellow",
  "action": "review",
  "score": 46,
  "confidence": "high",
  "title": "Есть вопросы",
  "signals": [
    {"code": "taint_dirty", "severity": "high", "points": 25,
     "text": "В 2 шагах — кошелёк, замороженный Tether: 1 200 USDT"},
    {"code": "mature", "severity": "positive", "points": -5,
     "text": "Кошелёк активен 2 года"}
  ],
  "checked_at": "2026-11-18T09:15:02+00:00",
  "cached": false,
  "report_url": "https://t.me/freezecheck_bot?start=w_TXyz…",
  "usage": {"today": 128, "daily_limit": 1000}
}
ПолеЧто значит
verdictgreen — риска не нашли, yellow — осторожно, прочитайте причины, red — высокий риск, unknown — мало данных.
actionЧто сделать программе, одним словом: accept — принять (green), review — показать менеджеру с причинами (yellow или unknown), hold — не зачислять и задержать (red).
scoreОценка риска от 0 до 100.
confidencehigh / medium / low — насколько полным был анализ.
signalsПричины, самые важные сверху. code не меняется — по нему удобно строить правила; severity — critical, high, medium, low или positive; points — вклад в оценку.
checked_atКогда прочитаны данные блокчейна.
cachedtrue — ответ из недавней проверки того же адреса.
report_urlПолный отчёт с графом связей и PDF в боте.
txТолько для tx=: id, from, to, amount, at перевода.
usageСколько проверок ключа ушло сегодня и суточный лимит.

Пакет: до 50 адресов одним запросом

Удобно для выплат: за один проход разделить пачку на «платим» и «на проверку».

curl -X POST -H "Authorization: Bearer fc_xxxxxxxx_…" \
  -H "Content-Type: application/json" \
  -d '{"addresses": ["TXyz…", "TAbc…"], "lang": "ru"}' \
  https://freezecheck.org/api/v1/batch

В ответе results — в том же порядке, что адреса в запросе. У каждого либо те же поля, что при одиночной проверке, либо error для этого адреса (bad_address, quota, slow, source_down). Ещё в ответе checked и usage. Каждый адрес с вердиктом списывается из суточного лимита один раз. Пакет новых адресов может занять несколько минут — поставьте таймаут клиента 10 минут.

Лимиты и время

У каждого ключа суточный лимит, он обнуляется в 00:00 UTC. Считается каждый ответ с вердиктом, в том числе из кэша. Ошибки не считаются.

Новая проверка обычно занимает 5–15 секунд, а очень крупный кошелёк — до двух минут. Поставьте таймаут клиента 180 секунд. Повторная проверка того же адреса в пределах кэша отвечает сразу.

Расход: GET /api/v1/usage с тем же заголовком вернёт today, daily_limit и resets_at.

Ошибки

HTTPerrorЧто делать
400bad_addressПередайте адрес TRON или хеш транзакции из 64 знаков.
400bad_batchТолько для пакета: JSON {"addresses": [...]} с 1–50 адресами.
401no_key, bad_keyДобавьте заголовок; проверьте, что ключ не отозван.
403trial_overПробные 20 дней закончились — напишите на hello@freezecheck.org или в Telegram @freezecheck_support, чтобы продолжить.
404tx_not_foundВ транзакции нет перевода USDT (TRC-20).
429quotaСуточный лимит исчерпан, время сброса — в resets_at.
429busyСлишком много новых проверок одновременно — повторите через несколько секунд.
503slow, source_downПовторите через минуту.

В каждой ошибке есть поле message с пояснением (по-английски).

Как использовать вердикт

Частая схема — ровно поле action: green принимать автоматически, yellow отдавать менеджеру вместе с причинами, red — задерживать. Как считается оценка, описано в методике. Вердикт — эвристическая оценка, а не юридическое заключение AML.

Получить пробный ключ сейчас →