Compute Route

This is the first step when bridging tokens between chains. Call this endpoint with your source and destination assets to find the optimal transfer route. The response includes the expected output amount, USD value estimates, and an ordered list of operations.

After receiving a route, pass the full response (including operations) to the Generate Transaction endpoint (POST /v2/fungible/msgs) to get signable transaction messages you can broadcast.

POST /v2/fungible/route

Compute Route

cURL

curl --request POST \
  --url https://router-api.initia.xyz/v2/fungible/route \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount_in": "1000000",
  "source_asset_chain_id": "interwoven-1",
  "source_asset_denom": "uinit",
  "dest_asset_chain_id": "8453",
  "dest_asset_denom": "0x...",
  "allow_unsafe": true
}
'

200

{
  "amount_in": "1000000",
  "amount_out": "999000",
  "source_asset_chain_id": "interwoven-1",
  "source_asset_denom": "uinit",
  "dest_asset_chain_id": "8453",
  "dest_asset_denom": "0x...",
  "operations": [],
  "required_chain_addresses": [
    "interwoven-1",
    "8453"
  ],
  "chain_ids": [
    "interwoven-1",
    "8453"
  ],
  "does_swap": false,
  "estimated_amount_out": "999000",
  "estimated_fees": [],
  "estimated_route_duration_seconds": 60,
  "txs_required": 1,
  "swap_venues": [],
  "usd_amount_in": "1.50",
  "usd_amount_out": "1.49",
  "warning": null,
  "extra_warnings": null,
  "required_op_hook": false
}

Body

application/json

amount_in · string · required

Amount to send in the smallest denomination (e.g. "1000000" for 1 INIT).

source_asset_chain_id · string · required

Source chain ID.

source_asset_denom · string · required

Source asset denomination.

dest_asset_chain_id · string · required

Destination chain ID.

dest_asset_denom · string · required

Destination asset denomination.

allow_unsafe · boolean · default: true

Allow routes that may have higher risk.

go_fast · boolean

Use Go Fast bridging. Automatically determined if not set.

is_op_withdraw · boolean

Force an Optimistic withdrawal route.

Response

200 - application/json

Successful response

amount_in · string

Input amount.

amount_out · string

Expected output amount.

source_asset_chain_id · string

Source chain ID.

source_asset_denom · string

Source asset denom.

dest_asset_chain_id · string

Destination chain ID.

dest_asset_denom · string

Destination asset denom.

operations · object[]

Ordered list of transfer operations to execute.

required_chain_addresses · string[]

All chain IDs that require an address, in order of usage by operations in the route. Use this to populate the address_list parameter in the Generate Transaction request.

chain_ids · string[]

Ordered list of all chain IDs involved in the route.

does_swap · boolean

Whether the route involves a token swap.

estimated_amount_out · string

Estimated output amount before fees and slippage adjustments.

estimated_fees · object[]

Estimated fees for the route. Each entry describes a fee with its amount, behavior, and the originating asset.

Show child attributes

estimated_route_duration_seconds · integer | null

Estimated time in seconds for the route to complete.

txs_required · integer

Number of transactions required to execute the route.

swap_venues · object[]

DEX venues used for swaps in the route, if any.

Show child attributes

swap_venue · object

Primary DEX venue used for the route's swap.

Show child attributes

swap_price_impact_percent · string

Estimated price impact percentage for the swap.

usd_amount_in · string

USD value of the input amount.

usd_amount_out · string

USD value of the output amount.

warning · object

Price impact warning (present when impact exceeds 5%).

Show child attributes

extra_warnings · string[] | null

Additional warning messages for the route, such as withdrawal duration notices.

required_op_hook · boolean

Whether an OP hook is required for this route.