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}
}
| Поле | Что значит |
|---|---|
verdict | green — риска не нашли, yellow — осторожно, прочитайте причины, red — высокий риск, unknown — мало данных. |
action | Что сделать программе, одним словом: accept — принять (green), review — показать менеджеру с причинами (yellow или unknown), hold — не зачислять и задержать (red). |
score | Оценка риска от 0 до 100. |
confidence | high / medium / low — насколько полным был анализ. |
signals | Причины, самые важные сверху. code не меняется — по нему удобно строить правила; severity — critical, high, medium, low или positive; points — вклад в оценку. |
checked_at | Когда прочитаны данные блокчейна. |
cached | true — ответ из недавней проверки того же адреса. |
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.
Ошибки
| HTTP | error | Что делать |
|---|---|---|
| 400 | bad_address | Передайте адрес TRON или хеш транзакции из 64 знаков. |
| 400 | bad_batch | Только для пакета: JSON {"addresses": [...]} с 1–50 адресами. |
| 401 | no_key, bad_key | Добавьте заголовок; проверьте, что ключ не отозван. |
| 403 | trial_over | Пробные 20 дней закончились — напишите на hello@freezecheck.org или в Telegram @freezecheck_support, чтобы продолжить. |
| 404 | tx_not_found | В транзакции нет перевода USDT (TRC-20). |
| 429 | quota | Суточный лимит исчерпан, время сброса — в resets_at. |
| 429 | busy | Слишком много новых проверок одновременно — повторите через несколько секунд. |
| 503 | slow, source_down | Повторите через минуту. |
В каждой ошибке есть поле message с пояснением (по-английски).
Как использовать вердикт
Частая схема — ровно поле action: green принимать автоматически, yellow отдавать менеджеру вместе с причинами, red — задерживать. Как считается оценка, описано в методике. Вердикт — эвристическая оценка, а не юридическое заключение AML.