Peg events

A peg-break event is a continuous period where a stable's spread exceeded threshold.

GET /v1/stablecoins/{address}/peg-events

Free tier.

curl "https://pelletfi.com/api/v1/stablecoins/0x20c000000000000000000000b9537d11c60e8b50/peg-events?limit=20"

Response

{
  "address": "0x20c000000000000000000000b9537d11c60e8b50",
  "events": [
    {
      "severity": "mild",
      "started_at": "2026-04-12T03:14:22Z",
      "ended_at": "2026-04-12T03:24:08Z",
      "duration_seconds": 586,
      "max_deviation_bps": 23.5,
      "started_block": 14702991,
      "ended_block": 14703577,
      "ongoing": false
    }
  ]
}

Ongoing events

If ended_at is null and ongoing is true, the peg break is still active as of the last detector run (every 2 minutes). The event row is updated in place each run as the duration / max deviation grows.

Webhook events

This endpoint is also the source of these webhook events:

• peg_break.started — fires when a new event is detected
• peg_break.ended — fires when a previously-ongoing event closes

See Webhooks for delivery and signature details.

Time-travel (?as_of=)

curl 'https://pelletfi.com/api/v1/stablecoins/0x20c0.../peg-events?as_of=2026-04-13'

Returns only events that had started at or before as_of. If an event ended after as_of, the ended_at is nulled in the response and ongoing flips to true — because at the historical moment, the event was still in flight.