@import url('https://fonts.googleapis.com/css2?family=Inconsolata:wght@200..900&display=swap');

h1, h2, h3, #navbar {
  font-family: "Inconsolata", monospace;
}

.dark #navbar {
  background-color: #121213;
}


Skip

API Reference

Skip:Connect

Research

Jobs

Request asset recommendations for the given source assets on a given destination chain. The response includes recommended destination assets and recommendation reasons.

Post /v2/fungible/recommend_assets

Number of decimals used for amounts of the asset

URI pointing to an image of the logo of the asset

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

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

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

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

Error detail: * LOW_INFO_ERROR - Not enough asset pricing information to determine the price safety of the route. * BAD_PRICE_ERROR - The execution price of the route deviates significantly from the current market price.

grpc status codes as defined [here](https://grpc.github.io/grpc/core/md_doc_statuscodes.html)

Recommendation reason: * UNKNOWN - Unknown recommendation reason. * MOST_LIQUID - Highest liquidity form of the transferred token on the destination chain. * BASE_TOKEN - The base token if the destination chain is the origin chain of the source token. * DIRECT - The token resulting from the least amount of transfers to the destination chain.

This pages explains what the Skip Go API is, gives examples of applications built with it, and provides guidance on standard ways to use it.

Introduction

Quickstart Guide

Overview & Common Usage Patterns

Supported Ecosystems

This document covers the tooling provided in Skip Go API for tracking transaction status across multiple chains and bridge hops.

Transaction Tracking

Requesting & Using API Keys

This page covers Smart Relay -- Skip Go API's universal cross-chain data & token delivery service

Smart Relay

How to specify actions to perform after a route of transfers/swaps is completed

Post-Route Actions

This page covers how integrators can earn affiliate fees on swaps.

Setting Affiliate Fees

This doc describes functionality in Skip Go API for accessing and understanding user-facing fees

Getting Fee Info

This page highlights a few of the features we're cooking up 🧑‍🍳. Please get in touch with us if you'd like us to prioritize any of these or add something else to our roadmap

Upcoming Features

Getting Started

Configuration Options

Web Component

Experimental Features

Common Questions

Recommendations

Basic documentation for Skip Go Client, a TypeScript Package (@skip-go/client) that simplifies the process of interacting with the Skip Go API

This doc describes the gas and fee tooling in @skip-go/client (our typescript library)

Gas and Transaction Fee Tooling

Router SDK Migration Guide

This page covers the different ways our cross-chain swaps + transfers might fail to help identify failures and manage user expectations

Cross-chain Failure Cases

This page describes the IBC token routing problem and the algorithm Skip Go API uses to select / recommend token denoms and IBC paths

IBC Token Routing: Problem + Skip Go API Routing Algorithm

This doc covers how to interact with the EvmTx type returned by the Skip Go API

EVM Transactions Intro

This document explains how to use Skip Go API and Client TypeScript Package to construct SVM transactions.

SVM Transactions Intro

CW20 Tokens & Their Limitations

This page provides a living record of the features that can be turned on with the experimental_features flag

This doc covers the various ways route quote quality is measured -- slippage, USD estimates of the amount in and out, and price impact

Understanding Quote Quality Metrics

`allow_unsafe`: Preventing & Handling Bad Execution

SAFE Swapping: How to Protect Users from Bad Trades

This page introduces the Smart Swap functionality provided by the Skip Go API to improve swap speed, price, and customization.

Smart Swap

This document describes what new chains need to do the support Skip Go API

Chain Support Requirements

This document describes the steps you must complete for the Skip Go API to begin providing new routes for users to transfer a token over to various remote chains using IBC.

Token & Route Support Requirements

This document covers what Skip Go API requires of DEXes to support them as potential swapping venues within the API's cross-chain DEX aggregation functionality. At the end, the document provides instructions for helping the Skip team add your DEX to the API as a swapping venue

Swap Venue Requirements

This guide provides step-by-step instructions to generate go.skip.build shareable links.

How to Generate Shareable Links

This guide provides step-by-step instructions to embed the Skip Go API widget into your project.

How to Embed iframe Widget

Get all supported chains along with additional data useful for building applications + frontends that interface with them (e.g. logo URI, IBC capabilities, fee assets, bech32 prefix, etc...)

Get /v2/info/chains

Get /v2/info/bridges

Get /v2/fungible/venues

Get supported assets. Optionally limit to assets on a given chain and/or native assets.

Get /v2/fungible/assets

Get assets that can be reached from a source via transfers under different conditions (e.g. single vs multiple txs)

Post /v2/fungible/assets_from_source

This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns the sequence of transfers and/or swaps to reach the given destination asset from the given source asset, along with estimated amount out. Commonly called before /msgs to generate route info and quote.

Post /v2/fungible/route

This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns minimal number of messages required to execute a multi-chain swap or transfer. Input consists of the output of route with additional information required for message construction (e.g. destination addresses for each chain)

Post /v2/fungible/msgs

This supports cross-chain actions among EVM chains, Cosmos chains, and between them. Returns minimal number of messages required to execute a multi-chain swap or transfer. This is a convenience endpoint that combines /route and /msgs into a single call.

Post /v2/fungible/msgs_direct

Get origin assets from a given list of denoms and chain ids.

Post /v2/fungible/ibc_origin_assets

Given 2 chain ids, returns a list of equivalent assets that can be transferred

Post /v2/fungible/assets_between_chains

Submit a signed base64 encoded transaction to be broadcast to the specified network. On successful submission, the status of the transaction and any subsequent IBC or Axelar transfers can be queried through the /status endpoint.

Post /v2/tx/submit

Requests tracking of a transaction that has already landed on-chain but was not broadcast through the Skip Go API. The status of a tracked transaction and subsequent IBC or Axelar transfers if routing assets cross chain can be queried through the /status endpoint.

Post /v2/tx/track

Get the status of the specified transaction and any subsequent IBC or Axelar transfers if routing assets cross chain. The transaction must have previously been submitted to either the /submit or /track endpoints.

Prod Endpoints

Post /v2/fungible/recommend_assets

Body

Response