Skip to main content
GET
/
{network}
/
route
curl "https://api.fibrous.finance/{network}/route?amount=1000000000000000000&tokenInAddress=0x0000000000000000000000000000000000000000&tokenOutAddress=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&slippage=0.5"

{
  "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
}

​
Overview

V2 Available: An enhanced version of this endpoint is available at /{network}/v2/route with integrator support, metadata, and API key features. See Get Route V2 and the V2 Migration Guide.
Route endpoint finds the optimal trading path through Fibrous’ integrated liquidity sources to maximize output and minimize slippage. This endpoint is available across all supported networks.

​
Supported Networks

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.
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
​
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
​
initial
boolean
Indicates if this is an initial route calculation

​
Example Request

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

{
  "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

  • Native token: ETH
  • Common tokens: USDC, USDbC, WETH, DAI
  • Average block time: ~2 seconds
  • Native token: HYPE
  • Common tokens: USDC, WHYPE
  • Average block time: ~2 seconds
  • Native token: cBTC
  • Common tokens: wcBTC, USDC.e
  • Average block time: TBD
  • Bitcoin’s first ZK rollup with EVM compatibility