Skip to main content
GET
/
v1
/
risk
/
alert-events
List alert events for the workspace
curl --request GET \
  --url https://api.range.org/v1/risk/alert-events \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "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",
      "tx_hash": "0xabc123...def456",
      "block_number": 19823401,
      "alert_rule_id": "7890123456789012"
    }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "previous_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "first_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "last_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
    "total_count": 100,
    "page_number": 1
  }
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer

Query Parameters

limit
number
default:10

Maximum number of records to return (1-100). Defaults to 10.

Required range: 1 <= x <= 100
Example:

20

cursor
string

Opaque pagination cursor. Omit for the first page, then pass meta.next_cursor / meta.previous_cursor from a previous response to move between pages. meta.first_page_cursor (A) and meta.last_page_cursor (Z) jump to the first/last page. Results are ordered newest-first by a server-side cursor; treat the value as opaque — do not construct or modify it.

Example:

"eyJwIjoyLCJjIjoiMjkxNzM0NDYyNDg0NDM0OTk1MyIsImIiOmZhbHNlfQ"

network
string

Filter by network slug (e.g. ethereum, solana).

Example:

"ethereum"

tx_hash
string

Filter by exact transaction hash.

Example:

"0xabc123...def456"

start_date
string

Start of date range in YYYY-MM-DD format (inclusive, UTC).

Example:

"2026-05-01"

end_date
string

End of date range in YYYY-MM-DD format (inclusive, UTC).

Example:

"2026-05-31"

severity
string

Comma-separated list of severity levels to filter by (e.g. low,medium,high).

Example:

"high,medium"

search_string
string

Case-insensitive search across event caption and addresses involved.

Example:

"0x742d35"

Response

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