Errors

{ "error": { "code": "quote_drifted", "message": "…", "details": {}, "retryAfterMs": 0 } }

details carries what you act on: both figures of a drifted quote, the verdict that refused a venue override.

Code	Status	What to do
`unknown_asset`	400	No venue with fresh state lists that token.
`sender_required` / `recipient_required`	400	Supply the wallet, or the recipient on a cross-VM corridor.
`invalid_refund_address`	400	Not a valid address on the source chain.
`invalid_referral_wallet` / `invalid_referral_bps`	400	Wallet not valid on the source chain’s VM, or rate outside 0 to 15.
`built_mismatch`	400	The signed transaction is not what was built. Nothing was sent.
`invalid_tx_hash`	400	Not a valid hash for the source chain.
`decision_not_found` / `transfer_not_found`	404	Expired, or never existed.
`quote_expired` / `quote_drifted`	409	Quote again and choose again.
`build_expired` / `transfer_not_signable`	409	Build again before signing.
`venue_not_eligible` / `venue_not_in_decision`	409 / 400	The `quoteId` or `venue` override was refused.
`privacy_venue_required`	409	A public venue was built against a private decision.
`below_min`	409	The row would not clear Hyperliquid’s minimum.
`indicative_decision`	409	Indicative pricing cannot be built.
`execution_disabled`	409	Execution is switched off. Quoting still serves.
`tx_not_found`	409	The hash is not visible yet. Retry with the same hash.
`tx_reverted`	409	It matched a built step and reverted. Sign again.
`tx_mismatch`	409	That hash is on chain and is not a step Bridg built. Do not sign again.
`tx_hash_already_claimed`	409	Another order already holds that transaction.
`user_ip_mismatch`	409	A different end user than the venue created the order for.
`rate_limited`	429	Wait `retryAfterMs`.
`broadcast_failed`	502	The chain never saw it. The order is unchanged. Sign again.

Get started

Guides

Concepts

Reference