Quote USDC → stock token (up to 2 legs, one per chain, better first)
POST/quote/buy
Requires ownership_proof for each wallet provided. Returns up to two
signable quote legs (one per chain). Cache the returned quote_id;
every signed leg is 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.
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.