Post /v2/fungible/msgs

curl --request POST \
  --url https://api.skip.build/v2/fungible/msgs \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_asset_denom": "uusdc",
  "source_asset_chain_id": "axelar-dojo-1",
  "dest_asset_denom": "uatom",
  "dest_asset_chain_id": "cosmoshub-4",
  "amount_in": "1000000",
  "amount_out": "107033",
  "address_list": [
    "axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0",
    "osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu",
    "cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw"
  ],
  "operations": [
    {
      "transfer": {
        "port": "transfer",
        "channel": "channel-3",
        "from_chain_id": "axelar-dojo-1",
        "to_chain_id": "osmosis-1",
        "pfm_enabled": false,
        "supports_memo": true,
        "dest_denom": "ibc/D189335C6E4A68B513C10AB227BF1C1D38C746766278BA3EEB4FB14124F1D858"
      }
    },
    {
      "swap": {
        "swap_in": {
          "swap_venue": {
            "name": "osmosis-poolmanager",
            "chain_id": "osmosis-1"
          },
          "swap_operations": [
            {
              "pool": "678",
              "denom_in": "ibc/D189335C6E4A68B513C10AB227BF1C1D38C746766278BA3EEB4FB14124F1D858",
              "denom_out": "uosmo"
            },
            {
              "pool": "1",
              "denom_in": "uosmo",
              "denom_out": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2"
            }
          ],
          "swap_amount_in": "1000000"
        },
        "estimated_affiliate_fee": "0ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2",
        "from_chain_id": "osmosis-1",
        "chain_id": "osmosis-1",
        "denom_in": "ibc/D189335C6E4A68B513C10AB227BF1C1D38C746766278BA3EEB4FB14124F1D858",
        "denom_out": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2"
      }
    },
    {
      "transfer": {
        "port": "transfer",
        "channel": "channel-0",
        "from_chain_id": "osmosis-1",
        "to_chain_id": "cosmoshub-4",
        "pfm_enabled": true,
        "supports_memo": true,
        "dest_denom": "uatom"
      }
    }
  ],
  "slippage_tolerance_percent": "1",
  "chain_ids_to_affiliates": {}
}
'

{
  "msgs": [
    {
      "multi_chain_msg": {
        "chain_id": "axelar-dojo-1",
        "path": [
          "axelar-dojo-1"
        ],
        "msg": "{\"source_port\":\"transfer\",\"source_channel\":\"channel-3\",\"token\":{\"denom\":\"uusdc\",\"amount\":\"1000000\"},\"sender\":\"axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0\",\"receiver\":\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\",\"timeout_height\":{},\"timeout_timestamp\":1688663426558649000,\"memo\":\"{\\\"wasm\\\":{\\\"contract\\\":\\\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\\\",\\\"msg\\\":{\\\"swap_with_action\\\":{\\\"swap_msg\\\":{\\\"token_out_min_amount\\\":\\\"105963\\\",\\\"path\\\":[{\\\"pool_id\\\":\\\"678\\\",\\\"token_out_denom\\\":\\\"uosmo\\\"},{\\\"pool_id\\\":\\\"1\\\",\\\"token_out_denom\\\":\\\"ibc/27394fb092d2eccd56123c74f36e4c1f926001ceada9ca97ea622b25f41e5eb2\\\"}]},\\\"after_swap_action\\\":{\\\"ibc_transfer\\\":{\\\"receiver\\\":\\\"cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw\\\",\\\"channel\\\":\\\"channel-0\\\"}},\\\"local_fallback_address\\\":\\\"osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu\\\"}}}}\"}",
        "msg_type_url": "/ibc.applications.transfer.v1.MsgTransfer"
      }
    }
  ],
  "txs": [
    {
      "cosmos_tx": {
        "chain_id": "axelar-dojo-1",
        "path": [
          "axelar-dojo-1"
        ],
        "signer_address": "axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0",
        "msgs": [
          {
            "msg": "{\"source_port\":\"transfer\",\"source_channel\":\"channel-3\",\"token\":{\"denom\":\"uusdc\",\"amount\":\"1000000\"},\"sender\":\"axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0\",\"receiver\":\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\",\"timeout_height\":{},\"timeout_timestamp\":1688663426558649000,\"memo\":\"{\\\"wasm\\\":{\\\"contract\\\":\\\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\\\",\\\"msg\\\":{\\\"swap_with_action\\\":{\\\"swap_msg\\\":{\\\"token_out_min_amount\\\":\\\"105963\\\",\\\"path\\\":[{\\\"pool_id\\\":\\\"678\\\",\\\"token_out_denom\\\":\\\"uosmo\\\"},{\\\"pool_id\\\":\\\"1\\\",\\\"token_out_denom\\\":\\\"ibc/27394fb092d2eccd56123c74f36e4c1f926001ceada9ca97ea622b25f41e5eb2\\\"}]},\\\"after_swap_action\\\":{\\\"ibc_transfer\\\":{\\\"receiver\\\":\\\"cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw\\\",\\\"channel\\\":\\\"channel-0\\\"}},\\\"local_fallback_address\\\":\\\"osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu\\\"}}}}\"}",
            "msg_type_url": "/ibc.applications.transfer.v1.MsgTransfer"
          }
        ]
      },
      "operations_indices": [
        0,
        1,
        2
      ]
    }
  ],
  "min_amount_out": "105963",
  "estimated_fees": []
}

