Skip to main content
GET
/
v1
/
risk
/
alert-events
/
{event_id}
Get a single alert event by ID
curl --request GET \
  --url https://api.range.org/v1/risk/alert-events/{event_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "clxyz1234abcd",
  "time": "2026-05-10T14:22:00.000Z",
  "network": "ethereum",
  "addresses_involved": [
    "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28"
  ],
  "created_at": "2026-05-10T14:22:05.000Z",
  "details": {
    "amount": 5000000,
    "token": "USDC",
    "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
    "to": "0xAbC...123"
  },
  "severity": "high",
  "caption": "Large USDC transfer detected",
  "access_type": "same",
  "tx_hash": "0xabc123...def456",
  "block_number": 19823401,
  "alert_rule_id": "7890123456789012"
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer

Path Parameters

event_id
string
required

CUID of the alert event to retrieve.

Example:

"clxyz1234abcd"

Response

200 - application/json
id
string
required

Unique identifier of the alert event.

Example:

"clxyz1234abcd"

time
string
required

ISO 8601 timestamp of when the on-chain event occurred.

Example:

"2026-05-10T14:22:00.000Z"

network
string
required

Network slug where the event occurred.

Example:

"ethereum"

addresses_involved
string[]
required

List of blockchain addresses involved in the event.

Example:
[
"0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28"
]
created_at
string
required

ISO 8601 timestamp of when the event record was created.

Example:

"2026-05-10T14:22:05.000Z"

details
object
required

Arbitrary structured data specific to the event type.

Example:
{
"amount": 5000000,
"token": "USDC",
"from": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
"to": "0xAbC...123"
}
severity
enum<string>
required

Risk severity of the event.

Available options:
low,
medium,
high
Example:

"high"

caption
string
required

Human-readable caption describing the event.

Example:

"Large USDC transfer detected"

access_type
enum<string>
required

Caller's access relationship to this event.

Available options:
global,
same,
diff,
none
Example:

"same"

tx_hash
string | null

Transaction hash associated with the event.

Example:

"0xabc123...def456"

block_number
number | null

Block number at which the event was detected.

Example:

19823401

alert_rule_id
string | null

ID of the alert rule that produced this event.

Example:

"7890123456789012"

Last modified on July 1, 2026