Команда форензики и комплаенса · Не юридическая фирма · Не аффилированы с Tether · Читать дисклеймер

Разработчикам / API блэклиста USDT

API блэклиста USDT: бесплатная проверка по блэклисту Tether и OFAC SDN

API блэклиста USDT от USDT.Lawyer бесплатный: без ключа и без регистрации. Для адреса в TRON или Ethereum он в момент запроса читает блэклист USDT из контракта Tether, отдаёт историю заморозок, разморозок и сжиганий из нашего индекса и сверяет адрес со списком OFAC SDN. Он возвращает факты, а не риск-скор.

Открыть справочник APIФайл OpenAPI 3.1Попробовать в браузереБесплатно, без ключа, без токена и без регистрации. JSON по HTTPS, запросы — со своего сервера.

2

Сетей в индексе заморозок

TRC-20 · ERC-20

5

Типов событий в индексе

freeze · unfreeze · burn

Три проверки, два запроса

Что проверяет 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. [1] Tronscan, верифицированный код контракта USDT в TRON (BlackList.sol): “function getBlackListStatus(address _maker) external constant returns (bool) … function addBlackList (address _evilUser) public onlyOwner”
  2. [2] Etherscan, верифицированный код контракта USDT в Ethereum: публичная проверка статуса: “function getBlackListStatus(address _maker) external constant returns (bool)”
  3. [3] Tronscan, верифицированный код контракта USDT в TRON: события блэклиста: “event AddedBlackList(…); event RemovedBlackList(…); event DestroyedBlackFunds(…);”
  4. [4] Etherscan, верифицированный код контракта USDT в Ethereum: события блэклиста: “event DestroyedBlackFunds(…); event AddedBlackList(…); event RemovedBlackList(…);”
  5. [5] OFAC, вопросы о виртуальной валюте, FAQ 561 (опубликован 19 марта 2018): “may include as identifiers on the SDN List specific digital currency addresses”
  6. [6] OFAC, вопросы о виртуальной валюте, FAQ 594: “only exact matches will be returned when searching for digital currency addresses”
  7. [7] OFAC, Sanctions List Service: “the SDN list contains the names of individuals, entities and groups designated by OFAC”
  8. [8] OFAC, вопросы о виртуальной валюте, FAQ 562: “OFAC’s digital currency address listings are not likely to be exhaustive.”
Все руководства по замороженному USDT →