POST

fungible

msgs

curl --request POST \
  --url https://api.skip.build/v2/fungible/msgs \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_asset_denom": "uusdc",
  "source_asset_chain_id": "axelar-dojo-1",
  "dest_asset_denom": "uatom",
  "dest_asset_chain_id": "cosmoshub-4",
  "amount_in": "1000000",
  "amount_out": "107033",
  "address_list": [
    "axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0",
    "osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu",
    "cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw"
  ],
  "operations": [
    {
      "transfer": {
        "port": "transfer",
        "channel": "channel-3",
        "from_chain_id": "axelar-dojo-1",
        "to_chain_id": "osmosis-1",
        "pfm_enabled": false,
        "supports_memo": true,
        "dest_denom": "ibc/D189335C6E4A68B513C10AB227BF1C1D38C746766278BA3EEB4FB14124F1D858"
      }
    },
    {
      "swap": {
        "swap_in": {
          "swap_venue": {
            "name": "osmosis-poolmanager",
            "chain_id": "osmosis-1"
          },
          "swap_operations": [
            {
              "pool": "678",
              "denom_in": "ibc/D189335C6E4A68B513C10AB227BF1C1D38C746766278BA3EEB4FB14124F1D858",
              "denom_out": "uosmo"
            },
            {
              "pool": "1",
              "denom_in": "uosmo",
              "denom_out": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2"
            }
          ],
          "swap_amount_in": "1000000"
        },
        "estimated_affiliate_fee": "0ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2",
        "from_chain_id": "osmosis-1",
        "chain_id": "osmosis-1",
        "denom_in": "ibc/D189335C6E4A68B513C10AB227BF1C1D38C746766278BA3EEB4FB14124F1D858",
        "denom_out": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2"
      }
    },
    {
      "transfer": {
        "port": "transfer",
        "channel": "channel-0",
        "from_chain_id": "osmosis-1",
        "to_chain_id": "cosmoshub-4",
        "pfm_enabled": true,
        "supports_memo": true,
        "dest_denom": "uatom"
      }
    }
  ],
  "slippage_tolerance_percent": "1",
  "chain_ids_to_affiliates": {}
}
'

