SKskip-mev
Fungible

POST /v2/fungible/msgs_direct

Changed on

This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns minimal number of messages required to execute a multi-chain swap or transfer. This is a convenience endpoint that combines /route and /msgs into a single call.

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. If this is a swap, only one of amount_in and amount_out should be provided.

amount_outstring

Amount of destination asset out. If this is a swap, 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.

chain_ids_to_addressesobject

Map of chain-ids to receipient and/or sender address for each chain in the path. Since the path is not known to the caller beforehand, the caller should attempt to provide addresses for all chains in the path, and the API will return an error if the path cannot be constructed.

slippage_tolerance_percentstring

Percent tolerance for slippage on swap, if a swap is performed

chain_ids_to_affiliatesobject

Map of chain-ids to arrays of affiliates. Since cumulative_affiliate_fee_bps must be provided to retrieve a route, and the swap chain is not known at this time, all chains must have the same cumulative_affiliate_fee_bps otherwise the API will return an error.

timeout_secondsstring

Number of seconds for the IBC transfer timeout, defaults to 5 minutes

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

allow_swapsboolean

Whether to allow swaps in the route

enable_gas_warningsboolean

Whether to enable gas warnings for intermediate and destination chains

go_fastboolean

Whether to enable Go Fast routes

fee_payer_addressstring

Alternative address to use for paying for fees, currently only for SVM source CCTP transfers, in b58 format.

Response

The messages required to execute the swap, as JSON.

min_amount_outstring

Minimum possible output after all operations, including fees and slippage

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