Fungible

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.

post/v2/fungible/route

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

Changed in 27 of the 50 revisions of this API.5651157

    • removed the HIGH_LOSS_WARNING enum value from the warning/type response property for the response status 200

      response-property-enum-value-removed

    • added the new HIGH_LOSS_ERROR enum value to the details/items/reason response property for the response status 400

      response-property-enum-value-added

    • added the new HIGH_LOSS_ERROR enum value to the details/items/reason response property for the response status 500

      response-property-enum-value-added

    • added the new HIGH_LOSS_WARNING enum value to the warning/type response property for the response status 200

      response-property-enum-value-added

    • the response property amount_in became required for the status 200

      response-property-became-required

    • the response property amount_out became required for the status 200

      response-property-became-required

    • the response property chain_ids became required for the status 200

      response-property-became-required

    • the response property dest_asset_chain_id became required for the status 200

      response-property-became-required

    • the response property dest_asset_denom became required for the status 200

      response-property-became-required

    • the response property estimated_amount_out became required for the status 200

      response-property-became-required

    • the response property estimated_route_duration_seconds became required for the status 200

      response-property-became-required

    • the response property operations became required for the status 200

      response-property-became-required

    • the response property operations/items/amount_in became required for the status 200

      response-property-became-required

    • the response property operations/items/amount_out became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/is_cw20 became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/is_evm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/is_svm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/origin_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/origin_denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/fee_asset/trace became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/is_cw20 became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/is_evm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/is_svm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/origin_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/origin_denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/fee_asset/trace became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/is_cw20 became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/is_evm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/is_svm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/origin_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/origin_denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/fee_asset/trace became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/bridge_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/denom_in became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/denom_out became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/destination_endpoint_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/from_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_amount became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_amount_usd became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/is_cw20 became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/is_evm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/is_svm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/origin_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/origin_denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/messaging_fee_asset/trace became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/source_oft_contract_address became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/to_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/is_cw20 became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/is_evm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/is_svm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/origin_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/origin_denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/messaging_fee_asset/trace became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/is_cw20 became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/is_evm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/is_svm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/origin_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/origin_denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/oft_fee_asset/trace became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/is_cw20 became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/is_evm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/is_svm became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/origin_chain_id became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/origin_denom became required for the status 200

      response-property-became-required

    • the response property operations/items/oneOf[TransferWrapper]/transfer/fee_asset/trace became required for the status 200

      response-property-became-required

    • the response property operations/items/tx_index became required for the status 200

      response-property-became-required

    • the response property required_chain_addresses became required for the status 200

      response-property-became-required

    • the response property source_asset_chain_id became required for the status 200

      response-property-became-required

    • the response property source_asset_denom became required for the status 200

      response-property-became-required

    • the response property txs_required became required for the status 200

      response-property-became-required

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/bpsFee from the response with the 200 status

      response-optional-property-removed

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/bpsFeeAmount from the response with the 200 status

      response-optional-property-removed

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/bpsFeeUsd from the response with the 200 status

      response-optional-property-removed

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/destinationChainFeeAmount from the response with the 200 status

      response-optional-property-removed

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/destinationChainFeeUsd from the response with the 200 status

      response-optional-property-removed

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/feeAsset from the response with the 200 status

      response-optional-property-removed

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/sourceChainFeeAmount from the response with the 200 status

      response-optional-property-removed

    • removed the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/sourceChainFeeUsd from the response with the 200 status

      response-optional-property-removed

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/bps_fee to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/bps_fee_amount to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/bps_fee_usd to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/destination_chain_fee_amount to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/destination_chain_fee_usd to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/fee_asset to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/source_chain_fee_amount to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/fee/source_chain_fee_usd to the response with the 200 status

      response-optional-property-added

    • the operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/destination_endpoint_id response's property type/format changed from number;/ to number/ for status 200

      response-property-type-changed

    • the operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/pool_address response's property type/format changed from string;/ to string/ for status 200

      response-property-type-changed

    • added the optional property operations/items/oneOf[SwapWrapper]/swap/oneOf[SmartSwapInWrapper]/smart_swap_in/estimated_amount_out to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[SwapWrapper]/swap/oneOf[SwapInWrapper]/swap_in/estimated_amount_out to the response with the 200 status

      response-optional-property-added

    • response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/from_chain deprecated

      response-property-deprecated

    • response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/dest_denom deprecated

      response-property-deprecated

    • response property operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/to_chain deprecated

      response-property-deprecated

    • response property operations/items/oneOf[TransferWrapper]/transfer/dest_denom deprecated

      response-property-deprecated

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/destination_domain to the response with the 200 status

      response-optional-property-added

    • added the optional property operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/source_domain to the response with the 200 status

      response-optional-property-added

  • 5caaf5305c88122See the full diff
    • removed the optional property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/source_oft_cntract_address from the response with the 200 status

      response-optional-property-removed

    • added the new LAYER_ZERO enum value to the estimated_fees/items/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[AxelarTransferWrapper]/axelar_transfer/ibc_transfer_to_axelar/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[CCTPTransferWrapper]/cctp_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[EurekaTransferWrapper]/eureka_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[GoFastTransferWrapper]/go_fast_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[HyperlaneTransferWrapper]/hyperlane_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[OPInitTransferWrapper]/op_init_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[StargateTransferWrapper]/stargate_transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the operations/items/oneOf[TransferWrapper]/transfer/bridge_id response property for the response status 200

      response-property-enum-value-added

    • added the new LAYER_ZERO enum value to the request property bridges/items/

      request-property-enum-value-added

    • added the optional property operations/items/oneOf[LayerZeroTransferWrapper]/layer_zero_transfer/source_oft_contract_address to the response with the 200 status

      response-optional-property-added

    • added the optional property estimated_fees/items/fee_behavior to the response with the 200 status

      response-optional-property-added

    • removed the optional property estimated_fees/items/fee_behavior from the response with the 200 status

      response-optional-property-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the optional property estimated_fees/items/fee_behavior to the response with the 200 status

      response-optional-property-added