Metadata (tokens, swappers, blockchains)

get https://api.rango.exchange/meta

This service fetches all the required data to fill the swap UI, including list of all tokens, swappers (DEXes & Bridges), and all blockchains' metadata.

Query Params

blockchains

array of strings

The list of all accepted blockchains. An empty list means no filter is required

blockchains

blockchainsExclude

boolean

Defines the provided blockchains as the include/exclude list. Default is false (include)

swappers

array of strings

The list of all accepted swappers. An empty list means no filter is required

swappers

swappersExclude

boolean

Defines the provided swappers as the include/exclude list. Default is false (include)

swapperGroups

array of strings

The list of all included/excluded swappers based on tag, empty list means no filter is required

swapperGroups

swappersGroupsExclude

boolean

Defines the provided swappers' tags as the include/exclude list. Default is false (include)

transactionTypes

array of strings

Blockchain Type

transactionTypes

transactionTypesExclude

boolean

Defines the provided swappers' tags as the include/exclude list. Default is false (include)

excludeSecondaries

boolean

Exclude secondary tokens. Default is false (include)

excludeNonPopulars

boolean

Exclude non popular tokens. Default is false (include)

enableCentralizedSwappers

boolean

Specify that centralized swappers must be included in swappers or not. Default is false (exclude)

Responses

Response body

object

tokens

array of objects

required

List of all tokens

tokens*

object

blockchain

string

required

The blockchain which this token belongs to

ETH BSC ARBITRUM POLYGON ZKSYNC STARKNET OPTIMISM AVAX_CCHAIN POLYGONZK BASE LINEA MODE TRON BTC SCROLL BLAST COSMOS OSMOSIS NEUTRON NOBLE DYDX SOLANA CRONOS BNB FANTOM AURORA MAYA THOR BOBA MOONBEAM MOONRIVER OKC BOBA_BNB BOBA_AVALANCHE LTC BCH HARMONY EVMOS HECO METIS SIF BRISE STARGAZE FUSE CRYPTO_ORG CHIHUAHUA BANDCHAIN COMDEX REGEN IRIS EMONEY GNOSIS JUNO AXELAR STRIDE KCC MARS TERRA TELOS BITSONG AKASH KI PERSISTENCE MEDIBLOC KUJIRA SENTINEL INJECTIVE SECRET KONSTELLATION STARNAME BITCANNA UMEE DESMOS LUMNETWORK TERRA_CLASSIC CELO DASH SHIMMER XLAYER IOTA POLKADOT DOGE GOERLI GOERLI_ARBITRUM GOERLI_OPTIMISM

symbol

string

required

The display symbol, e.g. USDT, BTC, etc.

image

string

required

Url of its image

address

string

Smart contract address of token, null for native tokens

usdPrice

double

USD unit price of this token if available

decimals

int32

Decimals of token in blockchain

name

string

Display name of token, e.g: Cardano for ADA. It can be null

isPopular

boolean

required

If true, means that the token is popular token on the blockchain

isSecondaryCoin

boolean

required

If true, means that the token's trading is high risk. Better to warn user before proceeding

coinSource

string

If the token is secondary, coinSource indicates the third-party list that Rango found this token in

coinSourceUrl

string

The url of the list that token was extracted from

supportedSwappers

array of strings

required

Supported swappers for this token

supportedSwappers*

popularTokens

array of objects

required

List of popular tokens, a subset of tokens field

popularTokens*

object

blockchain

string

required

The blockchain which this token belongs to

symbol

string

required

The display symbol, e.g. USDT, BTC, etc.

image

string

required

Url of its image

address

string

Smart contract address of token, null for native tokens

usdPrice

double

USD unit price of this token if available

decimals

int32

Decimals of token in blockchain

name

string

Display name of token, e.g: Cardano for ADA. It can be null

isPopular

boolean

required

If true, means that the token is popular token on the blockchain

isSecondaryCoin

boolean

required

If true, means that the token's trading is high risk. Better to warn user before proceeding

coinSource

string

If the token is secondary, coinSource indicates the third-party list that Rango found this token in

coinSourceUrl

string

The url of the list that token was extracted from

supportedSwappers

array of strings

required

Supported swappers for this token

supportedSwappers*

blockchains

array of objects

required

List of all supported blockchains

blockchains*

object

name

string

required

Unique name of blockchain, this field is used in all endpoints as the identifier of blockchain

defaultDecimals

int32

required

The default decimals of blockchain, do not use it in computations, use Token.decimals instead

addressPatterns

array of strings

required

List of all regex patterns for wallet addresses of this blockchain, can be used for input validation

addressPatterns*

feeAssets

array of objects

required

List of assets that can be used as fee in this blockchain

feeAssets*

object

blockchain

string

required

The blockchain which this token belongs to

symbol

string

required

The display symbol, e.g. USDT, BTC, etc.

address

string

Smart contract address of token, null for native tokens

logo

string

required

Asset logo address

displayName

string

required

Blockchain name

shortName

string

required

Blockchain short name

sort

int32

required

Blockchain index in response list

color

string

required

Blockchain theme color

enabled

boolean

required

If blockchain server is enabled

type

string

required

Blockchain transaction type. e.g. EVM

EVM TRANSFER COSMOS SOLANA ZK_ROLLUP TRON STARKNET

chainId

string

Blockchain chain id in hex

info

swappers

array of objects

required

List of all DEXes & Bridges

swappers*

object

string

required

title

string

required

logo

string

required

swapperGroup

string

required

types

array of strings

types

enabled

boolean

required

400

Bad client request

403

Forbidden

429

Too many requests

500

Internal error

Language

Credentials

Query


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.rango.exchange/meta?apiKey=c6381a79-2817-4602-83bf-6a641a409e32' \
3
     --header 'accept: */*'

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200OK

404Not Found