SKskip-mev
Fungible

POST /v2/fungible/route

Changed on

This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns the sequence of transfers and/or swaps to reach the given destination asset from the given source asset, along with estimated amount out. Commonly called before /msgs to generate route info and quote.

Request

  • Base URL
    https://api.skip.build
  • Auth
    none declared

Request body

source_asset_denomstring

Denom of the source asset

source_asset_chain_idstring

Chain-id of the source asset

dest_asset_denomstring

Denom of the destination asset

dest_asset_chain_idstring

Chain-id of the destination asset

amount_instring

Amount of source asset to be transferred or swapped. Only one of amount_in and amount_out should be provided.

amount_outstring

Amount of destination asset to receive. Only one of amount_in and amount_out should be provided. If amount_out is provided for a swap, the route will be computed to give exactly amount_out.

cumulative_affiliate_fee_bpsstring nullable

Cumulative fee to be distributed to affiliates, in bps (optional)

allow_unsafeboolean

Toggles whether the api should return routes that fail price safety checks.

experimental_featuresstring[]

Array of experimental features to enable

allow_multi_txboolean

Whether to allow route responses requiring multiple transactions

bridgesBridgeType[]

Array of bridges to use

smart_relayboolean

Indicates whether this transfer route should be relayed via Skip's Smart Relay service - true by default.

allow_swapsboolean

Whether to allow swaps in the route

go_fastboolean

Whether to enable Go Fast routes

Response

Swap and transfer route summary & quote

amount_instring required

Amount of source asset to be transferred or swapped

amount_outstring required

Amount of destination asset out

chain_idsstring[] required

Chain-ids of all chains of the transfer or swap, in order of usage by operations in the route

required_chain_addressesstring[] required

All chain-ids that require an address to be provided for, in order of usage by operations in the route

dest_asset_chain_idstring required

Chain-id of the destination asset

dest_asset_denomstring required

Denom of the destination asset

does_swapboolean

Whether this route performs a swap

estimated_amount_outstring required

Amount of destination asset out, if a swap is performed

source_asset_chain_idstring required

Chain-id of the source asset

source_asset_denomstring required

Denom of the source asset

txs_requiredinteger required

Number of transactions required to perform the transfer or swap

usd_amount_instring

Amount of the source denom, converted to USD value

usd_amount_outstring

Amount of the destination denom expected to be received, converted to USD value

swap_price_impact_percentstring nullable

Price impact of the estimated swap, if present. Measured in percentage e.g. "0.5" is .5%

estimated_route_duration_secondsinteger required

The estimated time in seconds for the route to execute

Changes

  • 8ff1725efab4Revision changes
    • info

      removed the HIGH_LOSS_WARNING enum value from the / response property for the response status

  • 668c826e2588Revision changes
    • warning

      added the new HIGH_LOSS_ERROR enum value to the // response property for the response status

    • warning

      added the new HIGH_LOSS_ERROR enum value to the // response property for the response status

    • warning

      added the new HIGH_LOSS_WARNING enum value to the / response property for the response status