Skip to main content
GET
/
v1
/
alerts
List recent state-transition alerts
curl --request GET \
  --url https://api.pegana.xyz/v1/alerts
[
  {
    "asset": "<string>",
    "class": "<string>",
    "detected_at": "2023-11-07T05:31:56Z",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "dispatched_at": "2023-11-07T05:31:56Z"
  }
]

Query Parameters

​
asset
string

Restrict to a single asset symbol.

​
class
string

Restrict to a single asset class.

​
limit
integer<int64>

Page size, must be in [1, 500]. Default 50. Out-of-range values are rejected with 400 rather than silently clamped.

​
since
string<date-time>

Inclusive lower bound on detected_at. Defaults to now − 7 days.

Response

Global alert feed, newest first

​
asset
string
required
​
class
string
required
​
detected_at
string<date-time>
required
​
from_state
enum<string>
required

Class-aware peg state. Mirrors the engine PegState enum and the peg_state Postgres enum. Used for state, from_state, and to_state fields across the API.

The state is CLASS-AWARE: an LST reading a −1.4% discount (normal unstaking spread) is PEGGED, while a fiat stable at far less would be DRIFT. Trust this value directly rather than imposing a naive discount cut.

Available options:
PEGGED,
DRIFT,
DEPEG,
CRITICAL,
BLACK_SWAN,
UNKNOWN
​
id
string<uuid>
required
​
to_state
enum<string>
required

Class-aware peg state. Mirrors the engine PegState enum and the peg_state Postgres enum. Used for state, from_state, and to_state fields across the API.

The state is CLASS-AWARE: an LST reading a −1.4% discount (normal unstaking spread) is PEGGED, while a fiat stable at far less would be DRIFT. Trust this value directly rather than imposing a naive discount cut.

Available options:
PEGGED,
DRIFT,
DEPEG,
CRITICAL,
BLACK_SWAN,
UNKNOWN
​
dispatched_at
string<date-time> | null

None while the dispatcher is still attempting delivery; populated once at least one fan-out target accepted the alert.