Rango Docs
API SwaggerWidget PlaygroundAppWebsite
  • 👋Welcome to Rango
  • 🏠Introduction
  • 💁How It Works
  • ✅Integrations
  • ⚖️Rango vs. Competitors
  • 🔐Security
  • 🛣️Roadmap
  • 🦎Tokenomics
  • 💰Airdrop
  • ❓FAQ
  • 🐞Bug Bounty
  • API Integration
    • 🔡Terminology
    • 🚄API Key & Rate Limits
    • 🤝Choosing the Right API
    • 🦄Basic API - Single Step
      • 🛝API Flow
      • ⚙️API Reference
        • Get Blockchains & Tokens
        • Get Quote
        • Create Transaction (Swap)
        • Check Transaction Status
        • Check Approve Transaction Status
        • Get Address Assets & Balances
        • Get Token Balance
        • Report Transaction Failure
        • Get Direct Tokens
        • Get Custom Token
        • Message Passing
      • 🎓Tutorial
        • 🍰SDK Example
      • 💰Monetization
      • 🎹Sample Transactions
      • ✅Integration Checklist
    • 🦎Main API - Multi Step
      • 🛝API Flow
      • ⚙️API Reference
        • Get Blockchains & Tokens
        • Get Best Route
        • Get All Possible Routes
        • Confirm Route
        • Create Transaction
        • Check Transaction Status
        • Check Approve Transaction Status
        • Report Transaction Failure
        • Get Custom Token
        • Get Address Token Balance
      • 🎓Tutorial
        • 🍰SDK Example
      • 💰Monetization
      • 🎹Sample Transactions
  • ℹ️API Troubleshooting
  • Technical Docs
    • 🍔Swap Aggregation
    • 💰Monetization
    • ⛽Fee Structure
    • ⛽Network Fees and Gas Estimates
    • ⌛Stuck Transactions
  • Widget Integration
    • 🧩Overview
    • 🎇Quick Start
    • ⚙️Customization
    • 💰Monetization
    • 🛣️React Router
    • 🎵Events
    • 💳External Wallets
  • Smart Contracts
    • 👩‍💼Architecture
    • 🔎Audit Reports
    • 🏗️Deployment Addresses
    • 📩Message Passing
  • Ask for Integration
    • 🙋‍♂️DEXs & DEX Aggregators
    • 📱Rango Mobile SDK
  • Useful Links
    • Twitter
    • Discord Server
    • TG Announcements
    • TG Group
  • Terms of Use
  • Privacy policy
Powered by GitBook
On this page
  • Get Full Metadata API
  • Metadata Request
  • Metadata Response
  • Get Specific Part of Metadata
  • Get List of Blockchains API
  • Get List of Swappers API

Was this helpful?

  1. API Integration
  2. Main API - Multi Step
  3. API Reference

Get Blockchains & Tokens

Get all blockchains, tokens and swappers meta data

PreviousAPI ReferenceNextGet Best Route

Last updated 8 months ago

Was this helpful?

Get Full Metadata API

This service gathers all the essential data needed for a swap's UI, including list of all , and (DEXes & Bridges) metadata.

// basic usage
const meta = await rango.getAllMetadata()
const response = await axios.get('https://api.rango.exchange/meta', {
  params: {
    'apiKey': 'c6381a79-2817-4602-83bf-6a641a409e32'
  }
});
curl --request GET \
     --url 'https://api.rango.exchange/meta?apiKey=c6381a79-2817-4602-83bf-6a641a409e32' 
// filtering blockchains, swappers and tokens
const meta = await rango.getAllMetadata({
    blockchains: ['ETH', 'POLYGON'],
    blockchainsExclude: false,
    swappers: ['Across', 'OneInchEth'],
    swappersExclude: false,
    swappersGroups: ['Across', '1Inch'],
    swappersGroupsExclude: false,
    transactionTypes: ['EVM'],
    transactionTypesExclude: false,
    excludeNonPopulars: false
})
const response = await axios.get('https://api.rango.exchange/meta', {
  params: {
    'apiKey': 'c6381a79-2817-4602-83bf-6a641a409e32',
    'blockchains': 'ETH,POLYGON',
    'blockchainsExclude': false,
    'swappers': 'Across,OneInchEth',
    'swappersExclude': false,
    'swapperGroups': 'Across,1Inch',
    'swappersGroupsExclude': false,
    'transactionTypes': 'EVM',
    'transactionTypesExclude': false,
    'excludeNonPopulars': false
  }
});
curl --request GET \
     --url 'https://api.rango.exchange/meta?blockchains=ETH&blockchains=POLYGON&blockchainsExclude=false&swappers=Across&swappers=OneInchEth&swappersExclude=false&swapperGroups=Across&swapperGroups=1Inch&swappersGroupsExclude=false&transactionTypes=EVM&transactionTypesExclude=false&excludeNonPopulars=false&apiKey=c6381a79-2817-4602-83bf-6a641a409e32'

Why is it required to obtain the list of supported tokens from Rango API?

