API Examples

API Examples

Real-world examples of API requests and responses for different risk scenarios.

High Risk Address Example

CRITICAL

Request

curl -H "x-api-key: your-api-key" \
     "https://api.radar.getfailsafe.com/api/v2/intel?address=0x1234567890abcdef1234567890abcdef12345678"

Response

{
  "success": true,
  "data": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "entity": {
      "type": "malicious",
      "name": "Known Exploit Address"
    },
    "risk_assessment": {
      "risk_score": 95.5,
      "risk_level": "critical"
    },
    "recommendation": "IMMEDIATE REVIEW REQUIRED: High-risk entity detected - enhanced due diligence mandatory (Risk Score: 95.5/100 - SEVERE)",
    "classification": "High-Risk Entity",
    "risk_tags": "Critical Risk Indicators; Security Alert Detection; Hacker Address Classification",
    "priority": "URGENT",
    "labels": ["Hacker", "Exploit", "High Risk"],
    "chains_with_activity": ["ethereum", "bsc"]
  },
  "message": "Address intelligence processed successfully",
  "timestamp": "2024-01-15T10:00:01Z",
  "client": "Your Organization"
}

Business Actions for Critical Risk

  • • Block all transactions immediately
  • • Require compliance review
  • • Escalate to senior management
  • • Implement enhanced monitoring

Clean Address Example

CLEAN

Request

curl -H "x-api-key: your-api-key" \
     "https://api.radar.getfailsafe.com/api/v2/intel?address=0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"

Response

{
  "success": true,
  "data": {
    "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "entity": {
      "type": "individual",
      "name": null
    },
    "risk_assessment": {
      "risk_score": 0,
      "risk_level": "clean"
    },
    "recommendation": "APPROVED: Clean risk profile - standard operations authorized",
    "classification": "Clean Entity",
    "risk_tags": "Standard Address Profile",
    "priority": "ROUTINE",
    "labels": [],
    "chains_with_activity": ["ethereum"]
  },
  "message": "Address intelligence processed successfully",
  "timestamp": "2024-01-15T10:00:01Z",
  "client": "Your Organization"
}

Business Actions for Clean Risk

  • • Proceed with standard processing
  • • Apply baseline monitoring
  • • No additional verification required
  • • Normal business operations

Response Field Explanations

Risk Assessment

risk_score

0-100 ML-normalized score. Higher scores indicate greater risk, weighted by severity and frequency.

risk_level

Categorical assessment for business workflows.

Business Intelligence

recommendation

Actionable business guidance based on risk.

priority

Processing queue prioritization level.

Entity Classification

entity.type

Primary entity classification category.

entity.name

Known entity name if available.

Intelligence Data

labels

Detailed risk indicators and classifications.

chains_with_activity

Blockchain networks with detected activity.

Integration Workflow

1

API Authentication

Obtain your API credentials and authenticate using the x-api-key header for secure access

2

Address Analysis

Submit blockchain addresses to the /api/v2/intel endpoint for comprehensive risk analysis

3

Business Implementation

Integrate risk scores and recommendations into your business logic and compliance workflows

Average response time: Sub-second • Cache duration: 24 hours • Uptime: 99.9%

Ready to Get Started?

Follow our comprehensive implementation guide or contact our team to obtain API credentials and begin your integration journey.

Our technical team will assist you with integration and provide personalized API guidance