{
  "msgs": [
    {
      "multi_chain_msg": {
        "chain_id": "axelar-dojo-1",
        "path": [
          "axelar-dojo-1"
        ],
        "msg": "{\"source_port\":\"transfer\",\"source_channel\":\"channel-3\",\"token\":{\"denom\":\"uusdc\",\"amount\":\"1000000\"},\"sender\":\"axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0\",\"receiver\":\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\",\"timeout_height\":{},\"timeout_timestamp\":1688663426558649000,\"memo\":\"{\\\"wasm\\\":{\\\"contract\\\":\\\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\\\",\\\"msg\\\":{\\\"swap_with_action\\\":{\\\"swap_msg\\\":{\\\"token_out_min_amount\\\":\\\"105963\\\",\\\"path\\\":[{\\\"pool_id\\\":\\\"678\\\",\\\"token_out_denom\\\":\\\"uosmo\\\"},{\\\"pool_id\\\":\\\"1\\\",\\\"token_out_denom\\\":\\\"ibc/27394fb092d2eccd56123c74f36e4c1f926001ceada9ca97ea622b25f41e5eb2\\\"}]},\\\"after_swap_action\\\":{\\\"ibc_transfer\\\":{\\\"receiver\\\":\\\"cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw\\\",\\\"channel\\\":\\\"channel-0\\\"}},\\\"local_fallback_address\\\":\\\"osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu\\\"}}}}\"}",
        "msg_type_url": "/ibc.applications.transfer.v1.MsgTransfer"
      }
    }
  ],
  "txs": [
    {
      "cosmos_tx": {
        "chain_id": "axelar-dojo-1",
        "path": [
          "axelar-dojo-1"
        ],
        "signer_address": "axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0",
        "msgs": [
          {
            "msg": "{\"source_port\":\"transfer\",\"source_channel\":\"channel-3\",\"token\":{\"denom\":\"uusdc\",\"amount\":\"1000000\"},\"sender\":\"axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0\",\"receiver\":\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\",\"timeout_height\":{},\"timeout_timestamp\":1688663426558649000,\"memo\":\"{\\\"wasm\\\":{\\\"contract\\\":\\\"osmo1qpvu80yfd0jnnh3ytn8964382typrqq0ejmqaasa3j233su8apasfqtler\\\",\\\"msg\\\":{\\\"swap_with_action\\\":{\\\"swap_msg\\\":{\\\"token_out_min_amount\\\":\\\"105963\\\",\\\"path\\\":[{\\\"pool_id\\\":\\\"678\\\",\\\"token_out_denom\\\":\\\"uosmo\\\"},{\\\"pool_id\\\":\\\"1\\\",\\\"token_out_denom\\\":\\\"ibc/27394fb092d2eccd56123c74f36e4c1f926001ceada9ca97ea622b25f41e5eb2\\\"}]},\\\"after_swap_action\\\":{\\\"ibc_transfer\\\":{\\\"receiver\\\":\\\"cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw\\\",\\\"channel\\\":\\\"channel-0\\\"}},\\\"local_fallback_address\\\":\\\"osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu\\\"}}}}\"}",
            "msg_type_url": "/ibc.applications.transfer.v1.MsgTransfer"
          }
        ]
      },
      "operations_indices": [
        0,
        1,
        2
      ]
    }
  ],
  "min_amount_out": "105963",
  "estimated_fees": []
}

Body

application/json

source_asset_denom

string

Denom of the source asset

source_asset_chain_id

string

Chain-id of the source asset

dest_asset_denom

string

Denom of the destination asset

dest_asset_chain_id

string

Chain-id of the destination asset

amount_in

string

Amount of source asset to be transferred or swapped

amount_out

string

Amount of destination asset out

address_list

string[]

Array of receipient and/or sender address for each chain in the path, corresponding to the required_chain_addresses array returned from a route request

operations

object[]

Array of operations required to perform the transfer or swap

Option 1
Option 2
Option 3
Option 4
Option 5
Option 6
Option 7
Option 8
Option 9
Option 10
Option 11
Option 12

Show child attributes

operations.tx_index

integer

required

Index of the tx returned from Msgs that executes this operation

operations.amount_in

string

required

Amount of input asset to this operation

operations.amount_out

string

required

Amount of output asset from this operation

operations.transfer

object

A cross-chain transfer

Show child attributes

operations.transfer.port

string

Port to use to initiate the transfer

operations.transfer.channel

string

Channel to use to initiate the transfer

operations.transfer.from_chain_id

string

Chain-id on which the transfer is initiated

operations.transfer.to_chain_id

string

Chain-id on which the transfer is received

operations.transfer.pfm_enabled

boolean

Whether pfm is enabled on the chain where the transfer is initiated

operations.transfer.supports_memo

boolean

Whether the transfer chain supports a memo

operations.transfer.denom_in

string

Denom of the input asset of the transfer

operations.transfer.denom_out

string

Denom of the output asset of the transfer

operations.transfer.fee_amount

string | null

Amount of the fee asset to be paid as the transfer fee if applicable.

operations.transfer.usd_fee_amount

string | null

Amount of the fee asset to be paid as the transfer fee if applicable, converted to USD value

operations.transfer.fee_asset

object

Asset to be paid as the transfer fee if applicable.

Show child attributes

operations.transfer.fee_asset.denom

string

required

Denom of the asset

operations.transfer.fee_asset.chain_id

string

required

Chain-id of the asset

operations.transfer.fee_asset.origin_denom

