Batch Analysis Endpoint

When to Use

• Analyzing 4+ projects at once
• Portfolio analysis and comparison
• Investment screening of multiple options
• Want to save 25% on per-project costs

Request

{
  "projects": [
    {"address": "0xAAA...", "chain": "ethereum"},
    {"address": "0xBBB...", "chain": "bsc"},
    {"address": "0xCCC...", "chain": "polygon"}
  ],
  "report_type": "standard"
}

Parameters

Field	Type	Required	Description
projects	array	Yes	Array of project objects
report_type	string	No	quick, standard, or deep_dive

Limits

• Minimum: 1 project
• Maximum: 50 projects per batch
• Discount applies to all projects in batch

Response

{
  "batch_id": "batch_abc123xyz",
  "status": "completed",
  "total_projects": 3,
  "completed": 3,
  "failed": 0,
  "results": [
    {
      "project_address": "0xAAA...",
      "chain": "ethereum",
      "status": "success",
      "report": {
        "risk_score": 45,
        "risk_level": "MEDIUM",
        ...
      }
    },
    {
      "project_address": "0xBBB...",
      "chain": "bsc",
      "status": "success",
      "report": {
        "risk_score": 78,
        "risk_level": "CRITICAL",
        ...
      }
    },
    ...
  ]
}

Response Fields

Field	Type	Description
batch_id	string	Unique batch identifier
status	string	processing, completed, partial_failure
results	array	Individual project reports
report	object	Full report based on report_type

import x402_requests

# Analyze multiple projects and rank by safety
projects_to_check = [
    {"address": "0xAAA...", "chain": "ethereum"},
    {"address": "0xBBB...", "chain": "bsc"},
    {"address": "0xCCC...", "chain": "polygon"}
]

response = x402_requests.post(
    'https://csds.blockchainrangers.com/api/v1/batch',
    json={
        'projects': projects_to_check,
        'report_type': 'standard'
    }
)

batch = response.json()

# Sort by risk score (lowest = safest)
results = sorted(
    batch['results'],
    key=lambda x: x['report']['risk_score']
)

print(f"Analyzed {batch['total_projects']} projects")
print(f"Total cost: ${batch['total_projects'] * 0.75}\n")

print("Projects ranked by safety (safest first):")
for i, result in enumerate(results, 1):
    report = result['report']
    print(f"{i}. {result['chain']} - Risk: {report['risk_score']}/100 ({report['risk_level']})")
    print(f"   Address: {result['project_address']}")
    print(f"   Recommendation: {report.get('recommendation', {}).get('verdict', 'N/A')}\n")