Comment on page

Metadata API

Get all blockchains, tokens and swappers meta data

Get Full Metadata (Test)​
This service gathers all the essential data needed for a swap's UI, including a list of all blockchains, tokens and protocols (DEXs & Bridges) metadata.
Typescript
cURL
const meta = await rangoClient.meta({
    blockchains: ['ETH', 'POLYGON'],
    blockchainsExclude: false,
    swappers: ['Across', 'OneInchEth'],
    swappersExclude: false,
    swappersGroups: ['Across', '1Inch'],
    swappersGroupsExclude: false,
    transactionTypes: ['EVM'],
    transactionTypesExclude: false,
    excludeNonPopulars: false
})
curl --request GET \
     --url 'https://api.rango.exchange/basic/meta?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' \
     --header 'accept: */*'
Metadata (tokens, swappers, blockchains)
rango-exchange
GET Metadata Swagger
Metadata Request 
Param
Description
blockchains
Pass comma separated list of blockchains if you want to filter meta blockchains to some specific ones. (e.g. POLYGON,ETH)
blockchainsExclude
A boolean value indicating whether the specified blockchains should be excluded or included in the response.
swappers
Pass comma separated list of swappers if you want to filter meta swappers to some specific ones. (e.g. Across,OneInchEth)
swappersExclude
A boolean value indicating whether the specified swappers should be excluded or included in the response.
swappersGroups
Pass comma separated list of swapper groups if you want to filter meta swapper groups to some specific ones. (e.g. Across,1Inch)
swappersGroupsExclude
A boolean value indicating whether the specified swapper groups should be excluded or included in the response.
transactionTypes
Pass comma separated list of transaction types if you want to filter blockchains types to some specific ones. (e.g. EVM,COSMOS)
transactionTypesExclude
A boolean value indicating whether the specified transaction types should be excluded or included in the response.
excludeSecondaries
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.
excludeNonPopulars
It indicates whether non-popular tokens should be excluded from the response. By populars tokens, we mean native token and stable coins of each blockchain.
Metadata Response 
Field
Description
blockchains
List of all supported blockchains
tokens
List of all tokens
swappers
List of all supported protocols (DEXs & Bridges)
Get Specific Part of Metadata
If you only want to load a specific part of metadata rather than full metadata, i.e. blockchains, tokens or swappers, you can use the following endpoints:
Get List of Blockchains (Test)​
Typescript
cURL
const meta = await rangoClient.chains()
curl --request GET \
     --url 'https://api.rango.exchange/basic/meta/blockchains?apiKey=c6381a79-2817-4602-83bf-6a641a409e32' \
     --header 'accept: */*'
Blockchains Metadata
rango-exchange
GET Blockchains Swagger
Get List of Swappers (Test)​
Typescript
cURL
const meta = await rangoClient.swappers()
curl --request GET \
     --url 'https://api.rango.exchange/basic/meta/swappers?apiKey=c6381a79-2817-4602-83bf-6a641a409e32' \
     --header 'accept: */*'
Swappers Metadata
rango-exchange
GET Swappers Swagger 
Get List of Cross-Chain Messaging Protocols (Test)​
Typescript
cURL
const meta = await rangoClient.messagingProtocols()
curl --request GET \
     --url 'https://api.rango.exchange/basic/meta/messaging-protocols?apiKey=c6381a79-2817-4602-83bf-6a641a409e32' \
     --header 'accept: */*'
Messaging Protocols Metadata
rango-exchange
GET Messaging Protocols Swagger 

Param	Description
blockchains	Pass comma separated list of blockchains if you want to filter meta blockchains to some specific ones. (e.g. `POLYGON,ETH`)
blockchainsExclude	A boolean value indicating whether the specified blockchains should be excluded or included in the response.
swappers	Pass comma separated list of swappers if you want to filter meta swappers to some specific ones. (e.g. `Across,OneInchEth`)
swappersExclude	A boolean value indicating whether the specified swappers should be excluded or included in the response.
swappersGroups	Pass comma separated list of swapper groups if you want to filter meta swapper groups to some specific ones. (e.g. `Across,1Inch`)
swappersGroupsExclude	A boolean value indicating whether the specified swapper groups should be excluded or included in the response.
transactionTypes	Pass comma separated list of transaction types if you want to filter blockchains types to some specific ones. (e.g. `EVM,COSMOS`)
transactionTypesExclude	A boolean value indicating whether the specified transaction types should be excluded or included in the response.
excludeSecondaries	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.
excludeNonPopulars	It indicates whether non-popular tokens should be excluded from the response. By populars tokens, we mean native token and stable coins of each blockchain.

Field	Description
blockchains	List of all supported blockchains
tokens	List of all tokens
swappers	List of all supported protocols (DEXs & Bridges)

Basic API (Single TX)

Connections API

Last modified 3mo ago

Metadata API

Get Full Metadata (Test)​

Metadata Request

Metadata Response

Get Specific Part of Metadata

Get List of Blockchains (Test)​

Get List of Swappers (Test)​

Get List of Cross-Chain Messaging Protocols (Test)​

Get Full Metadata (Test)

Get List of Blockchains (Test)

Get List of Swappers (Test)

Get List of Cross-Chain Messaging Protocols (Test)