Post /v2/fungible/route

POST

fungible

route

curl --request POST \
  --url https://api.skip.build/v2/fungible/route \
  --header 'Content-Type: application/json' \
  --data '{
  "amount_in": "1000000",
  "source_asset_denom": "uusdc",
  "source_asset_chain_id": "axelar-dojo-1",
  "dest_asset_denom": "uatom",
  "dest_asset_chain_id": "cosmoshub-4",
  "cumulative_affiliate_fee_bps": "0",
  "allow_multi_tx": true
}'

{
  "amount_in": "1000000000000000000",
  "amount_out": "721110",
  "source_asset_denom": "polygon-native",
  "source_asset_chain_id": "137",
  "dest_asset_denom": "uosmo",
  "dest_asset_chain_id": "osmosis-1",
  "operations": [
    {
      "axelar_transfer": {
        "from_chain": "Polygon",
        "from_chain_id": "137",
        "to_chain": "osmosis",
        "to_chain_id": "osmosis-1",
        "asset": "wmatic-wei",
        "should_unwrap": false,
        "fee_amount": "335901477747718412",
        "usd_fee_amount": "0.27",
        "fee_asset": {
          "denom": "matic",
          "chain_id": "137",
          "origin_denom": "",
          "origin_chain_id": "",
          "trace": "",
          "is_cw20": false,
          "is_evm": true,
          "symbol": "MATIC",
          "name": "matic",
          "logo_uri": "https://raw.githubusercontent.com/cosmostation/chainlist/main/chain/polygon/asset/wmatic.png",
          "decimals": 18,
          "token_contract": ""
        },
        "is_testnet": false,
        "bridge_id": "AXELAR"
      },
      "tx_index": 0
    },
    {
      "swap": {
        "swap_in": {
          "swap_venue": {
            "name": "osmosis-poolmanager",
            "chain_id": "osmosis-1"
          },
          "swap_operations": [
            {
              "pool": "789",
              "denom_in": "ibc/AB589511ED0DD5FA56171A39978AFBF1371DB986EC1C3526CE138A16377E39BB",
              "denom_out": "uosmo"
            }
          ],
          "swap_amount_in": "664098522252281588",
          "price_impact_percent": "1.05"
        },
        "estimated_affiliate_fee": "0uosmo",
        "from_chain_id": "osmosis-1",
        "chain_id": "osmosis-1",
        "denom_in": "ibc/AB589511ED0DD5FA56171A39978AFBF1371DB986EC1C3526CE138A16377E39BB",
        "denom_out": "uosmo"
      },
      "tx_index": 0
    }
  ],
  "chain_ids": [
    "axelar-dojo-1",
    "osmosis-1",
    "cosmoshub-4"
  ],
  "required_chain_addresses": [
    "axelar-dojo-1",
    "osmosis-1",
    "cosmoshub-4"
  ],
  "does_swap": true,
  "estimated_amount_out": "721110",
  "swap_venue": {
    "name": "osmosis-poolmanager",
    "chain_id": "osmosis-1"
  },
  "txs_required": 1,
  "usd_amount_in": "2000.01",
  "usd_amount_out": "2005.23",
  "swap_price_impact_percent": "1.05",
  "estimated_fees": [],
  "estimated_route_duration_seconds": 300
}

Body

application/json

amount_in

string

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

amount_out

string

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.

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

cumulative_affiliate_fee_bps

string | null

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

swap_venues

object[]

Swap venues to consider, if provided (optional)

A venue on which swaps can be exceuted

allow_multi_tx

boolean

Whether to allow route responses requiring multiple transactions

allow_unsafe

boolean

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

experimental_features

string[]

Array of experimental features to enable

bridges

enum<string>[]

Array of bridges to use

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

smart_relay

boolean

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

smart_swap_options

object

allow_swaps

boolean

Whether to allow swaps in the route

go_fast

boolean

Whether to enable Go Fast routes

Response

200

application/json

Swap and transfer route summary & quote

amount_in

string

Amount of source asset to be transferred or swapped

amount_out

string

Amount of destination asset out

chain_ids

string[]

Chain-ids of all chains of the transfer or swap, in order of usage by operations in the 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

dest_asset_chain_id

string

Chain-id of the destination asset

dest_asset_denom

string

Denom of the destination asset

does_swap

boolean

Whether this route performs a swap

estimated_amount_out

string

Amount of destination asset out, if a swap is performed

operations

object[]

Array of operations required to perform the transfer or swap

operations.transfer

object

A cross-chain 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.channel

