Skip to content
Crifine

Error reference

Branch on `code`, never on `message`.

Error shape
{
  "error": {
    "code": "size_required",
    "message": "size_usd is required — an estimate without a size is meaningless.",
    "docs": "https://docs.crifine.app/api/exit"
  }
}
StatusCodeWhat to do
400size_requiredPass size_usd. There is no default, deliberately.
400size_out_of_rangeSizes below $1,000 or above $500M are rejected rather than guessed at.
402payment_requiredSettle the quoted amount and retry with X-Payment-Proof.
404pool_not_foundCheck GET /v1/pools. The pool may not be under recording yet.
409insufficient_historyThe pool has fewer observed days than the requested window. Shorten the window or accept a lower days_observed.
429rate_limitedBack off using Retry-After. Applies to free verification endpoints only.
503recorder_gapA depth snapshot window was missed and the result would be unsound. Retry; do not fall back to oracle price.