x402 Protocol

Address Intelligence API

Pay-per-request blockchain address intelligence for AI agents and applications. Blacklist checks, address labels, AML risk scoring.

Discovery EndpointMCP Config
EthereumTRONUSDC on Base
$0.001
check_address
$0.10
label
$1.50
aml_check
$1.50
aml_tx_check

API Endpoints

POST/x402/check
$0.001

Check if a wallet address is blacklisted or sanctioned. Auto-detects network from address format.

BlacklistSanctionsPaid
Parameters
address(string) — Wallet address (0x... for eth, T... for trx)
Response
{
  "success": true,
  "data": {
    "address": "T...",
    "network": "trx",
    "isBanned": true,
    "balance": "1,584,500.17"
  }
}
POST/x402/label
$0.10

Get address labels and entity information — exchange name, protocol, contract type, category, risk level.

LabelsEntityPaid
Parameters
chain(string) — eth or trx
address(string) — Wallet address
Response
{
  "success": true,
  "data": {
    "address": "0x...",
    "network": "eth",
    "labels": [{ "name": "Binance", "category": "exchange" }]
  }
}
POST/x402/aml-check
$1.50

Deep AML risk analysis of a wallet address: risk score (0-100), risk level, fund sources, detailed breakdown.

AMLRisk ScoreCompliance
Parameters
address(string) — Wallet address (0x... or T...). Network auto-detected
Response
{
  "success": true,
  "data": {
    "riskScore": 72,
    "riskLevel": "high",
    "sources": { "byType": [{ "name": "Exchange", "share": 0.65 }] }
  }
}
POST/x402/aml-tx-check
$1.50

AML risk analysis of a USDT/USDC transaction. Returns risk score, risk level, fund sources, sender and receiver addresses.

AMLTransactionCompliance
Parameters
txHash(string) — Transaction hash (0x... for ETH, hex for TRON)
direction(number) — 0=auto, 1=incoming, 2=outgoing (default: 0)
Response
{
  "success": true,
  "data": {
    "txHash": "0x...",
    "network": "ethereum",
    "riskScore": 65,
    "riskLevel": "high",
    "sources": { "byType": [{ "name": "Exchange", "share": 0.55 }] }
  }
}

How x402 Works

1

Discover

Fetch /.well-known/x402.json to get payment requirements and supported endpoints.

2

Pay

Send USDC on Base to the receiver address. Include the tx hash in the X-PAYMENT header.

3

Query

Call the API endpoint. Payment is verified on-chain. Response is returned instantly.

Quick Start

Discovery
curl https://mcp.usdtbanlist.com/.well-known/x402.json
Check Address ($0.001)
curl -X POST https://mcp.usdtbanlist.com/x402/check \
  -H "Content-Type: application/json" \
  -d '{"address":"TJVHRTVkAYcPSjTWEqtYNLbYkn536MMSsa"}'
MCP Client Config
{
  "mcpServers": {
    "usdtbanlist": {
      "url": "https://mcp.usdtbanlist.com/mcp"
    }
  }
}

Try an endpoint

Select a service, chain, and address.

Service
Address

Powered by USDTBanList

Blacklist data from on-chain USDT/USDC contract events. AML scoring via ChainSentry intelligence.

x402 Protocolx402 DiscoveryMCP Server ConfigWebSocket API DocsEvent TrackerAML Bot (Telegram)Event Bot (Telegram)

Compatible with

Claude DesktopCursorChatGPTAny MCP ClientREST API
x402 Address Intelligence API — Pay-per-Request with USDC | USDTBanList