Bridge

Cross-chain swap plan

Quotes a token on one chain into a token on another two ways at once — composed (Chord's router on the origin → USDC/USDG rail → Chord's router on the destination) and direct (Relay end to end) — and names the one that lands more. Long-tail tokens on Arc / Monad / Robinhood only route on the composed path. Fees come back as three lines (protocol · bridge · network) and gas says who pays on each side. MIN_SIZE below 10 USD of the bridged stable.

post/xswap/plan

Request

  • Base URL: https://api.getchord.xyz/v1
  • URL: https://api.getchord.xyz/v1/xswap/plan
  • 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).

Response

best'composed' | 'direct'
errorsobject

Per-path failure { code, message } when a path could not be quoted.

Changes

No recorded changes to this operation across all 1 revision of this API.