Even if dApp has its own list of tokens and blockchains, it's still useful to get list of supported tokens by Rango:

  • To avoid extra API call when token is not supported by Rango

  • Access tokens' symbol which is required for getting quote for each token.

Why is it recommended to obtain the list of supported blockchains from Rango API?

  • For working with other API methods like getBestRoute, you need to have identifier (name) of each blockchain. You could hard code blockchain names if you want to have limited chains support or get them dynamically via the API. (You could store a map of each blockchain chainId to Rango name if required.)

  • Because of different reasons like blockchains maintenance, Rango maintenance, hacks, and etc, a blockchain could be disabled in Rango. You could check which blockchains are enabled now using enabled flag for each blockchain in meta response.

Metadata Request

  • blockchains String

    • Description: Pass comma separated list of blockchains if you want to filter meta blockchains to some specific ones.

    • Example: POLYGON,ETH

  • blockchainsExclude Boolean

    • Description: A boolean value indicating whether the specified blockchains should be excluded or included in the response.

    • Example: true

  • swappers String

    • Description: Pass comma separated list of swappers if you want to filter meta swappers to some specific ones.

    • Example: Across,OneInchEth

  • swappersExclude Boolean

    • Description: A boolean value indicating whether the specified swappers should be excluded or included in the response.

    • Example: false

  • swappersGroups String

    • Description: Pass comma separated list of swapper groups if you want to filter meta swapper groups to some specific ones.

    • Example: Across,1Inch

  • swappersGroupsExclude Boolean

    • Description: A boolean value indicating whether the specified swapper groups should be excluded or included in the response.

    • Example: false

  • transactionTypes String

    • Description: Pass comma separated list of transaction types if you want to filter blockchains types to some specific ones.

    • Example: EVM,COSMOS

  • transactionTypesExclude Boolean

    • Description: A boolean value indicating whether the specified transaction types should be excluded or included in the response.

    • Example: false

  • excludeSecondaries Boolean

    • Description: It indicates whether secondary tokens should be excluded from the response. By secondary tokens, we mean tokens that are imported from our secondary tokens lists.

    • Example: false

  • excludeNonPopulars Boolean

    • Description: It indicates whether non-popular tokens should be excluded from the response. By popular tokens, we mean native token and stable coins of each blockchain.

    • Example: false

  • ignoreSupportedSwappers Boolean

    • Description: Set this flag to false to exclude the supported swappers for each token from the response. The default value is true.

    • Example: false

  • enableCentralizedSwappers Boolean

    • Description: Set this flag to true if you want to enable routing through the centralized solutions and obtain the associated metadata, including related swappers and tokens. The default value for this argument is false.

    • Example: true

export type MetaRequest = {
  blockchains?: string[]
  blockchainsExclude?: boolean
  swappers?: string[]
  swappersExclude?: boolean
  swappersGroups?: string[]
  swappersGroupsExclude?: boolean
  transactionTypes?: TransactionType[]
  transactionTypesExclude?: boolean
  excludeSecondaries?: boolean
  excludeNonPopulars?: boolean
  ignoreSupportedSwappers?: boolean
  enableCentralizedSwappers?: boolean
}

export enum TransactionType {
  EVM = 'EVM',
  TRANSFER = 'TRANSFER',
  COSMOS = 'COSMOS',
  SOLANA = 'SOLANA',
  TRON = 'TRON',
  STARKNET = 'STARKNET',
  TON = 'TON',
}

Metadata Response

  • blockchains

  • tokens

  • popularTokens

    • Description: List of all popular tokens

  • swappers

export type MetaResponse = {
  blockchains: BlockchainMeta[]
  tokens: Token[]
  popularTokens: Token[]
  swappers: SwapperMeta[]
}

export type BlockchainMeta =
  | EvmBlockchainMeta
  | CosmosBlockchainMeta
  | TransferBlockchainMeta
  | SolanaBlockchainMeta
  | StarkNetBlockchainMeta
  | TronBlockchainMeta
  | TonBlockchainMeta

export type Token = {
  blockchain: string
  address: string | null
  symbol: string
  name: string | null
  decimals: number
  image: string
  usdPrice: number | null
  isSecondaryCoin: boolean
  coinSource: string | null
  coinSourceUrl: string | null
  isPopular: boolean
  supportedSwappers?: string[]
}

export type SwapperMeta = {
  id: string
  title: string
  logo: string
  swapperGroup: string
  types: SwapperType[]
  enabled: boolean
}

export type SwapperType = 'BRIDGE' | 'DEX' | 'AGGREGATOR' | 'OFF_CHAIN'

export type BlockchainMetaBase = {
  type: TransactionType
  name: string
  shortName: string
  displayName: string
  defaultDecimals: number
  feeAssets: Asset[]
  addressPatterns: string[]
  logo: string
  color: string
  sort: number
  enabled: boolean
  chainId: string | null
  info:
  | EVMChainInfo
  | CosmosChainInfo
  | StarkNetChainInfo
  | TronChainInfo
  | null
}

