Submit a signed bridge for execution
/bridge /{bridge_quote_id} /submitFor a delivery: submit quote only (a self_broadcast quote answers
400 quote_not_submittable). Treasures checks the signatures recover to your wallet over
exactly the payload /bridge/quote issued, then runs it: an EVM origin's typed data is
executed by the upstream bridge (its gas taken from the amount); a Solana origin's signed
transaction is broadcast by Treasures.
One submission per quote: the same body may be resubmitted (idempotent) for up to an hour.
After a 502 it may have gone through, so resubmit the SAME body, never a new one; a
resubmission that still cannot tell answers 502 again, so poll status rather than
re-quote. Track the fill with GET /bridge/{bridge_quote_id}/status.
Request
Responses
- 200
- 400
- 403
- 404
- 409
- 410
- 422
- 429
- 502
- 503
Broadcast.
Malformed body; signatures or a signed transaction that do not match the quote
(signed_tx_mismatch, field names the part); or a self_broadcast quote
(quote_not_submittable).
A wallet on the request was flagged by sanctions screening. Permanent; do not retry with the same wallet.
Unknown bridge_quote_id.
bridge_already_submitted: this quote already holds a submission, or its retry
window has passed. Poll status; never sign a second deposit.
The quote expired (or its Solana blockhash did), or the bridge refused an EVM permit that can no longer run. Re-quote.
Refused before anything moved (for example, too little balance). Fix it, then re-quote. Solana origins only; a refused EVM permit answers 410.
Sliding window exceeded: per-IP or per-(IP, wallet), plus a per-organisation bucket (shared across all of your keys) whenever a valid X-API-Key is presented. Retry-After header carries delta-seconds.
The outcome is unknown. Resubmit the same body.
Sanctions screening could not be completed and the request was rejected (fail-closed). Transient; back off and retry.