Skip to main content

Get Routes

Gets all swap routes available when swapping the specified token_in to receive the specified token_out.

Request URL

https://testnet.api.euclidprotocol.com/api/v1/routes

Curl

curl -X 'POST' \
'https://testnet.api.euclidprotocol.com/api/v1/routes' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"external": true,
"token_in": "euclid",
"token_out": "0g",
"amount_in": "1000000",
"chain_uids": []
}'


ParameterTypeRequiredDescription
amount_inStringYesThe amount of tokens being swapped in.
token_inStringYesThe identifier of the token being swapped in.
token_outStringYesThe identifier of the token desired to receive.
externalBooleanNoIf true, includes routes that may involve external chains.
chain_uidsArrayNoOptional list of specific chain UIDs to restrict routing paths.

Example Response

{
"paths": [
{
"path": [
{
"route": [
"euclid",
"0g"
],
"dex": "euclid",
"amount_in": "1000000",
"amount_out": "47039472846823928",
"chain_uid": "vsl",
"amount_out_for_hops": [
"0g: 47039472846823928"
]
}
],
"total_price_impact": "0.76"
},
{
"path": [
{
"route": [
"euclid",
"gimo",
"0g"
],
"dex": "euclid",
"amount_in": "1000000",
"amount_out": "47196320447745512",
"chain_uid": "vsl",
"amount_out_for_hops": [
"gimo: 992618817702689792",
"0g: 47196320447745512"
]
}
],
"total_price_impact": "0.43"
}
]
}