Route

curl -L \
  "https://api.fibrous.finance/hyperevm/route?amount=1000000000000000000&tokenInAddress=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&tokenOutAddress=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb" \
  --header "Accept: */*"

import requests

url = "https://api.fibrous.finance/hyperevm/route"

params = {
    "amount": "1000000000000000000",  # 1 HYPE
    "tokenInAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
    "tokenOutAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb"
}

response = requests.get(url, params=params)
print(response.json())

const axios = require('axios');

const params = {
  amount: '1000000000000000000', // 1 HYPE
  tokenInAddress: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee',
  tokenOutAddress: '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
};

axios.get('https://api.fibrous.finance/hyperevm/route', { params })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

{
    "success": true,
    "routeSwapType": 0,
    "inputToken": {
        "name": "Wrapped HYPE",
        "address": "0x5555555555555555555555555555555555555555",
        "decimals": 18,
        "price": "55.19"
    },
    "inputAmount": "10000000000000000000",
    "outputToken": {
        "name": "USD₮0",
        "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
        "decimals": 6,
        "price": "1.001"
    },
    "outputAmount": "551482197",
    "time": 0.257,
    "estimatedGasUsed": "50659003741392",
    "estimatedGasUsedInUsd": 0.005660637078063142,
    "route": [
        {
            "percent": "100%",
            "swaps": [
                [
                    {
                        "protocol": 13,
                        "poolName": "hybraFinanceV3",
                        "poolAddress": "0x5a716e045421b0977ca5bfb4f3394139c6a069bc",
                        "fromTokenAddress": "0x5555555555555555555555555555555555555555",
                        "toTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "percent": "100.00%",
                        "extraData": {
                            "fee": 25
                        }
                    }
                ],
                [
                    {
                        "protocol": 18,
                        "poolName": "kittenSwapAlgebraV4",
                        "poolAddress": "0x3cf44ef1500c1d559c8e81dffd6baeb0966b2712",
                        "fromTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "toTokenAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                        "percent": "98.00%",
                        "extraData": null
                    },
                    {
                        "protocol": 15,
                        "poolName": "gLiquidV3",
                        "poolAddress": "0x5e43a757ba769d4cd5fe568ae2429d4ae69e0ecf",
                        "fromTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "toTokenAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                        "percent": "2.00%",
                        "extraData": null
                    }
                ]
            ]
        }
    ],
    "bestQuotesByProtocols": [],
    "initial": false
}

GET

hyperevm

route

curl -L \
  "https://api.fibrous.finance/hyperevm/route?amount=1000000000000000000&tokenInAddress=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&tokenOutAddress=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb" \
  --header "Accept: */*"

import requests

url = "https://api.fibrous.finance/hyperevm/route"

params = {
    "amount": "1000000000000000000",  # 1 HYPE
    "tokenInAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
    "tokenOutAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb"
}

response = requests.get(url, params=params)
print(response.json())

const axios = require('axios');

const params = {
  amount: '1000000000000000000', // 1 HYPE
  tokenInAddress: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee',
  tokenOutAddress: '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
};

axios.get('https://api.fibrous.finance/hyperevm/route', { params })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

{
    "success": true,
    "routeSwapType": 0,
    "inputToken": {
        "name": "Wrapped HYPE",
        "address": "0x5555555555555555555555555555555555555555",
        "decimals": 18,
        "price": "55.19"
    },
    "inputAmount": "10000000000000000000",
    "outputToken": {
        "name": "USD₮0",
        "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
        "decimals": 6,
        "price": "1.001"
    },
    "outputAmount": "551482197",
    "time": 0.257,
    "estimatedGasUsed": "50659003741392",
    "estimatedGasUsedInUsd": 0.005660637078063142,
    "route": [
        {
            "percent": "100%",
            "swaps": [
                [
                    {
                        "protocol": 13,
                        "poolName": "hybraFinanceV3",
                        "poolAddress": "0x5a716e045421b0977ca5bfb4f3394139c6a069bc",
                        "fromTokenAddress": "0x5555555555555555555555555555555555555555",
                        "toTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "percent": "100.00%",
                        "extraData": {
                            "fee": 25
                        }
                    }
                ],
                [
                    {
                        "protocol": 18,
                        "poolName": "kittenSwapAlgebraV4",
                        "poolAddress": "0x3cf44ef1500c1d559c8e81dffd6baeb0966b2712",
                        "fromTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "toTokenAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                        "percent": "98.00%",
                        "extraData": null
                    },
                    {
                        "protocol": 15,
                        "poolName": "gLiquidV3",
                        "poolAddress": "0x5e43a757ba769d4cd5fe568ae2429d4ae69e0ecf",
                        "fromTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "toTokenAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                        "percent": "2.00%",
                        "extraData": null
                    }
                ]
            ]
        }
    ],
    "bestQuotesByProtocols": [],
    "initial": false
}

