Разработчикам / API блэклиста USDT
API блэклиста USDT: бесплатная проверка по блэклисту Tether и OFAC SDN
API блэклиста USDT от USDT.Lawyer бесплатный: без ключа и без регистрации. Для адреса в TRON или Ethereum он в момент запроса читает блэклист USDT из контракта Tether, отдаёт историю заморозок, разморозок и сжиганий из нашего индекса и сверяет адрес со списком OFAC SDN. Он возвращает факты, а не риск-скор.
Три проверки, два запроса
Что проверяет API блэклиста USDT
POST /api/check/lookup → onchain
Блэклист USDT: статус на момент запроса
Читает getBlackListStatus в контракте USDT от Tether — в TRON (TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t) или в Ethereum (0xdAC17F958D2ee523a2206206994597C13D831ec7) — в момент запроса[1][2]. Прочитанный ответ используется повторно до 2 минут. Если контракт прочитать не удалось, onchain равен "unknown": это никогда не значит «не в блэклисте».
POST /api/check/lookup → events
История заморозок, разморозок и сжиганий
Все события блэклиста по адресу, которые есть в нашем индексе, от старых к новым, не больше 1000: события контракта AddedBlackList, RemovedBlackList и DestroyedBlackFunds[3][4], с балансом, записанным при заморозке, и уничтоженной суммой. События USDC от Circle лежат в том же индексе, с пометкой токена; для адреса только с событиями USDC статус — это запись индекса: контракт Circle не читается. В индексе есть известные пробелы, они перечислены на странице методологии.
GET /api/sanctions/ofac/check
Сверка адреса со списком OFAC SDN
Сверяет адрес с каждым криптоадресом, который OFAC указывает как идентификатор записи в списке SDN[5], по точному совпадению, как поиск самого OFAC[6] (адреса 0x и bech32 сравниваются в нижнем регистре, base58 — как написаны), в любой сети. Список берётся из Sanctions List Service OFAC[7]; сервер раз в 24 часа проверяет, не вышел ли новый файл. OFAC предупреждает, что его списки адресов вряд ли исчерпывающие[8], поэтому "listed": false не означает, что адрес чист.
Все адреса из списка с записями SDN: криптоадреса OFAC SDN (на английском).
Без кода: на странице проверки адреса USDT те же проверки по блэклисту Tether и OFAC SDN выполняются в браузере для одного адреса.
Чего он не делает
- ✕Нет риск-скора: API не считает ни балла, ни уровня, ни процента и не оценивает связь адреса с миксерами, мошенниками или другими источниками.
- ✕Нет трассировки: API не отслеживает, откуда пришли и куда ушли средства, и не называет контрагентов.
- ✕Две сети для блэклиста: чтение контракта и история событий есть только для TRON и Ethereum. TON и Solana получают ответ "unknown". С любым другим значением network контракт не читается (onchain "unknown"), но адрес 0x всё равно ищется в индексе, и может вернуться история и статус адреса Ethereum: отправляйте TRC20 или ERC20. Сверка с OFAC принимает адрес любой сети.
- ✕Один санкционный список — только OFAC SDN. Списки ЕС, ООН, UK OFSI и NBCTF Израиля не проверяются.
- ✕Не комплаенс-решение: чистый ответ — не сертификат, не подтверждение чистоты адреса и не юридическая консультация. Он показывает, что было в двух публичных источниках в момент запроса.
- ✕Без обещаний доступности: SLA нет.
Граница продукта
AML-риск-скоринг — отдельный продукт, AMLOfficer.org. Этот API его не использует, и его оценок в ответах нет.
Два адреса и реальные ответы API
Запросы выполнены 9 ноября 2026 года в 17:56 UTC. Команды работают как есть, ключ не нужен. В ваших ответах будет своё значение checkedOnChainAt (чтение контракта для вашего запроса или ответ не старше 2 минут); checkedAt — время, когда сервер в последний раз убедился, что у него текущий файл OFAC, оно одинаково для всех до следующей ежедневной проверки.
Чистый адрес для примера
TRON · TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G
Проверка по блэклисту
$ curl -X POST https://usdt.lawyer/api/check/lookup \
-H "Content-Type: application/json" \
-d '{"network":"TRC20","address":"TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G"}'
{
"status": "not_found",
"events": [],
"onchain": false,
"checkedOnChainAt": "2026-11-09T17:56:23.758Z",
"indexStatus": "not_found",
"mismatch": null,
"explorerUrl": "https://tronscan.org/#/address/TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G"
}Проверка по OFAC SDN
$ curl "https://usdt.lawyer/api/sanctions/ofac/check?address=TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G"
{
"ok": true,
"listed": false,
"hits": [],
"publishDate": "2026-11-06",
"checkedAt": "2026-11-09T17:32:39.912Z",
"baselineDate": "2026-11-06"
}Как читать: status "not_found" при onchain false значит, что контракт Tether не числит адрес в блэклисте, а в нашем индексе по нему нет событий. listed false: адреса нет в файле OFAC SDN от 6 ноября 2026 года.
Адрес в блэклисте Tether
TRON · TJCBpxZ3yC7C7oegSRZMFxBcscmUVeSA36
Проверка по блэклисту
$ curl -X POST https://usdt.lawyer/api/check/lookup \
-H "Content-Type: application/json" \
-d '{"network":"TRC20","address":"TJCBpxZ3yC7C7oegSRZMFxBcscmUVeSA36"}'
{
"status": "frozen",
"address": "TJCBpxZ3yC7C7oegSRZMFxBcscmUVeSA36",
"network": "TRX",
"token": "USDT",
"frozenBalance": 0,
"burnedAmount": 0,
"eventCount": 0,
"events": [],
"onchain": true,
"checkedOnChainAt": "2026-11-09T17:56:27.532Z",
"indexStatus": "not_found",
"mismatch": "not_in_index",
"explorerUrl": "https://tronscan.org/#/address/TJCBpxZ3yC7C7oegSRZMFxBcscmUVeSA36"
}Проверка по OFAC SDN
$ curl "https://usdt.lawyer/api/sanctions/ofac/check?address=TJCBpxZ3yC7C7oegSRZMFxBcscmUVeSA36"
{
"ok": true,
"listed": true,
"hits": [
{
"list": "OFAC SDN",
"address": "TJCBpxZ3yC7C7oegSRZMFxBcscmUVeSA36",
"currency": "USDT",
"uid": 58409,
"entity": null,
"type": "Individual",
"programs": ["IRAN-EO13902"],
"firstSeen": null,
"entryUrl": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=58409"
}
],
"publishDate": "2026-11-06",
"checkedAt": "2026-11-09T17:32:39.912Z",
"baselineDate": "2026-11-06"
}Как читать: status "frozen" при onchain true значит, что контракт числит адрес в блэклисте. indexStatus "not_found" и mismatch "not_in_index" говорят, что этой заморозки нет в нашем индексе (она попала в известный пробел), поэтому events пуст, а frozenBalance равен 0: статус определяет контракт, а не индекс. listed true: адрес — идентификатор одной записи SDN; для физического лица entity равен null, а entryUrl ведёт на официальную страницу записи.
Ответ проверки по OFAC устроен одинаково для адреса любой сети. Эти две проверки независимы. API не сообщает, почему адрес попал в блэклист, а включение в список OFAC — действие правительства США, а не вывод USDT.Lawyer.
Ограничения, кэш и условия
- ✓Доступ: без ключа, без токена, без регистрации и без префикса версии. Сервер не проверяет учётных данных и отвечает любому, кто к нему обращается.
- ✓Между серверами: API не отдаёт заголовков CORS, поэтому страница в браузере на другом домене не сможет прочитать ответы. Вызывайте его со своего бэкенда.
- ✓Лимит чтений контракта: примерно после 30 проверок за минуту от одного клиента проверка всё равно отвечает — по нашему индексу, с onchain "unknown", пока не закончится минута. Чтения контракта всех клиентов делят общий бюджет на каждую сеть; когда он исчерпан, ответ сразу "unknown", без ожидания.
- ✓Проверка OFAC: отвечает по копии списка в памяти сервера, без ограничения на клиента. Пока первая копия не загружена, ответ — 503 unavailable; повторите через 10 минут.
- ✓Кэш: прочитанный ответ контракта используется до 2 минут, информация о кошельке — 60 секунд; список OFAC отдаётся с max-age=3600, CSV-выгрузки — с max-age=600 и ETag.
- ✓Ошибки: проверка по блэклисту отвечает 400 invalid_address или 500 internal_error, проверка OFAC — 400 invalid_address или 503 unavailable, неизвестный путь — 404 с HTML-страницей.
- ✓Нет SLA и опубликованной квоты: кэшируйте ответы и не отправляйте запросы слишком часто.
Условия: отдельных условий API и лицензии на данные USDT.Lawyer не публикует; действует отказ от ответственности сайта. USDT.Lawyer не аффилирован ни с Tether, ни с OFAC и не может заморозить или разморозить какой-либо адрес.
Известные пробелы индекса событий и то, как сканер читает блокчейн: методология.
Бесплатно, без ключа
Все публичные эндпоинты
POST /api/check/lookup
Проверка по блэклисту
Статус в блэклисте Tether из контракта, что говорит один наш индекс, где они расходятся, и история событий. TRON и Ethereum.
GET /api/sanctions/ofac/check?address=
Проверка по OFAC SDN
Сверка одного адреса со списком OFAC SDN: есть ли он в списке, совпавшие записи SDN и дата проверенного файла.
GET /api/sanctions/ofac
Список OFAC SDN
Все криптоадреса из списка с записью SDN и программами; ?currency=USDT,TRX фильтрует строки. То же в CSV: GET /api/sanctions/ofac.csv.
GET /api/wallet/info
Балансы кошелька
Текущий баланс USDT и нативной монеты адреса в TRON, Ethereum, Solana или TON. Это чтение баланса, а не проверка.
GET /api/export/events.csv
Выгрузки данных (CSV)
Все проиндексированные заморозки, разморозки и сжигания USDT (events.csv), все пары «заморозка — разморозка» (unfreezes.csv) и каждый опубликованный отчётный период (/api/export/reports/<period>.csv).
Файл OpenAPI 3.1 описывает эти пути, их поля и ошибки: https://usdt.lawyer/openapi.json. Остальные пути /api/ обслуживают страницы и формы самого сайта; они не входят в публичный API и могут меняться без предупреждения.
Выбираете между API трекеров? На странице USDTBanList alternative (на английском) сравниваются доступ к API и цены шести трекеров заморозок USDT, у каждой ячейки есть источник.
Что есть в индексе
Что передаёт API
только OFAC SDN
Санкционные списки
Только OFAC SDN: криптоадреса из этого списка, которые мы читаем у OFAC ежедневно, — GET /api/sanctions/ofac (также в CSV) и GET /api/sanctions/ofac/check. Списки ЕС, ООН, UK OFSI и NBCTF Израиля не проверяются, а запрос по блэклисту санкционного вердикта не выдаёт.
5 типов событий
Типы событий
AddedBlackList/Blacklisted (заморозка) · RemovedBlackList/UnBlacklisted (разморозка) · DestroyedBlackFunds (сжигание).
2 сети
Блокчейны
TRC-20 (TRON) и ERC-20 (Ethereum) — две сети, которые покрывает индекс заморозок. В нём записаны события блэклиста контрактов USDT от Tether и контракта USDC от Circle.
Он-чейн события
Событий проиндексировано
Каждая проиндексированная заморозка, разморозка и сжигание доступны для запроса по адресу.
Частые вопросы
Источники
- [1] Tronscan, верифицированный код контракта USDT в TRON (BlackList.sol): “function getBlackListStatus(address _maker) external constant returns (bool) … function addBlackList (address _evilUser) public onlyOwner”
- [2] Etherscan, верифицированный код контракта USDT в Ethereum: публичная проверка статуса: “function getBlackListStatus(address _maker) external constant returns (bool)”
- [3] Tronscan, верифицированный код контракта USDT в TRON: события блэклиста: “event AddedBlackList(…); event RemovedBlackList(…); event DestroyedBlackFunds(…);”
- [4] Etherscan, верифицированный код контракта USDT в Ethereum: события блэклиста: “event DestroyedBlackFunds(…); event AddedBlackList(…); event RemovedBlackList(…);”
- [5] OFAC, вопросы о виртуальной валюте, FAQ 561 (опубликован 19 марта 2018): “may include as identifiers on the SDN List specific digital currency addresses”
- [6] OFAC, вопросы о виртуальной валюте, FAQ 594: “only exact matches will be returned when searching for digital currency addresses”
- [7] OFAC, Sanctions List Service: “the SDN list contains the names of individuals, entities and groups designated by OFAC”
- [8] OFAC, вопросы о виртуальной валюте, FAQ 562: “OFAC’s digital currency address listings are not likely to be exhaustive.”
Ещё по теме
- Проверка блэклиста USDT
Вставьте адрес TRON или Ethereum, чтобы узнать, заморозил ли его Tether.
- USDT заморожен: что делать
Подтвердить заморозку, сохранить доказательства, не платить тем, кто обещает разморозку.
- Скам с разморозкой USDT или настоящая заморозка?
Как отличить заморозку Tether от мошенников, которые просят плату за разморозку.
- Как разморозить USDT
Как строится дело о снятии необоснованной заморозки. Результат не гарантирован.
- Почему Tether замораживает кошельки?
Запросы правоохранительных органов, санкции и собственные правила Tether.
- Что такое блэклист USDT?
Функция контракта, которая позволяет Tether заморозить адрес.