V3 Blacklist Endpoint

GET /api/v3/blacklist/:address

Quick check for stablecoin blacklist status. This endpoint is optimized for fast, lightweight lookups and does not require authentication.

Request

URL

GET https://api.radar.getfailsafe.com/api/v3/blacklist/:address

Path Parameters

addressRequired
Blockchain address to check

Response

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "chain": "ethereum",
  "is_blacklisted": true,
  "blacklists": {
    "usdt": true,
    "usdc": false
  },
  "source": "on-chain",
  "confidence": 1.0,
  "latency_ms": 127
}

Response Fields

FieldTypeDescription
addressstringThe queried address
chainstringDetected blockchain network
is_blacklistedbooleanTrue if on any stablecoin blacklist
blacklists.usdtbooleanTether (USDT) blacklist status
blacklists.usdcbooleanCircle (USDC) blacklist status
sourcestringData source (on-chain, proprietary)
confidencenumberConfidence score (0.0 - 1.0)
latency_msnumberRequest processing time in ms

Example Responses

Blacklisted Address

{
  "address": "0xd882cfc20f52f2599d84b8e8d58831bf615068b1",
  "chain": "ethereum",
  "is_blacklisted": true,
  "blacklists": {
    "usdt": true,
    "usdc": true
  },
  "source": "on-chain",
  "confidence": 1.0,
  "latency_ms": 89
}

Clean Address

{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "chain": "ethereum",
  "is_blacklisted": false,
  "blacklists": {
    "usdt": false,
    "usdc": false
  },
  "source": "on-chain",
  "confidence": 1.0,
  "latency_ms": 95
}

Non-EVM Address

{
  "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "chain": "bitcoin",
  "is_blacklisted": false,
  "blacklists": {
    "usdt": false,
    "usdc": false
  },
  "source": "chain_detection",
  "confidence": 1.0,
  "latency_ms": 12,
  "note": "Stablecoin blacklists only apply to EVM addresses"
}

Rate Limits

/api/v3/blacklist/:address

Stablecoin blacklist check

300 requests/minute

Sample cURL Request

curl https://api.radar.getfailsafe.com/api/v3/blacklist/0x1234567890abcdef1234567890abcdef12345678

Common Use Cases

Pre-Transaction Checks

Quick validation before processing stablecoin transfers to avoid frozen funds.

Compliance Screening

Fast blacklist checks during user onboarding or KYC processes.

Bulk Validation

High-volume address screening with 300 req/min rate limit.

Real-Time Monitoring

Continuous monitoring of counterparty addresses in DeFi protocols.

Need Full Intelligence?

For comprehensive risk assessment, use the Intel endpoint.