Address Intelligence API
Pay-per-request blockchain address intelligence for AI agents and applications. Blacklist checks, address labels, AML risk scoring.
API Endpoints
/x402/check/{address}Check if a wallet address is blacklisted or sanctioned. Auto-detects network from address format.
address(string) — Wallet address (0x... for eth, T... for trx){
"success": true,
"data": {
"address": "T...",
"network": "trx",
"isBanned": true,
"balance": "1,584,500.17"
}
}/x402/labelGet address labels and entity information — exchange name, protocol, contract type, category, risk level.
chain(string) — eth or trxaddress(string) — Wallet address{
"success": true,
"data": {
"address": "0x...",
"network": "eth",
"labels": [{ "name": "Binance", "category": "exchange" }]
}
}/x402/aml-checkDeep AML risk analysis: risk score (0-100), risk level, fund sources, detailed breakdown.
address(string) — Wallet address (0x... or T...). Network auto-detected{
"success": true,
"data": {
"riskScore": 72,
"riskLevel": "high",
"sources": { "byType": [{ "name": "Exchange", "share": 0.65 }] }
}
}How x402 Works
Discover
Fetch /.well-known/x402.json to get payment requirements and supported endpoints.
Pay
Send USDC on Base to the receiver address. Include the tx hash in the X-PAYMENT header.
Query
Call the API endpoint. Payment is verified on-chain. Response is returned instantly.
Quick Start
curl https://mcp.usdtbanlist.com/.well-known/x402.json
curl https://mcp.usdtbanlist.com/x402/check/TJVHRTVkAYcPSjTWEqtYNLbYkn536MMSsa
{
"mcpServers": {
"usdtbanlist": {
"url": "https://mcp.usdtbanlist.com/mcp"
}
}
}Try an endpoint
Select a service, chain, and address.
Powered by USDTBanList
Blacklist data from on-chain USDT/USDC contract events. AML scoring via ChainSentry intelligence.