Bridge

Register a cross-chain order

Quotes and records the order the wallet is about to sign so it can be resumed after a refresh: the server tracks the bridge (Relay status or Circle attestation), mints CCTP transfers on Arc, and re-quotes the final leg at the amount that actually arrived. Poll GET /xswap/order?id=. path: "direct" registers the Relay end-to-end candidate instead.

post/xswap/order

Request

  • Base URL: https://api.getchord.xyz/v1
  • URL: https://api.getchord.xyz/v1/xswap/order
  • Auth: none declared

Request body

userstring required

EVM address, hex, case-insensitive.

chainIn143 | 4663 | 5042 required
chainOut143 | 4663 | 5042 required
tokenInstring required

EVM address, hex, case-insensitive.

tokenOutstring required

EVM address, hex, case-insensitive.

amountstring required

Amount in the token's smallest unit, as a decimal string. Never a float.

slippageBpsinteger
recipientstring

EVM address, hex, case-insensitive.

rail'auto' | 'relay' | 'cctp'

Force a rail; auto applies the corridor rules (Robinhood → Relay; Monad ↔ Arc → CCTP when the mint relayer is funded; else Relay).

path'composed' | 'direct'

Response

orderobject

{ id, state, rail, chainIn, chainOut, tokenIn, tokenOut, amountIn, quotedOut, requestId, originTxHash?, destTxHash?, bridgedAmount?, destQuote?, claim?, note? } — states: pending_origin · bridging · pending_dest · done · stuck_dest · failed_origin.

requoteToleranceBpsinteger

Changes

No recorded changes to this operation across all 2 revisions of this API.