API REFERENCE

REST Endpoints

Fetch historical alerts and TVL history.

GET

/api/alerts

Returns a paginated list of alerts across all monitored protocols.

Query Parameter	Description
limit	Results per page (default: 25)
offset	Pagination offset (default: 0)
protocol	Filter by protocol pubkey
rule_triggered	Filter by rule string
min_severity	Filter by minimum score
search	Search by Alert ID or tx hash

curlbash

curl "https://sentinel-guard-three.vercel.app/api/alerts?limit=5&min_severity=75"

responsejson

[
  {
    "id": "a1b2c3d4e5f6",
    "protocol": "9W95BjbZuXdwf6p7X3bHu3wnMb2R5y7A4K",
    "rule_triggered": "TVL_VELOCITY",
    "severity": 87,
    "estimated_at_risk_usd": 125000,
    "on_chain_tx": "5KtPn1LGuxhFiwjxErkxTb57Jvmh4Me5GA4K9v7FWE1vL4jE8D2m8HrZ3bVtBQzPLr",
    "slot": 245012344,
    "created_at": "2026-05-15T10:23:41.000Z"
  }
]

GET

/api/tvl

Returns TVL snapshot history for a protocol, ordered by slot ascending. Use this to chart TVL over time.

Query Parameter	Description
protocol	Required. Protocol pubkey to fetch.

curlbash

curl "https://sentinel-guard-three.vercel.app/api/tvl?protocol=9W95BjbZuXdwf6p7X3bHu3wnMb2R5y7A4K"

responsejson

[
  { "slot": 245012300, "tvl_usd": 1200000, "timestamp": "2026-05-15T10:20:00.000Z" },
  { "slot": 245012320, "tvl_usd": 1195000, "timestamp": "2026-05-15T10:20:08.000Z" },
  { "slot": 245012344, "tvl_usd": 980000,  "timestamp": "2026-05-15T10:20:17.000Z" }
]