Skip to main content
GET
/
v1
/
audit
List recent audit receipts
curl --request GET \
  --url https://api.pegana.xyz/v1/audit
[
  {
    "asset": "<string>",
    "detected_at": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "methodology_version": "<string>",
    "receipt_sha256": "<string>",
    "onchain_tx_sig": "<string>"
  }
]

Query Parameters

​
limit
integer<int32>

Page size. Default 50, clamped to 100 per ADR-0014.

Required range: x >= 0
​
exclude_pegged
boolean

When true (default), filter out PEGGED end-state rows. PEGGED is the "recovered" state — usually noise from the index perspective.

​
state
string

Server-side filter on the to_state value. Closes AC42 — the previous client-side filter on the web/audit page was correct in shape but constrained to whatever batch the index returned (default 50 rows). With server filtering the full limit applies to matching rows. Valid values: PEGGED, DRIFT, DEPEG, CRITICAL, BLACK_SWAN. Any other value yields HTTP 400 with error: invalid_state.

Response

Index of recent audits, newest first

​
asset
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
required
​
methodology_version
string
required
​
receipt_sha256
string
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
​
onchain_tx_sig
string | null