string

required

Denom of the origin of the asset. If this is an ibc denom, this is the original denom that the ibc token represents

operations.transfer.fee_asset.origin_chain_id

string

required

Chain-id of the origin of the asset. If this is an ibc denom, this is the chain-id of the asset that the ibc token represents

operations.transfer.fee_asset.trace

string

required

The forward slash delimited sequence of ibc ports and channels that can be traversed to unwind an ibc token to its origin asset.

operations.transfer.fee_asset.is_cw20

boolean

required

Indicates whether asset is a CW20 token

operations.transfer.fee_asset.is_evm

boolean

required

Indicates whether asset is an EVM token

operations.transfer.fee_asset.is_svm

boolean

required

Indicates whether asset is an SVM token

operations.transfer.fee_asset.symbol

string | null

Symbol of the asset, e.g. ATOM for uatom

operations.transfer.fee_asset.name

string | null

Name of the asset

operations.transfer.fee_asset.logo_uri

string | null

URI pointing to an image of the logo of the asset

operations.transfer.fee_asset.decimals

number | null

Number of decimals used for amounts of the asset

operations.transfer.fee_asset.token_contract

string | null

Address of the contract for the asset, e.g. if it is a CW20 or ERC20 token

operations.transfer.fee_asset.description

string | null

Description of the asset

operations.transfer.fee_asset.coingecko_id

string | null

Coingecko id of the asset

operations.transfer.fee_asset.recommended_symbol

string | null

Recommended symbol of the asset used to differentiate between bridged assets with the same symbol, e.g. USDC.axl for Axelar USDC and USDC.grv for Gravity USDC

operations.transfer.bridge_id

enum<string>

Bridge Type:

IBC - IBC Bridge
AXELAR - Axelar Bridge
CCTP - CCTP Bridge
HYPERLANE - Hyperlane Bridge
OPINIT - Opinit Bridge
GO_FAST - Go Fast Bridge
STARGATE - Stargate Bridge
LAYER_ZERO - Layerzero Bridge
EUREKA - IBC Eureka Bridge

Available options:

IBC,

AXELAR,

CCTP,

HYPERLANE,

OPINIT,

GO_FAST,

STARGATE,

LAYER_ZERO,

EUREKA

operations.transfer.smart_relay

boolean

Indicates whether this transfer is relayed via Smart Relay

operations.transfer.to_chain_entry_contract_address

string | null

Address of the entry contract on the destination chain

operations.transfer.to_chain_callback_contract_address

string | null

Address of the callback contract on the destination chain

operations.transfer.dest_denom

string

deprecated

Deprecated, use denom_out instead. Denom of the destination asset of the transfer

estimated_amount_out

string

slippage_tolerance_percent

string

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

chain_ids_to_affiliates

object

Map of chain-ids to arrays of affiliates. The API expects all chains to have the same cumulative affiliate fee bps for each chain specified. If any of the provided affiliate arrays does not have the same cumulative fee, the API will return an error.

Show child attributes

chain_ids_to_affiliates.{key}

object

Show child attributes

chain_ids_to_affiliates.{key}.affiliates

object[]

An array of affiliates that receives fees from a swap

Show child attributes

chain_ids_to_affiliates.{key}.affiliates.address

string

Address to which to pay the fee

chain_ids_to_affiliates.{key}.affiliates.basis_points_fee

string

Bps fee to pay to the affiliate

post_route_handler

object

Option 1
Option 2

Show child attributes

post_route_handler.wasm_msg

object

Show child attributes

post_route_handler.wasm_msg.contract_address

string

Address of the contract to execute the message on

post_route_handler.wasm_msg.msg

string

JSON string of the message

timeout_seconds

string

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

enable_gas_warnings

boolean

default:false

Whether to enable gas warnings for intermediate and destination chains

fee_payer_address

string

default:false

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.

msgs

object[]

Option 1
Option 2
Option 3

Show child attributes

msgs.multi_chain_msg

object

A message that interacts with multiple chains

Show child attributes

msgs.multi_chain_msg.chain_id

string

Chain-id of the chain that the transaction containing the message is intended for

msgs.multi_chain_msg.msg

string

JSON string of the message

msgs.multi_chain_msg.msg_type_url

string

TypeUrl of the message

msgs.multi_chain_msg.path

string[]

Path of chain-ids that the message is intended to interact with

txs

object[]

