---
title: "Register a cross-chain order"
method: POST
path: "/xswap/order"
tags: ["Bridge"]
---

# Register a cross-chain order

`POST /xswap/order`

## Request

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

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.

## Request body

- object
  - `user` string, required: EVM address, hex, case-insensitive.
  - `chainIn` 143 | 4663 | 5042, required
  - `chainOut` 143 | 4663 | 5042, required
  - `tokenIn` string, required: EVM address, hex, case-insensitive.
  - `tokenOut` string, required: EVM address, hex, case-insensitive.
  - `amount` string, required: Amount in the token's smallest unit, as a decimal string. Never a float.
  - `slippageBps` integer
  - `recipient` string: 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 `200`

- object
  - `order` object: `{ 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.
  - `quote` object
    - `chainIn` integer
    - `chainOut` integer
    - `tokenIn` string: EVM address, hex, case-insensitive.
    - `tokenOut` string: EVM address, hex, case-insensitive.
    - `amountIn` string: Amount in the token's smallest unit, as a decimal string. Never a float.
    - `amountOut` string: Amount in the token's smallest unit, as a decimal string. Never a float.
    - `legs` union[]
      - union
        - object
          - `kind` 'swap'
          - `chainId` integer
          - `tokenIn` string: EVM address, hex, case-insensitive.
          - `tokenOut` string: EVM address, hex, case-insensitive.
          - `amountIn` string: Amount in the token's smallest unit, as a decimal string. Never a float.
          - `amountOut` string: Amount in the token's smallest unit, as a decimal string. Never a float.
          - `priceImpactPct` number
          - `feeBps` integer: Our tier fee on this leg's output.
          - `dexIds` string[]
        - object
          - `kind` 'bridge'
          - `rail` 'relay' | 'cctp'
          - `chainIdIn` integer
          - `chainIdOut` integer
          - `tokenIn` string: EVM address, hex, case-insensitive.
          - `tokenOut` string: EVM address, hex, case-insensitive.
          - `amountIn` string: Amount in the token's smallest unit, as a decimal string. Never a float.
          - `amountOut` string: Amount in the token's smallest unit, as a decimal string. Never a float.
          - `timeEstimateSec` number
          - `requestId` string: Relay intent id; empty on CCTP until the burn is sent.
          - `srcDomain` integer: CCTP only.
          - `dstDomain` integer: CCTP only.
          - `feeBps` number: Circle's fast-transfer fee, CCTP only.
    - `timeEstimateSec` number
    - `rail` 'relay' | 'cctp'
    - `railReason` string: Why this rail.
    - `fees` object
      - `protocol` object: Our on-chain tier fee per swap leg.
        - `originBps` integer
        - `destBps` integer
        - `usd` number
      - `bridge` object: The bridge's own cut.
        - `rail` string
        - `usd` number
        - `bps` number
        - `appFeeBps` integer: App fee added on Relay.
      - `network` object: Gas we front on the destination.
        - `usd` number: Flat per relayer-paid transaction.
        - `covered` boolean: true = we eat it (Arc mint).
        - `mode` 'user' | 'usdc-gas' | 'gasless' | 'solver' | 'none'
      - `totalUsd` number
    - `gas` object: Who pays gas on each side.
      - `origin` string
      - `dest` string
    - `minAnchorUnits` string: Amount in the token's smallest unit, as a decimal string. Never a float.
    - `bridge` object: Rail-shaped: `{ rail, requestId, checkEndpoint, steps[], fees, details }` — sign `steps` in order on the origin chain (an `approval` item may be skipped when the allowance covers it).
  - `requoteToleranceBps` integer

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- `404`: Nothing at this identity (`NOT_FOUND`, `UNKNOWN_TOKEN`, `NO_ROUTE`).
- `429`: Over the per-minute limit (`RATE_LIMIT_EXCEEDED`). Read `X-RateLimit-Reset` and back off.
- `502`: The routing engine or an upstream did not answer (`ENGINE_ERROR`, `ROUTE_ERROR`).
- `503`: The lane behind this endpoint is not ready or not enabled here (`NOT_READY`, `CHAIN_NOT_ENABLED`, `NOT_ENABLED`, `*_UNAVAILABLE`). Retry later; do not treat it as an empty answer.

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)