Post /v2/fungible/msgs_direct

POST

fungible

msgs_direct

curl --request POST \
  --url https://api.skip.build/v2/fungible/msgs_direct \
  --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": "1500000000",
  "chain_ids_to_addresses": {
    "axelar-dojo-1": "axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0",
    "osmosis-1": "osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu",
    "cosmoshub-4": "cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw"
  },
  "slippage_tolerance_percent": "3",
  "allow_multi_tx": true
}'

Body

application/json

allow_multi_tx

boolean

Whether to allow route responses requiring multiple transactions

allow_swaps

boolean

Whether to allow swaps in the route

allow_unsafe

boolean

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

amount_in

string

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_out

string

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.

bridges

enum<string>[]

Array of bridges to use

Available options:

IBC,

AXELAR,

CCTP,

HYPERLANE,

OPINIT,

GO_FAST,

STARGATE

chain_ids_to_addresses

object

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.

chain_ids_to_affiliates

object

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.

dest_asset_chain_id

string

Chain-id of the destination asset

dest_asset_denom

string

Denom of the destination asset

enable_gas_warnings

boolean

default:

false

Whether to enable gas warnings for intermediate and destination chains

experimental_features

string[]

Array of experimental features to enable

post_route_handler

object

slippage_tolerance_percent

string

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

smart_relay

boolean

Indicates whether this transfer route should be relayed via Skip's Smart Relay service

smart_swap_options

object

source_asset_chain_id

string

Chain-id of the source asset

source_asset_denom

string

Denom of the source asset

swap_venues

object[]

Swap venues to consider, if provided (optional)

timeout_seconds

string

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

Response

200 - application/json

msgs

object[]

route

object

route.amount_in

string

Amount of source asset to be transferred or swapped

route.amount_out

string

Amount of destination asset out

route.chain_ids

string[]

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

route.dest_asset_chain_id

string

Chain-id of the destination asset

route.dest_asset_denom

string

Denom of the destination asset

route.does_swap

boolean

Whether this route performs a swap

route.estimated_amount_out

string

Amount of destination asset out, if a swap is performed

route.estimated_fees

object[]

Indicates fees incurred in the execution of the transfer

route.estimated_fees.amount

string

Amount of the fee asset to be paid

route.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

Available options:

IBC,

AXELAR,

CCTP,

HYPERLANE,

OPINIT,

GO_FAST,

STARGATE

route.estimated_fees.chain_id

string

Chain ID of the chain where fees are collected

route.estimated_fees.fee_type

enum<string>

Fee type:

SMART_RELAY - Fees for Smart relaying services.'

Available options:

SMART_RELAY

route.estimated_fees.operation_index

integer | null

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

route.estimated_fees.origin_asset

object

route.estimated_fees.tx_index

integer

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

route.estimated_fees.usd_amount

string

The value of the fee in USD

route.estimated_route_duration_seconds

integer

The estimated time in seconds for the route to execute

route.operations

object[]

Array of operations required to perform the transfer or swap

route.operations.amount_in

string

Amount of input asset to this operation

route.operations.amount_out

string

Amount of output asset from this operation

route.operations.transfer

object

A cross-chain transfer

route.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

Available options:

IBC,

AXELAR,

CCTP,

HYPERLANE,

OPINIT,

GO_FAST,

STARGATE

route.operations.transfer.channel

string

Channel to use to initiate the transfer

route.operations.transfer.denom_in

string

Denom of the input asset of the transfer

route.operations.transfer.denom_out

string

Denom of the output asset of the transfer

route.operations.transfer.dest_denom

string

Denom of the destionation asset of the transfer

route.operations.transfer.fee_amount

string | null

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

route.operations.transfer.fee_asset

object

Asset to be paid as the transfer fee if applicable.

route.operations.transfer.from_chain_id

string

Chain-id on which the transfer is initiated

route.operations.transfer.pfm_enabled

boolean

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

route.operations.transfer.port

string

Port to use to initiate the transfer

route.operations.transfer.smart_relay

boolean

Indicates whether this transfer is relayed via Smart Relay

route.operations.transfer.supports_memo

boolean

Whether the transfer chain supports a memo

route.operations.transfer.to_chain_id

string

Chain-id on which the transfer is received

route.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

route.operations.tx_index

integer

Index of the tx returned from Msgs that executes this operation

route.required_chain_addresses

any

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

route.source_asset_chain_id

string

Chain-id of the source asset

route.source_asset_denom

string

Denom of the source asset

route.swap_price_impact_percent

string | null

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

route.swap_venue

object

Swap venue on which the swap is performed, if a swap is performed

route.txs_required

integer

Number of transactions required to perform the transfer or swap

route.usd_amount_in

string

Amount of the source denom, converted to USD value

route.usd_amount_out

string

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

route.warning

object | null

Indicates if the route is unsafe due to poor execution price or if safety cannot be determined due to lack of pricing information

txs

object[]

Post /v2/fungible/msgs Post /v2/fungible/ibc_origin_assets

curl --request POST \
  --url https://api.skip.build/v2/fungible/msgs_direct \
  --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": "1500000000",
  "chain_ids_to_addresses": {
    "axelar-dojo-1": "axelar1x8ad0zyw52mvndh7hlnafrg0gt284ga7u3rez0",
    "osmosis-1": "osmo1x8ad0zyw52mvndh7hlnafrg0gt284ga7syxplu",
    "cosmoshub-4": "cosmos1x8ad0zyw52mvndh7hlnafrg0gt284ga7cl43fw"
  },
  "slippage_tolerance_percent": "3",
  "allow_multi_tx": true
}'

Prod Endpoints

Body

Response