string

Channel to use to initiate the transfer

operations.transfer.dest_denom

string

Denom of the destionation asset of the transfer

operations.transfer.pfm_enabled

boolean

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

operations.transfer.port

string

Port to use to initiate the transfer

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.

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

operations.transfer.smart_relay

boolean

Indicates whether this transfer is relayed via Smart Relay

operations.tx_index

integer

Index of the tx returned from Msgs that executes this operation

operations.amount_in

string

Amount of input asset to this operation

operations.amount_out

string

Amount of output asset from this operation

source_asset_chain_id

string

Chain-id of the source asset

source_asset_denom

string

Denom of the source asset

swap_venue

object

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

txs_required

integer

Number of transactions required to perform the transfer or swap

usd_amount_in

string

Amount of the source denom, converted to USD value

usd_amount_out

string

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

swap_price_impact_percent

string | null

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

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

estimated_fees

object[]

Indicates fees incurred in the execution of the transfer

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

Available options:

IBC,

AXELAR,

CCTP,

HYPERLANE,

OPINIT,

GO_FAST,

STARGATE

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

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_route_duration_seconds

integer

The estimated time in seconds for the route to execute

Post /v2/fungible/assets_from_source Post /v2/fungible/msgs

curl --request POST \
  --url https://api.skip.build/v2/fungible/route \
  --header 'Content-Type: application/json' \
  --data '{
  "amount_in": "1000000",
  "source_asset_denom": "uusdc",
  "source_asset_chain_id": "axelar-dojo-1",
  "dest_asset_denom": "uatom",
  "dest_asset_chain_id": "cosmoshub-4",
  "cumulative_affiliate_fee_bps": "0",
  "allow_multi_tx": true
}'

{
  "amount_in": "1000000000000000000",
  "amount_out": "721110",
  "source_asset_denom": "polygon-native",
  "source_asset_chain_id": "137",
  "dest_asset_denom": "uosmo",
  "dest_asset_chain_id": "osmosis-1",
  "operations": [
    {
      "axelar_transfer": {
        "from_chain": "Polygon",
        "from_chain_id": "137",
        "to_chain": "osmosis",
        "to_chain_id": "osmosis-1",
        "asset": "wmatic-wei",
        "should_unwrap": false,
        "fee_amount": "335901477747718412",
        "usd_fee_amount": "0.27",
        "fee_asset": {
          "denom": "matic",
          "chain_id": "137",
          "origin_denom": "",
          "origin_chain_id": "",
          "trace": "",
          "is_cw20": false,
          "is_evm": true,
          "symbol": "MATIC",
          "name": "matic",
          "logo_uri": "https://raw.githubusercontent.com/cosmostation/chainlist/main/chain/polygon/asset/wmatic.png",
          "decimals": 18,
          "token_contract": ""
        },
        "is_testnet": false,
        "bridge_id": "AXELAR"
      },
      "tx_index": 0
    },
    {
      "swap": {
        "swap_in": {
          "swap_venue": {
            "name": "osmosis-poolmanager",
            "chain_id": "osmosis-1"
          },
          "swap_operations": [
            {
              "pool": "789",
              "denom_in": "ibc/AB589511ED0DD5FA56171A39978AFBF1371DB986EC1C3526CE138A16377E39BB",
              "denom_out": "uosmo"
            }
          ],
          "swap_amount_in": "664098522252281588",
          "price_impact_percent": "1.05"
        },
        "estimated_affiliate_fee": "0uosmo",
        "from_chain_id": "osmosis-1",
        "chain_id": "osmosis-1",
        "denom_in": "ibc/AB589511ED0DD5FA56171A39978AFBF1371DB986EC1C3526CE138A16377E39BB",
        "denom_out": "uosmo"
      },
      "tx_index": 0
    }
  ],
  "chain_ids": [
    "axelar-dojo-1",
    "osmosis-1",
    "cosmoshub-4"
  ],
  "required_chain_addresses": [
    "axelar-dojo-1",
    "osmosis-1",
    "cosmoshub-4"
  ],
  "does_swap": true,
  "estimated_amount_out": "721110",
  "swap_venue": {
    "name": "osmosis-poolmanager",
    "chain_id": "osmosis-1"
  },
  "txs_required": 1,
  "usd_amount_in": "2000.01",
  "usd_amount_out": "2005.23",
  "swap_price_impact_percent": "1.05",
  "estimated_fees": [],
  "estimated_route_duration_seconds": 300
}

Prod Endpoints

Body

Response