Skip to main content
GET
/
citrea
/
route
curl -L \
  "https://api.fibrous.finance/citrea/route?amount=1000000000000000000&tokenInAddress=0x0000000000000000000000000000000000000000&tokenOutAddress=0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839" \
  --header "Accept: */*"
{
  "success": true,
  "routeSwapType": 2,
  "inputToken": {
    "address": "0x0000000000000000000000000000000000000000",
    "name": "Citrea Bitcoin",
    "symbol": "cBTC",
    "decimals": "18",
    "price": "95000.00",
    "base": true,
    "native": true,
    "image_url": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png",
    "verified": true,
    "category": null,
    "ticker": "cbtc"
  },
  "inputAmount": "1000000000000000000",
  "outputToken": {
    "address": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
    "name": "Bridged USD Coin",
    "symbol": "USDC.e",
    "decimals": 6,
    "base": true,
    "native": false
  },
  "outputAmount": "9500000000",
  "time": 0.372,
  "estimatedGasUsed": "69993657648",
  "estimatedGasUsedInUsd": 0.0012143367650129875,
  "route": [
    {
      "percent": "90%",
      "swaps": [
        [
          {
            "protocol": 1,
            "poolId": "1:0x814a23b053fd0f102aeeda0459215c2444799c70:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "SyncSwap Classic",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "60.00%"
          },
          {
            "protocol": 5,
            "poolId": "5:0x6905c59be1a7ea32d1f257e302401ec9a1401c52:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "SpaceFi",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "6.67%"
          },
          {
            "protocol": 8,
            "poolId": "8:0xe64ae4128e725868e8fe52e771e3d272e787b041:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "Sushi CL",
            "poolAddress": "0xe64ae4128e725868e8fe52e771e3d272e787b041",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "11.11%"
          },
          {
            "protocol": 12,
            "poolId": "12:0x118a84e97620829a6a9666d41acc9e91edf32bd6:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "Zebra CL",
            "poolAddress": "0x118a84e97620829a6a9666d41acc9e91edf32bd6",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "7.78%"
          },
          {
            "protocol": 15,
            "poolId": "15:0xe0da810f07da1eace7f044afd081f8583dbe9cd3:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "Nuri CL",
            "poolAddress": "0xe0da810f07da1eace7f044afd081f8583dbe9cd3",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "14.44%"
          }
        ]
      ]
    }
  ],
  "bestQuotesByProtocols": [
    {"name": "Syncswap", "quote": "4235.89419"},
    {"name": "Skydrome", "quote": "0"},
    {"name": "Zebra V2", "quote": "1183.484632"},
    {"name": "Metavault V2", "quote": "79.29063"},
    {"name": "Space Fi V2", "quote": "3821.560667"},
    {"name": "Sushi V2", "quote": "2402.596173"},
    {"name": "Dodo", "quote": "487.734193"},
    {"name": "Nuri V2", "quote": "102.106455"},
    {"name": "KyberSwap Classic", "quote": "880.711712"},
    {"name": "Tokan V2", "quote": "1354.639786"},
    {"name": "Zada Fi V2", "quote": "2160.433469"},
    {"name": "Sushi CL", "quote": "4000.797454"},
    {"name": "Okutrade", "quote": "3288.843421"},
    {"name": "Izumi", "quote": "3315.196008"},
    {"name": "Metavault CL", "quote": "152.458258"},
    {"name": "Zebra CL", "quote": "3890.335024"},
    {"name": "Keller", "quote": "73.835387"},
    {"name": "Nuri CL", "quote": "4050.439619"}
  ],
  "initial": false
}
https://api.fibrous.finance/citrea/route
Find the optimal trading route through Fibrous’s liquidity pools on Citrea 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

amount
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 cBTC (18 decimals)
tokenInAddress
string
required
The address of the input token.Example: "0x0000000000000000000000000000000000000000" for cBTC on Citrea
tokenOutAddress
string
required
The address of the output token.Example: "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839" for USDC.e on Citrea

