V3 Intel Endpoint

POST /api/v3/intel

Primary intelligence endpoint for comprehensive address risk assessment with AI-enhanced scoring and contextual recommendations.

Request

URL

POST https://api.radar.getfailsafe.com/api/v3/intel

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "options": {
    "include_details": false,
    "chain": "auto",
    "enable_agentic": true
  }
}

Request Parameters

FieldTypeRequiredDescription
addressstringYesWallet address (26-128 chars)
options.include_detailsbooleanNoInclude raw source data (default: false)
options.chainstringNoChain hint or "auto" for detection
options.enable_agenticbooleanNoEnable AI score calibration (default: true)

Response

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "score": 75,
  "risk_level": "high",
  "confidence": 0.89,
  "flags": {
    "sanctioned": false,
    "blacklisted": true,
    "threat_actor": false,
    "smart_money": false
  },
  "entity": {
    "name": "Unknown Entity",
    "type": "wallet",
    "category": "unknown"
  },
  "signals": [
    {
      "type": "stablecoin_blacklist",
      "weight": 95,
      "source": "proprietary"
    }
  ],
  "labels": ["USDT Blacklisted", "High Risk Activity"],
  "recommendation": {
    "action": "REVIEW",
    "summary": "Address blacklisted by USDT issuer - manual compliance review required",
    "details": "This address has been blacklisted by a major stablecoin issuer...",
    "ai_enhanced": true
  },
  "metadata": {
    "version": "v3",
    "latency_ms": 2847,
    "sources_used": 5,
    "is_complete": true,
    "timestamp": "2025-01-06T10:30:00.000Z"
  }
}

Response Fields

Risk Score (0-100)

The V3 score is a composite risk assessment calibrated across multiple intelligence sources.

Score RangeRisk LevelRecommended Action
85-100CRITICALBlock transaction
60-84HIGHRequire manual review
35-59MEDIUMEnhanced monitoring
15-34LOWStandard processing
0-14MINIMALAllow transaction

Flags

Boolean indicators for critical risk categories:

sanctionedAddress linked to sanctioned entity (OFAC, EU, etc.)
blacklistedOn stablecoin issuer blacklist (USDT, USDC)
threat_actorAssociated with known threat actors (hackers, scammers)
smart_moneyIdentified as sophisticated/institutional wallet

Signals

Top contributing factors to the risk score:

{
  "type": "sanctions_match",
  "weight": 100,
  "source": "proprietary"
}

Recommendation

AI-enhanced recommendation with contextual analysis:

actionALLOW, ALLOW_CAUTIOUS, MONITOR, REVIEW, BLOCK
summary1-2 sentence contextual summary
detailsDetailed reasoning for the recommendation
ai_enhancedWhether AI calibration was applied

Supported Chains

Multi-Chain Auto-Detection

V3 automatically detects chain from address format

ChainAddress FormatExample
Ethereum/EVM0x + 40 hex chars0x742d35Cc6634C0532925a3b844Bc454e4438f44e
Bitcoinbc1/1/3 prefixbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
TronT prefix, base58TL6YQvHEAjeknZaGLbtQ67fgpsDCRA3zQ9
Solana32-44 base58 chars5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d
TONUQ/EQ prefixUQBvW8Z5huBkMJYdnfAEM5JqTNLZpKAoJ
DogecoinD prefixD7Y55GyP3QJQnvfTh2zEfPPP3s45B1mFpD

Sample cURL Request

curl -X POST https://api.radar.getfailsafe.com/api/v3/intel \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "options": {
      "include_details": false,
      "enable_agentic": true
    }
  }'

Next Steps

Explore batch processing or check out the migration guide.