Option 1
Option 2
Option 3

Show child attributes

txs.cosmos_tx

object

required

A transaction on a Cosmos chain

Show child attributes

txs.cosmos_tx.chain_id

string

required

Chain-id of the chain that the transaction is intended for

txs.cosmos_tx.path

string[]

Path of chain-ids that the message is intended to interact with

txs.cosmos_tx.signer_address

string

The address of the wallet that will sign this transaction

txs.cosmos_tx.msgs

object[]

The messages that should be included in the transaction. The ordering must be adhered to.

Show child attributes

txs.cosmos_tx.msgs.msg

string

JSON string of the message

txs.cosmos_tx.msgs.msg_type_url

string

TypeUrl of the message

txs.operations_indices

integer[]

Array of indices of the operations that this transaction executes

min_amount_out

string

Minimum possible output after all operations, including fees and slippage

estimated_fees

object[]

Indicates fees incurred in the execution of the transfer

Show child attributes

estimated_fees.fee_type

enum<string>

Fee type:

SMART_RELAY - Fees for Smart relaying services.'

Available options:

SMART_RELAY

estimated_fees.bridge_id

enum<string>

Bridge Type:

IBC - IBC Bridge
AXELAR - Axelar Bridge
CCTP - CCTP Bridge
HYPERLANE - Hyperlane Bridge
OPINIT - Opinit Bridge
GO_FAST - Go Fast Bridge
STARGATE - Stargate Bridge
LAYER_ZERO - Layerzero Bridge
EUREKA - IBC Eureka Bridge

Available options:

IBC,

AXELAR,

CCTP,

HYPERLANE,

OPINIT,

GO_FAST,

STARGATE,

LAYER_ZERO,

EUREKA

estimated_fees.amount

string

Amount of the fee asset to be paid

estimated_fees.usd_amount

string

The value of the fee in USD

estimated_fees.origin_asset

object

Show child attributes

estimated_fees.origin_asset.denom

string

Denom of the asset

estimated_fees.origin_asset.chain_id

string

Chain-id of the asset

estimated_fees.origin_asset.origin_denom

string

Denom of the origin of the asset. If this is an ibc denom, this is the original denom that the ibc token represents

estimated_fees.origin_asset.origin_chain_id

string

Chain-id of the origin of the asset. If this is an ibc denom, this is the chain-id of the asset that the ibc token represents

estimated_fees.origin_asset.trace

string

The forward slash delimited sequence of ibc ports and channels that can be traversed to unwind an ibc token to its origin asset.

estimated_fees.origin_asset.is_cw20

boolean

Indicates whether asset is a CW20 token

estimated_fees.origin_asset.is_evm

boolean

Indicates whether asset is an EVM token

estimated_fees.origin_asset.is_svm

boolean

Indicates whether asset is an SVM token

estimated_fees.origin_asset.symbol

string | null

Symbol of the asset, e.g. ATOM for uatom

estimated_fees.origin_asset.name

string | null

Name of the asset

estimated_fees.origin_asset.logo_uri

string | null

URI pointing to an image of the logo of the asset

estimated_fees.origin_asset.decimals

number | null

Number of decimals used for amounts of the asset

estimated_fees.origin_asset.token_contract

string | null

Address of the contract for the asset, e.g. if it is a CW20 or ERC20 token

estimated_fees.origin_asset.description

string | null

Description of the asset

estimated_fees.origin_asset.coingecko_id

string | null

Coingecko id of the asset

estimated_fees.origin_asset.recommended_symbol

string | null

Recommended symbol of the asset used to differentiate between bridged assets with the same symbol, e.g. USDC.axl for Axelar USDC and USDC.grv for Gravity USDC

estimated_fees.chain_id

string

Chain ID of the chain where fees are collected

estimated_fees.tx_index

integer

The index of the transaction in the list of transactions required to execute the transfer where fees are paid

estimated_fees.operation_index

integer | null

The index of the operation in the returned operations list which incurs the fee

estimated_fees.fee_behavior

enum<string>

Indicates whether this fee is deducted from the transfer amount or charged additionally

Available options:

FEE_BEHAVIOR_DEDUCTED,

FEE_BEHAVIOR_ADDITIONAL

Post /v2/fungible/route Post /v2/fungible/msgs_direct

⌘I

Prod Endpoints

Reference Guides

Post /v2/fungible/msgs

Body

Response