Response

success
boolean
Indicates if the request was successful.
routeSwapType
number
Type of swap route (e.g., 2 for split routes).
inputToken
object
Details about the input token.
outputToken
object
Details about the output token.
curl -L \
  "https://api.fibrous.finance/citrea/route?amount=1000000000000000000&tokenInAddress=0x0000000000000000000000000000000000000000&tokenOutAddress=0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839" \
  --header "Accept: */*"
{
  "success": true,
  "routeSwapType": 2,
  "inputToken": {
    "address": "0x0000000000000000000000000000000000000000",
    "name": "Citrea Bitcoin",
    "symbol": "cBTC",
    "decimals": "18",
    "price": "95000.00",
    "base": true,
    "native": true,
    "image_url": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png",
    "verified": true,
    "category": null,
    "ticker": "cbtc"
  },
  "inputAmount": "1000000000000000000",
  "outputToken": {
    "address": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
    "name": "Bridged USD Coin",
    "symbol": "USDC.e",
    "decimals": 6,
    "base": true,
    "native": false
  },
  "outputAmount": "9500000000",
  "time": 0.372,
  "estimatedGasUsed": "69993657648",
  "estimatedGasUsedInUsd": 0.0012143367650129875,
  "route": [
    {
      "percent": "90%",
      "swaps": [
        [
          {
            "protocol": 1,
            "poolId": "1:0x814a23b053fd0f102aeeda0459215c2444799c70:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "SyncSwap Classic",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "60.00%"
          },
          {
            "protocol": 5,
            "poolId": "5:0x6905c59be1a7ea32d1f257e302401ec9a1401c52:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "SpaceFi",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "6.67%"
          },
          {
            "protocol": 8,
            "poolId": "8:0xe64ae4128e725868e8fe52e771e3d272e787b041:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "Sushi CL",
            "poolAddress": "0xe64ae4128e725868e8fe52e771e3d272e787b041",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "11.11%"
          },
          {
            "protocol": 12,
            "poolId": "12:0x118a84e97620829a6a9666d41acc9e91edf32bd6:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "Zebra CL",
            "poolAddress": "0x118a84e97620829a6a9666d41acc9e91edf32bd6",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "7.78%"
          },
          {
            "protocol": 15,
            "poolId": "15:0xe0da810f07da1eace7f044afd081f8583dbe9cd3:0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839:0x0000000000000000000000000000000000000000",
            "poolName": "Nuri CL",
            "poolAddress": "0xe0da810f07da1eace7f044afd081f8583dbe9cd3",
            "fromTokenAddress": "0x0000000000000000000000000000000000000000",
            "toTokenAddress": "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
            "percent": "14.44%"
          }
        ]
      ]
    }
  ],
  "bestQuotesByProtocols": [
    {"name": "Syncswap", "quote": "4235.89419"},
    {"name": "Skydrome", "quote": "0"},
    {"name": "Zebra V2", "quote": "1183.484632"},
    {"name": "Metavault V2", "quote": "79.29063"},
    {"name": "Space Fi V2", "quote": "3821.560667"},
    {"name": "Sushi V2", "quote": "2402.596173"},
    {"name": "Dodo", "quote": "487.734193"},
    {"name": "Nuri V2", "quote": "102.106455"},
    {"name": "KyberSwap Classic", "quote": "880.711712"},
    {"name": "Tokan V2", "quote": "1354.639786"},
    {"name": "Zada Fi V2", "quote": "2160.433469"},
    {"name": "Sushi CL", "quote": "4000.797454"},
    {"name": "Okutrade", "quote": "3288.843421"},
    {"name": "Izumi", "quote": "3315.196008"},
    {"name": "Metavault CL", "quote": "152.458258"},
    {"name": "Zebra CL", "quote": "3890.335024"},
    {"name": "Keller", "quote": "73.835387"},
    {"name": "Nuri CL", "quote": "4050.439619"}
  ],
  "initial": false
}