Skip to main content
GET
/
v2
/
risk
/
address
Score a single address
curl --request GET \
  --url https://api.range.org/v2/risk/address \
  --header 'Authorization: Bearer <token>'
{
  "screen_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
  "network": "ethereum",
  "tier": "high",
  "exposure": {
    "triggered": [
      {
        "signal": "sanctions_ofac",
        "severity": "severe",
        "mode": "binary",
        "result": true,
        "percentage": 42.3,
        "amount_usd": 184500,
        "evidence": [
          {
            "type": "counterparty",
            "summary": "Interacted with OFAC-sanctioned address 0xDEF... on 2026-03-15",
            "details": {
              "address": "0xDEF...",
              "tx_hash": "0x789...",
              "timestamp": "2026-03-15T14:22:00Z",
              "entity": "Tornado Cash",
              "list": "OFAC SDN"
            }
          }
        ],
        "weight": 8
      }
    ],
    "score_contribution": 72
  },
  "behaviour": {
    "detected": [
      {
        "behaviour": "smurfing",
        "confidence": 0.78,
        "severity": "high",
        "evidence": [
          {
            "type": "counterparty",
            "summary": "Interacted with OFAC-sanctioned address 0xDEF... on 2026-03-15",
            "details": {
              "address": "0xDEF...",
              "tx_hash": "0x789...",
              "timestamp": "2026-03-15T14:22:00Z",
              "entity": "Tornado Cash",
              "list": "OFAC SDN"
            }
          }
        ],
        "weight": 7,
        "ignored": false
      }
    ],
    "score_contribution": 15
  },
  "scored_at": "2026-05-04T14:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.range.org/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use Authorization: Bearer

Query Parameters

​
address
string
required
​
network
string
required
​
window
string

Time window for exposure analysis (30d, 90d, 180d, 365d, all). TODO: not yet threaded into queries.

​
include_evidence
string

Include evidence array in response (default true).

Response

200 - application/json
​
screen_id
string
required
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
address
string
required
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28"

​
network
string
required
Example:

"ethereum"

​
tier
enum<string>
required
Available options:
severe,
high,
medium,
low
Example:

"high"

​
exposure
object
required
​
behaviour
object
required
​
scored_at
string
required
Example:

"2026-05-04T14:30:00Z"

Last modified on May 19, 2026