export interface EvmBlockchainMeta extends BlockchainMetaBase {
  type: TransactionType.EVM
  chainId: string
  info: EVMChainInfo
}

export interface CosmosBlockchainMeta extends BlockchainMetaBase {
  type: TransactionType.COSMOS
  chainId: string | null
  info: CosmosChainInfo | null
}

export interface TransferBlockchainMeta extends BlockchainMetaBase {
  type: TransactionType.TRANSFER
  chainId: null
  info: null
}

export interface SolanaBlockchainMeta extends BlockchainMetaBase {
  type: TransactionType.SOLANA
  chainId: string
  info: null
}

export interface StarkNetBlockchainMeta extends BlockchainMetaBase {
  type: TransactionType.STARKNET
  chainId: string
  info: StarkNetChainInfo
}

export interface TronBlockchainMeta extends BlockchainMetaBase {
  type: TransactionType.TRON
  chainId: string
  info: TronChainInfo
}

export interface TonBlockchainMeta extends BlockchainMetaBase {
  type: TransactionType.TON
  chainId: string
  info: null
}
{
  "tokens": [
    {
      "blockchain": "ETH",
      "symbol": "USDT",
      "image": "https://rango.vip/i/r3Oex6",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "usdPrice": 0.999631,
      "decimals": 6,
      "name": "USD Tether",
      "isPopular": true,
      "isSecondaryCoin": false,
      "coinSource": null,
      "coinSourceUrl": null,
      "supportedSwappers": [
        "ThorChain",
        "Arbitrum Bridge",
        "Hyphen"
      ]
    },
  ],
  "popularTokens": [
    {
      "blockchain": "BSC",
      "symbol": "USDT",
      "image": "https://rango.vip/i/6837hX",
      "address": "0x55d398326f99059ff775485246999027b3197955",
      "usdPrice": 0.999554,
      "decimals": 18,
      "name": "Tether USD",
      "isPopular": true,
      "isSecondaryCoin": false,
      "coinSource": null,
      "coinSourceUrl": null,
      "supportedSwappers": [
        "ThorChain"
      ]
    }
  ],
  "blockchains": [
    {
      "name": "OPTIMISM",
      "defaultDecimals": 18,
      "addressPatterns": [
        "^(0x)[0-9A-Fa-f]{40}$"
      ],
      "feeAssets": [
        {
          "blockchain": "OPTIMISM",
          "symbol": "ETH",
          "address": null
        }
      ],
      "logo": "https://raw.githubusercontent.com/rango-exchange/assets/main/blockchains/OPTIMISM/icon.svg",
      "displayName": "Optimism",
      "shortName": "Optimism",
      "sort": 6,
      "color": "#FF0420",
      "enabled": true,
      "type": "EVM",
      "chainId": "0xa",
      "info": {
        "infoType": "EvmMetaInfo",
        "chainName": "Optimism",
        "nativeCurrency": {
          "name": "ETH",
          "symbol": "ETH",
          "decimals": 18
        },
        "rpcUrls": [
          "https://mainnet.optimism.io"
        ],
        "blockExplorerUrls": [
          "https://optimistic.etherscan.io"
        ],
        "addressUrl": "https://optimistic.etherscan.io/address/{wallet}",
        "transactionUrl": "https://optimistic.etherscan.io/tx/{txHash}",
        "enableGasV2": false
      }
    },
  ],
  "swappers": [
    {
      "id": "Diffusion",
      "title": "Diffusion",
      "logo": "https://raw.githubusercontent.com/rango-exchange/assets/main/swappers/Diffusion/icon.svg",
      "swapperGroup": "Diffusion",
      "types": [
        "DEX"
      ],
      "enabled": false
    }
  ]
}

Get Specific Part of Metadata

If you only want to load a specific part of metadata rather than full metadata, i.e. only blockchains data, tokens list or supported protocols, you can use the following methods/endpoints:

Get List of Blockchains API

const meta = await rango.getBlockchains()
const response = await axios.get('https://api.rango.exchange/meta/blockchains', {
  params: {
    'apiKey': 'c6381a79-2817-4602-83bf-6a641a409e32'
  }
});
curl --request GET \
     --url 'https://api.rango.exchange/meta/blockchains?apiKey=c6381a79-2817-4602-83bf-6a641a409e32'

Get List of Swappers API

const meta = await rango.getSwappers()
const response = await axios.get('https://api.rango.exchange/meta/swappers', {
  params: {
    'apiKey': 'c6381a79-2817-4602-83bf-6a641a409e32'
  }
});
curl --request GET \
     --url 'https://api.rango.exchange/meta/swappers?apiKey=c6381a79-2817-4602-83bf-6a641a409e32'

Description: List of all supported

Description: List of all

Description: List of all supported (DEXes & Bridges)

🦎
⚙️
blockchains
tokens
protocols
blockchains
tokens
protocols
Metadata (tokens, swappers, blockchains)rango-exchange
GET Metadata Swagger
Logo
Blockchains Metadatarango-exchange
GET Blockchains Swagger
Logo
Swappers Metadatarango-exchange
GET Swappers Swagger
Logo