Recipes

Task-first snippets. All are public (no key), rate-limited per IP, and return the Response format conventions (decimal strings, RFC3339 timestamps). A runnable reference adapter (TypeScript + Python) lives in the repo at docs/examples/asset-consumer/.

Is this asset pegged right now?

Read the class-aware verdict — don’t re-threshold discount yourself.

curl -s https://api.pegana.xyz/v1/assets/USDC/state
# { "asset":"USDC","state":"PEGGED","discount":"-0.0001","updated_at":"…Z","stale":false }

Always gate on stale (and updated_at freshness). A stale:true or UNKNOWN reading means “no trustworthy signal”, not “healthy” — fail safe.

Watch the whole universe in one call

curl -s https://api.pegana.xyz/v1/assets | jq '.data[] | {symbol, state, risk_score, discount}'

List endpoints return the envelope { ok, generated_at, count, data } — read the rows from .data. Prefer risk_score (0–100) for a single sortable number, or branch on state. To join by Solana mint, use GET /v1/peg/feed (also a data array; each signal carries mint).

Only surface what’s off-peg

curl -s https://api.pegana.xyz/v1/assets \
  | jq '[ .data[] | select(.state != "PEGGED" and .state != "UNKNOWN") ]'

Chart the discount history

curl -s "https://api.pegana.xyz/v1/assets/jitoSOL/history?from=2026-07-23T00:00:00Z&bucket=1m" \
  | jq '.data[] | {ts, discount, state}'

bucket=raw for per-sample, 1m for 1-minute aggregates. Newest-first; window with from/to (see Pagination & limits).

Verify a state transition on your own machine

Every alert emits a public receipt with frozen inputs and an on-chain commit.

curl -s https://api.pegana.xyz/v1/audit/<alert_id>
# re-derive it byte-exact with the CLI (add --json for a CI-friendly verdict line):
cargo install pegana-replay && pegana-replay --alert-id <alert_id>

Gauge systemic (leverage) exposure

curl -s https://api.pegana.xyz/v1/assets/JLP/loop-exposure \
  | jq '{loop_exposure_usd, coverage, cascade}'

Advisory, anonymous-by-construction — see the Systemic impact section for the full model.

WebSocket

Sub-second push instead of polling.

Webhooks

Signed POST on every state transition.

MCP for agents

Point an LLM agent straight at the oracle.

Errors

Codes + the x-request-id header.

Get Started

Concepts

Methodology

Integration Guides

Case Studies

Resources

Is this asset pegged right now?

Watch the whole universe in one call

Only surface what’s off-peg

Chart the discount history

Verify a state transition on your own machine

Gauge systemic (leverage) exposure

WebSocket

Webhooks

MCP for agents

Errors

​Is this asset pegged right now?

​Watch the whole universe in one call

​Only surface what’s off-peg

​Chart the discount history

​Verify a state transition on your own machine

​Gauge systemic (leverage) exposure

WebSocket

Webhooks

MCP for agents

Errors

Is this asset pegged right now?

Watch the whole universe in one call

Only surface what’s off-peg

Chart the discount history

Verify a state transition on your own machine

Gauge systemic (leverage) exposure