Endpoint

https://api.fibrous.finance/hyperevm/route

Find the optimal trading route through Fibrous’s liquidity pools to maximize output and minimize slippage. This endpoint analyzes multiple protocols, pool depths, and potential paths to deliver the most efficient swap execution for your tokens.

Query Parameters

string

required

The amount of input tokens in wei format. For tokens with 18 decimals, multiply the amount by 10^18.Example: "1000000000000000000" for 1 HYPE

string

required

The address of the input token.Example: "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" for HYPE

string

required

The address of the output token.Example: "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb" for USDC

boolean

If true, the amount parameter represents the desired output amount instead of input amount. Default: false

boolean

If true, only direct swaps between the input and output tokens will be considered. Default: false

array[string]

Array of protocol names to exclude from routing. Default: []

Response

boolean

Indicates if the request was successful.

number

Type of swap route

object

Details about the input token.

Show child attributes

string

The token’s name (e.g., “Wrapped Ether”)

string

The token’s contract address

number

Number of decimals the token uses

number

Current price of the token in USD

object

Details about the output token.

Show child attributes

string

The token’s name (e.g., “USD Coin”)

string

The token’s contract address

number

Number of decimals the token uses

number

Current price of the token in USD

string

The estimated amount of output tokens in wei format.

string

Estimated gas cost for the swap in wei.

number

Estimated gas cost in USD.

array

Array of route segments with detailed swap information.

Show child attributes

string

Percentage of input amount going through this route

array

Array of swap steps in this route segment

Show child attributes

number

Protocol identifier (e.g., 5 for Uniswap V3)

string

Name of the liquidity pool

string

Address of the liquidity pool

string

Percentage of the segment amount through this pool

object

Protocol-specific parameters

curl -L \
  "https://api.fibrous.finance/hyperevm/route?amount=1000000000000000000&tokenInAddress=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&tokenOutAddress=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb" \
  --header "Accept: */*"

import requests

url = "https://api.fibrous.finance/hyperevm/route"

params = {
    "amount": "1000000000000000000",  # 1 HYPE
    "tokenInAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
    "tokenOutAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb"
}

response = requests.get(url, params=params)
print(response.json())

const axios = require('axios');

const params = {
  amount: '1000000000000000000', // 1 HYPE
  tokenInAddress: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee',
  tokenOutAddress: '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
};

axios.get('https://api.fibrous.finance/hyperevm/route', { params })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

{
    "success": true,
    "routeSwapType": 0,
    "inputToken": {
        "name": "Wrapped HYPE",
        "address": "0x5555555555555555555555555555555555555555",
        "decimals": 18,
        "price": "55.19"
    },
    "inputAmount": "10000000000000000000",
    "outputToken": {
        "name": "USD₮0",
        "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
        "decimals": 6,
        "price": "1.001"
    },
    "outputAmount": "551482197",
    "time": 0.257,
    "estimatedGasUsed": "50659003741392",
    "estimatedGasUsedInUsd": 0.005660637078063142,
    "route": [
        {
            "percent": "100%",
            "swaps": [
                [
                    {
                        "protocol": 13,
                        "poolName": "hybraFinanceV3",
                        "poolAddress": "0x5a716e045421b0977ca5bfb4f3394139c6a069bc",
                        "fromTokenAddress": "0x5555555555555555555555555555555555555555",
                        "toTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "percent": "100.00%",
                        "extraData": {
                            "fee": 25
                        }
                    }
                ],
                [
                    {
                        "protocol": 18,
                        "poolName": "kittenSwapAlgebraV4",
                        "poolAddress": "0x3cf44ef1500c1d559c8e81dffd6baeb0966b2712",
                        "fromTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "toTokenAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                        "percent": "98.00%",
                        "extraData": null
                    },
                    {
                        "protocol": 15,
                        "poolName": "gLiquidV3",
                        "poolAddress": "0x5e43a757ba769d4cd5fe568ae2429d4ae69e0ecf",
                        "fromTokenAddress": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                        "toTokenAddress": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                        "percent": "2.00%",
                        "extraData": null
                    }
                ]
            ]
        }
    ],
    "bestQuotesByProtocols": [],
    "initial": false
}

Getting Started

Chains, Tokens, Contracts

Core Endpoints

Core Endpoints V2

Starknet API

Smart Contracts

Endpoint

Query Parameters

Response

​Endpoint

​Query Parameters

​Response

Endpoint

Query Parameters

Response