Get Route

Find the optimal trading route across supported networks

Overview

The Route endpoint finds the optimal trading path through Fibrous Finance’s liquidity pools to maximize output and minimize slippage. This endpoint is available across all supported networks.

Supported Networks

Base

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

Request Parameters

amount · string · required

The amount of input tokens in wei format (for EVM chains) or the smallest unit for the token.

Example: "1000000000000000000" for 1 token with 18 decimals

tokenInAddress · string · required

The contract address of the input token.

Base/HyperEVM/Scroll/Monad

Use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE or 0x0000000000000000000000000000000000000000 for native tokens

tokenOutAddress · string · required

The contract address of the output token.

slippage · number · default: "0.5"

Maximum acceptable slippage in percentage (0.1 to 100).

Example: 0.5 for 0.5% slippage tolerance

destination · string

The destination address to receive the output tokens. If not provided, defaults to the sender address.

excludeProtocols · string[]

Array of protocol IDs to exclude from routing.

direct · boolean · default: "false"

If true, only direct swaps will be considered (no multi-hop routes).

Response

success · boolean

Indicates if the route was successfully found

routeSwapType · number

Type of swap route (0 = standard)

inputToken · object

Information about the input token

Show child attributes

name · string

Token name

address · string

Token contract address

decimals · number

Token decimals

price · number

Current token price in USD

outputToken · object

Information about the output token (same structure as inputToken)

inputAmount · string

The amount of input tokens in wei format

outputAmount · string

The expected amount of output tokens in wei format

time · number

Time taken to calculate the route (in seconds)

estimatedGasUsed · string

Estimated gas units for the transaction

estimatedGasUsedInUsd · number

Estimated gas cost in USD

route · object[]

Array of route segments showing how the swap is split

Show child attributes

percent · string

Percentage of input amount routed through this segment

swaps · array

Array of swap hops for this route segment

Show child attributes

protocol · number

Protocol ID

poolName · string

DEX protocol name

poolAddress · string

Liquidity pool address

fromTokenAddress · string

Input token address for this hop

toTokenAddress · string

Output token address for this hop

percent · string

Percentage split for this specific swap

extraData · object

Protocol-specific data (e.g., fee tier, tick spacing)

initial · boolean

Indicates if this is an initial route calculation

Example Request

cURL

curl "https://api.fibrous.finance/base/route?amount=1000000000000000000&tokenInAddress=0x0000000000000000000000000000000000000000&tokenOutAddress=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&slippage=0.5"

Example Response

{
  "success": true,
  "routeSwapType": 0,
  "inputToken": {
    "name": "Wrapped Ether",
    "address": "0x4200000000000000000000000000000000000006",
    "decimals": 18,
    "price": 3171.37
  },
  "inputAmount": "1000000000000000000",
  "outputToken": {
    "name": "USD Coin",
    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "decimals": 6,
    "price": 0.99971
  },
  "outputAmount": "3165007379",
  "time": 0.495,
  "estimatedGasUsed": "0",
  "estimatedGasUsedInUsd": 0,
  "route": [
    {
      "percent": "51%",
      "swaps": [
        [
          {
            "protocol": 9,
            "poolName": "PancakeSwap V3",
            "poolAddress": "0x72ab388e2e2f6facef59e3c3fa2c4e29011c2d38",
            "fromTokenAddress": "0x4200000000000000000000000000000000000006",
            "toTokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "percent": "100.00%",
            "extraData": {
              "fee": 100
            }
          }
        ]
      ]
    },
    {
      "percent": "49%",
      "swaps": [
        [
          {
            "protocol": 9,
            "poolName": "PancakeSwap V3",
            "poolAddress": "0xc211e1f853a898bd1302385ccde55f33a8c4b3f3",
            "fromTokenAddress": "0x4200000000000000000000000000000000000006",
            "toTokenAddress": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
            "percent": "100.00%",
            "extraData": {
              "fee": 100
            }
          }
        ],
        [
          {
            "protocol": 3,
            "poolName": "Aerodrome Slipstream",
            "poolAddress": "0x4e962bb3889bf030368f56810a9c96b83cb3e778",
            "fromTokenAddress": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
            "toTokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "percent": "61.00%",
            "extraData": {
              "tickSpacing": 100
            }
          },
          {
            "protocol": 3,
            "poolName": "Aerodrome Slipstream",
            "poolAddress": "0x3e66e55e97ce60096f74b7c475e8249f2d31a9fb",
            "fromTokenAddress": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
            "toTokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "percent": "39.00%",
            "extraData": {
              "tickSpacing": 2000
            }
          }
        ]
      ]
    }
  ],
  "initial": false
}

Best Practices

1. Fresh Routes

   • Always fetch a new route before executing a swap
   • Routes can become stale due to market movements
   • Typical validity: 30-60 seconds depending on market volatility

2. Slippage Settings

   • Stable pairs: 0.1% - 0.5%
   • Volatile pairs: 1% - 3%
   • Low liquidity tokens: 3% - 5%

3. Gas Optimization

   • Use direct: true for major token pairs
   • Consider gas costs vs. price improvement for small amounts
   • Exclude high-gas protocols when optimizing for speed

4. Error Handling

   • Implement retry logic with exponential backoff
   • Check for insufficient liquidity errors
   • Validate token addresses before calling

Network-Specific Notes

Base Network

• Native token: ETH
• Common tokens: USDC, USDbC, WETH, DAI
• Average block time: ~2 seconds

HyperEVM

• Native token: HYPE
• Common tokens: USDC, WHYPE
• Average block time: ~2 seconds

Scroll

• Native token: ETH
• Common tokens: USDC, WETH
• Average block time: ~3 seconds

Starknet

• Native token: ETH
• Common tokens: USDC, STRK
• Uses Cairo VM (different address format)
• See Starknet-specific documentation

Related Endpoints

• Execute - Execute the swap using the route
• Calldata - Get transaction calldata
• Health Check - Check API status