Quote stock holdings → USDC (all legs needed; all-or-nothing submit)
POST/quote/sell
Plans the optimal sequence of swap legs across the user's current holdings.
Every returned leg must be signed and submitted together at /trade/submit.
Request
Responses
- 200
- 400
- 401
- 403
- 410
- 422
- 429
- 502
- 503
OK
Invalid request body, slippage out of range, unknown ticker, or zero amount.
Ownership-proof failure.
A wallet on the request was flagged by sanctions screening. Permanent — do not retry with the same wallet.
Quote stale (upstream price moved past expiry mid-build).
No fillable routes returned by the planner, or insufficient holdings for the requested share amount.
Per-IP or per-(IP, wallet) sliding window exceeded. Retry-After header carries delta-seconds.
Upstream provider failed or rate-limited us.
Sanctions screening could not be completed and the request was rejected (fail-closed). Transient — back off and retry.