Public compliance verdict for a TRON address
Open, keyless lookup that returns a compliance verdict for one TRON address, served entirely from an in-memory deny-list cache — no authentication, no balance and no charge.
The verdict is a category, not a risk score. aml_risk — the address is on the central deny list (sanctions, scams, stolen funds and the like). smart_contract — a known contract address, including contracts deleted later (the address is not a user wallet, so energy is not delegated to it); this is NOT an AML judgement and does not mean the contract is compromised or tainted. spam_sender — a mass-spam sender. clean — in none of the sets.
For aml_risk a curated reason is added (severity, reason_code, label); the underlying data provider is never named. Rate limited per IP by the gateway. Full contract, categories and examples are on the guide page.
matches lists every set the address is in (category is only the highest-priority one). subtype refines smart_contract: gasfree_wallet is a live GasFree wallet (created by controller TFFAMQLZybALaLb4uxHA9RBE7pxhUAjF3U) — it can receive USDT, but energy is not delegated to it; selfdestructed_contract — the contract at this address is deleted by the latest state confirmed by a node (takes priority over gasfree_wallet). subtype_status is confirmed, not_found or unavailable (a subtype list not consulted; subtype is then null). checks_complete is true when all four sets were loaded and up to date.
If the central deny list is not currently loaded or its current revision fails an integrity check, the endpoint does NOT fall back to clean — it returns 503 with code 5004 (verdict cannot be produced; retry); if a set failed to apply it returns 503 with code 5005 (a routine update does not affect the verdict). A definite block from the frozen-USDT, smart-contract or spam-sender sets is still returned as 200.
Parameters
Path Parameters
TRON base58 address: T followed by 33 characters.
"TTVUvAWUZafeHqQP82sYnfk4jNFPEHCRpL"Responses
Verdict returned, clean addresses included. Read data.category.