Skip to Content
PairsGet Pairs

Get pairs

GET/v3/pairs

Description

Get a list of all the pairs that are available for exchange considering the user’s location.

If the exchange is blocked in the user’s location (based on their IP), this endpoint will respond with an empty array.

How to filter available pairs

In your app, you can filter the available pairs, so the user can select from the combinations that are swapable.

filter pairs
const pairs = await fetch('https://exchange.exodus.io/v3/pairs?format=csv').then((res) =>
  res.json()
);
 
const availableFromAssets = assets.filter((asset) =>
  pairs.some((pair) => {
    const [from] = pair.split('_');
    return from === asset.id;
  })
);
 
const availableToAssets = assets.filter((asset) =>
  pairs.some((pair) => {
    const [from, to] = pair.split('_');
    return from === fromAssetId && to === asset.id;
  })
);

Header Parameters

NameDescriptionRequiredExample
App-NameApp-Name for the authorizationyesacme-inc
App-VersionApp-Version for the authorizationno23.5.5
ForwardedIf you are proxying requests to the API, you must include the "Forwarded" header with the original request IP address. This is used for geolocation availability purposes.no
User-AgentUser-Agent for the authorizationnoAgentName/1.0.0

Query Parameters

NameDescriptionRequiredDefaultOptions
to[ 2 .. 10 ] charactersno
from[ 2 .. 10 ] charactersno
formatChange the response type to optimize the network transfer size.nojsonjson, csv

Try it

https://exchange.exodus.io/v3/pairs?
Press on the 'Send' button to try this request.
Last updated on