Skip to content
Crifine
DocumentationAPI referencePackagesChangelog

Alerting

Fire the moment a market crosses your threshold, not on the next poll.

An alert is a threshold on exit_gap_pct at a stated size, for a stated pool. All three parts are required — a threshold without a size is not a condition, because the same book is fine at $100k and catastrophic at $5M.

Register a threshold
curl -X POST "https://api.crifine.app/v1/alerts" \
  -H "Content-Type: application/json" \
  --data '{
    "pool": "uniswap-v3-zec",
    "size_usd": 500000,
    "threshold_pct": -4.0,
    "channel": "webhook",
    "url": "https://your-stack.example/crifine"
  }'

The delivered payload

{
  "event": "spread.threshold.breached",
  "pool": "uniswap-v3-zec",
  "size_usd": 500000,
  "threshold_pct": -4.00,
  "current_pct": -11.40,
  "depth_change_24h_pct": -31.8,
  "as_of": "2026-08-29T14:02:11Z",
  "evidence_url": "https://crifine.app/api/v1/exit/uniswap-v3-zec"
}