V3 Batch Endpoint

POST /api/v3/intel/batch

Process multiple addresses in a single request with optimized rate limiting and concurrent processing controls.

Request

URL

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

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body

{
  "addresses": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "TL6YQvHEAjeknZaGLbtQ67fgpsDCRA3zQ9",
    "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  ],
  "options": {
    "include_details": false,
    "batch_size": 3
  }
}

Request Parameters

FieldTypeRequiredDescription
addressesarrayYesArray of addresses (1-25 items)
options.batch_sizenumberNoConcurrent processing size (1-10, default: 3)
options.include_detailsbooleanNoInclude raw source data (default: false)

Response

{
  "results": [
    {
      "address": "0x1234...",
      "score": 75,
      "risk_level": "high",
      "confidence": 0.89,
      "flags": {
        "sanctioned": false,
        "blacklisted": true,
        "threat_actor": false,
        "smart_money": false
      },
      "signals": [...],
      "recommendation": {
        "action": "REVIEW",
        "summary": "Address blacklisted by USDT issuer",
        "ai_enhanced": true
      },
      "metadata": {
        "version": "v3",
        "latency_ms": 2847
      }
    },
    // ... more results
  ],
  "summary": {
    "total": 3,
    "successful": 3,
    "failed": 0,
    "critical": 1,
    "high": 1,
    "medium": 0,
    "low": 1,
    "minimal": 0
  },
  "metadata": {
    "version": "v3",
    "latency_ms": 8432,
    "correlation_id": "req_abc123",
    "timestamp": "2025-01-06T10:30:00.000Z"
  }
}

Summary Fields

Batch Summary

The summary object provides aggregated metrics for the batch request:

total

Total addresses

successful

Processed OK

failed

Process errors

critical

Score 85-100

high

Score 60-84

medium

Score 35-59

low

Score 15-34

minimal

Score 0-14

Best Practices

Optimal Batch Size

Use batch_size: 3 for best balance of throughput and reliability. Higher values may trigger rate limits.

Mixed Chains Supported

You can mix addresses from different chains (EVM, Bitcoin, Tron, etc.) in a single batch request.

Handle Partial Failures

Check the summary.failed count and handle individual address errors gracefully.

Cache High-Risk Results

High-risk scores (60+) are stable; cache for 10 minutes to reduce API calls.

Rate Limits

/api/v3/intel/batch

Batch intelligence endpoint

10 requests/minute

Sample cURL Request

curl -X POST https://api.radar.getfailsafe.com/api/v3/intel/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      "0x1234567890abcdef1234567890abcdef12345678",
      "TL6YQvHEAjeknZaGLbtQ67fgpsDCRA3zQ9",
      "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
    ],
    "options": {
      "include_details": false,
      "batch_size": 3
    }
  }'

Next Steps

Explore the blacklist endpoint for quick checks or learn about migration.