Get Direct Tokens

List of all tokens which can be swapped from a given token

Connected Assets API

This is an experimental endpoint that you could use to find which tokens can be swapped from a given token using one single step transaction.

Typescript (SDK)

const connectedAssets = await rango.connectedAssets({
    from: {
        "blockchain": "ETH", 
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
    }
})

Node.js (Axios)

const response = await axios.get('https://api.rango.exchange/basic/connected-assets', {
  params: {
    'from': 'ETH--0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
    'apiKey': 'c6381a79-2817-4602-83bf-6a641a409e32'
  }
});

Bash (cURL)

curl --request GET \
     --url 'https://api.rango.exchange/basic/connected-assets?from=ETH--0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&apiKey=c6381a79-2817-4602-83bf-6a641a409e32' 

Connected Assetsrango-exchange

Connected Assets Swagger

Experimental API Warning

This experimental API provides a rough estimate of direct tokens available from each token. It is not recommended for general use unless you have a specific requirement that cannot be met with other methods. Typically, you can use the quote or swap methods directly without needing to check connected assets in advance.

Connected Assets Request

API Definition

• from* String

  • Description: The asset which is going to be swapped into other assets.

  • Example: ETH--0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

SDK Models (Typescript)

export type ConnectedAssetsRequest = {
  from: RequestedAsset
}

export type RequestedAsset = {
  blockchain: string
  address: string | null
  symbol: string
}

Connected Assets Response

Returns a list of blockchains + assets of that blockchain that is directly available. Note: If list of assets is empty, it means almost all tokens on this specific chain are accessible from the given token.

API Definition

• data

  • Description: List of all possible destination assets for the provided source asset.

SDK Models (Typescript)

export type ConnectedAssetsResponse = {
  data: ConnectedAsset[]
}

export type ConnectedAsset = {
  blockchain: string
  assets: Asset[]
}

export type Asset = {
  blockchain: string
  address: string | null
  symbol: string
}

Sample Response

This response indicates that the asset in request is nearly swappable with all assets on the ETH and BSC blockchains, but it only has a direct route to certain specific tokens on BOBA or EVMOS.

{
  "data": [
    {
      "blockchain": "ETH",
      "assets": []
    },
    {
      "blockchain": "BSC",
      "assets": []
    },
    {
      "blockchain": "BOBA",
      "assets": [
        {
          "blockchain": "BOBA",
          "symbol": "USDC",
          "address": "0x66a2a913e447d6b4bf33efbec43aaef87890fbbc"
        }
      ]
    },
    {
      "blockchain": "EVMOS",
      "assets": [
        {
          "blockchain": "EVMOS",
          "symbol": "CEUSDC",
          "address": "0xe46910336479f254723710d57e7b683f3315b22b"
        }
      ]
    }
  ]
}