Post /v2/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_venues": [
    {
      "name": "osmosis-poolmanager",
      "chain_id": "osmosis-1",
      "logo_uri": "https://raw.githubusercontent.com/skip-mev/skip-go-registry/main/swap-venues/osmosis/logo.png"
    }
  ],
  "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
}

{
  "code": 3,
  "message": "difference in usd value of route input and output is too large. input usd value: 100000.00 output usd value: 98811.81",
  "details": [
    {
      "@type": "type.googleapis.com/google.rpc.ErrorInfo",
      "reason": "BAD_PRICE_ERROR",
      "domain": "skip.build",
      "metadata": {}
    }
  ]
}

{
  "code": 2,
  "message": "internal server error",
  "details": []
}

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_venues": [
    {
      "name": "osmosis-poolmanager",
      "chain_id": "osmosis-1",
      "logo_uri": "https://raw.githubusercontent.com/skip-mev/skip-go-registry/main/swap-venues/osmosis/logo.png"
    }
  ],
  "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
}

{
  "code": 3,
  "message": "difference in usd value of route input and output is too large. input usd value: 100000.00 output usd value: 98811.81",
  "details": [
    {
      "@type": "type.googleapis.com/google.rpc.ErrorInfo",
      "reason": "BAD_PRICE_ERROR",
      "domain": "skip.build",
      "metadata": {}
    }
  ]
}

{
  "code": 2,
  "message": "internal server error",
  "details": []
}

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

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)

Show child attributes

allow_unsafe

boolean

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

experimental_features

string[]

Array of experimental features to enable

allow_multi_tx

boolean

Whether to allow route responses requiring multiple transactions

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
LAYER_ZERO - Layerzero Bridge
EUREKA - IBC Eureka Bridge

Available options:

IBC,

AXELAR,

CCTP,

HYPERLANE,

OPINIT,

GO_FAST,

STARGATE,

LAYER_ZERO,

EUREKA

smart_relay

boolean

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

smart_swap_options

object

Show child attributes

allow_swaps

boolean

Whether to allow swaps in the route

go_fast

boolean

Whether to enable Go Fast routes

Response

Swap and transfer route summary & quote

amount_in

string

required

Amount of source asset to be transferred or swapped

amount_out

string

required

Amount of destination asset out

chain_ids

string[]

required

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

required_chain_addresses

string[]

required

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

required

Chain-id of the destination asset

dest_asset_denom

string

required

Denom of the destination asset

estimated_amount_out

string

required

Amount of destination asset out, if a swap is performed

operations

object[]

required

Array of operations required to perform the transfer or swap

Show child attributes

source_asset_chain_id

string

required

Chain-id of the source asset

source_asset_denom

string

required

Denom of the source asset

txs_required

integer

required

Number of transactions required to perform the transfer or swap

estimated_route_duration_seconds

integer

required

The estimated time in seconds for the route to execute

does_swap

boolean

Whether this route performs a swap

swap_venues

object[]

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

Show child attributes

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

Show child attributes

estimated_fees

object[]

Indicates fees incurred in the execution of the transfer

Show child attributes

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

⌘I

Prod Endpoints

Reference Guides

Post /v2/fungible/route

Body

Response