Skip to main content
GET
/
v2
/
risk
/
address
/
batch
Score Multiple Addresses
curl --request GET \
  --url https://api.range.org/v2/risk/address/batch \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "screen_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
      "address_active_on": [
        "ethereum",
        "polygon"
      ],
      "total_incoming_usd": 1842300.45,
      "total_outgoing_usd": 1798450.12,
      "malicious_incoming_usd": 184500,
      "malicious_outgoing_usd": 92300,
      "severity": "high",
      "attribution": {
        "triggered": [
          {
            "signal": "sanctions_ofac",
            "severity": "severe",
            "result": true
          }
        ]
      },
      "exposure": {
        "triggered": [
          {
            "signal": "compliance-risk",
            "mode": "absolute",
            "result": true,
            "summary": "42.30% of counterparty volume is compliance-risk, crossing the 5% (high) threshold.",
            "severity": "high",
            "total_usd": 184500,
            "percentage": "42.30%"
          }
        ]
      },
      "behaviour": {
        "detected": [
          {
            "behaviour": "smurfing",
            "severity": "high",
            "confidence": 0.78
          }
        ]
      },
      "timestamp": "2026-05-04T14:30:00Z",
      "meta": {
        "es_attribution_ms": 120,
        "config_ms": 5,
        "ch_counterparties_ms": 340,
        "ch_totals_ms": 80,
        "es_interchain_ms": 210,
        "helius_ms": 150,
        "features_redis_ms": 60,
        "counterparty_attribution_ms": 0,
        "parallel_ms": 350,
        "total_ms": 410
      },
      "evidence": {}
    }
  ],
  "meta": {
    "total": 5,
    "scored": 5,
    "errors": 0
  }
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer

Query Parameters

addresses
string
required

Comma-separated list of addresses (max 50).

window
string

Time window for analysis: 30d, 90d, 180d, 365d, or all.

include_evidence
string

Response

200 - application/json
items
object[]
required
meta
object
required
Last modified on May 19, 2026