Public API

Endpoints, errors, versioning, and limits.

Endpoints

MethodPathDescription
POST/v1/intentSubmit unsigned intent; returns candidate id
GET/v1/quotes?intent=…Aggregated quotes and routes
POST/v1/planBuild execution plan
POST/v1/settleSubmit signed transaction
GET/v1/receipt/{id}Fetch execution receipt

Errors

CodeHTTPMeaning
INTENT_INVALID400Malformed fields
NO_LIQUIDITY409Constraints cannot be satisfied
TTL_EXPIRED410Quote expired
SLIPPAGE_BREACH422Realized worse than bound
ROUTER_REVERT500On‑chain execution failed

Authentication & Limits

  • mTLS or API keys for maker endpoints.
  • User endpoints rate‑limited per session and IP.
  • Versioning via Accept header: application/vnd.veil.v1+json