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
}

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)

​
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

​
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

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

​
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

​
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