Skip to main content
GET
/
hyperevm
/
calldata
curl --location 'https://api.fibrous.finance/hyperevm/calldata?amount=100000000000000000&tokenInAddress=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&tokenOutAddress=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb&slippage=0.1&destination=0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca' \
--header 'Origin: application/javascript'
 


{
    "route": {
        "success": true,
        "routeSwapType": 0,
        "inputToken": {
            "name": "Wrapped HYPE",
            "address": "0x5555555555555555555555555555555555555555",
            "decimals": 18,
            "price": "55.18"
        },
        "inputAmount": "10000000000000000000",
        "outputToken": {
            "name": "USD₮0",
            "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
            "decimals": 6,
            "price": "1.001"
        },
        "outputAmount": "551472578",
        "time": 0.261,
        "estimatedGasUsed": "45273855416400",
        "estimatedGasUsedInUsd": 0.005058900604228536,
        "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
    },
    "calldata": {
        "route": {
            "token_in": "0x5555555555555555555555555555555555555555",
            "token_out": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
            "amount_in": "10000000000000000000",
            "amount_out": "551472578",
            "min_received": "550921106",
            "destination": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
            "swap_type": 0
        },
        "swap_parameters": [
            {
                "token_in": "0x5555555555555555555555555555555555555555",
                "token_out": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                "rate": "1000000",
                "protocol_id": "13",
                "pool_address": "0x5a716e045421b0977ca5bfb4f3394139c6a069bc",
                "swap_type": 0,
                "extra_data": "0x0000000000000000000000000000000000000000000000000000000000000019"
            },
            {
                "token_in": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                "token_out": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                "rate": "980000",
                "protocol_id": "18",
                "pool_address": "0x3cf44ef1500c1d559c8e81dffd6baeb0966b2712",
                "swap_type": 2,
                "extra_data": "0x0000000000000000000000000000000000000000000000000000000000000000"
            },
            {
                "token_in": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                "token_out": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                "rate": "20000",
                "protocol_id": "15",
                "pool_address": "0x5e43a757ba769d4cd5fe568ae2429d4ae69e0ecf",
                "swap_type": 2,
                "extra_data": "0x0000000000000000000000000000000000000000000000000000000000000000"
            }
        ]
    }
}

​
Endpoint

https://api.fibrous.finance/hyperevm/calldata
Generate the calldata required to execute a swap through the Fibrous’ router contract. This endpoint provides the raw transaction data that can be used to execute the swap directly through a Web3 provider.

​
Request Body Parameters

​
amount
string
required
The complete response object from the /hyperevm/route endpoint. This contains all the necessary information about the optimal route.
​
tokenInAddress
string
required
The address of the input token.Example: "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" for HYPE
​
tokenOutAddress
string
required
The address of the output token.Example: "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb" for USDC
​
reverse
boolean
If true, the amount parameter represents the desired output amount instead of input amount. Default: false
​
direct
boolean
If true, only direct swaps between the input and output tokens will be considered. Default: false
​
excludeProtocols
array[string]
Array of protocol names to exclude from routing. Default: []
​
slippage
number
required
Maximum acceptable slippage in percentage (0.1 to 49). Example: 0.5 for 0.5% slippage tolerance
​
destination
string
required
The receiver address for the output token.

​
Response

​
route
RouteResponse
The complete response object from the /hyperevm/route endpoint. This contains all the necessary information about the optimal route.
​
calldata
CalldataResponse
The hex-encoded calldata to execute the swap through the router contract.

​
Response Types

export class CalldataResponseDto {
  route: RouteResponse;
  calldata: CalldataResponse;
}

export type RouteResponse =
  | {
      success: false;
      errorMessage: string;
    }
  | {
      success: true;
      inputToken: Token;
      inputAmount: string;
      outputToken: Token;
      outputAmount: string;
      estimatedGasUsed: string;
      estimatedGasUsedInUsd: number;
      route: FormattedRoute[];
      time: number;
      bestQuotesByProtocols: any[];
      initial: boolean;
      routeSwapType: route_swap_type;
};

export type FormattedRoute = {
  percent: Percent;
  swaps: FormattedSwap[][];
};
  
export type FormattedSwap = {
  protocol: Protocol;
  poolName: string;
  poolAddress: string;
  fromTokenAddress: string;
  toTokenAddress: string;
  percent: Percent;
  extraData?: any;
};

​
Error Responses

​
Invalid Route

{
  "success": false,
  "error": "Invalid route",
  "details": "The provided route is invalid or expired"
}

​
Invalid Slippage

{
  "success": false,
  "error": "Invalid slippage",
  "details": "Slippage must be between 0.1 and 49"
}

​
Invalid Signer

{
  "success": false,
  "error": "Invalid signer",
  "details": "The provided signer address is not valid"
}

curl --location 'https://api.fibrous.finance/hyperevm/calldata?amount=100000000000000000&tokenInAddress=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&tokenOutAddress=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb&slippage=0.1&destination=0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca' \
--header 'Origin: application/javascript'
 


{
    "route": {
        "success": true,
        "routeSwapType": 0,
        "inputToken": {
            "name": "Wrapped HYPE",
            "address": "0x5555555555555555555555555555555555555555",
            "decimals": 18,
            "price": "55.18"
        },
        "inputAmount": "10000000000000000000",
        "outputToken": {
            "name": "USD₮0",
            "address": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
            "decimals": 6,
            "price": "1.001"
        },
        "outputAmount": "551472578",
        "time": 0.261,
        "estimatedGasUsed": "45273855416400",
        "estimatedGasUsedInUsd": 0.005058900604228536,
        "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
    },
    "calldata": {
        "route": {
            "token_in": "0x5555555555555555555555555555555555555555",
            "token_out": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
            "amount_in": "10000000000000000000",
            "amount_out": "551472578",
            "min_received": "550921106",
            "destination": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
            "swap_type": 0
        },
        "swap_parameters": [
            {
                "token_in": "0x5555555555555555555555555555555555555555",
                "token_out": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                "rate": "1000000",
                "protocol_id": "13",
                "pool_address": "0x5a716e045421b0977ca5bfb4f3394139c6a069bc",
                "swap_type": 0,
                "extra_data": "0x0000000000000000000000000000000000000000000000000000000000000019"
            },
            {
                "token_in": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                "token_out": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                "rate": "980000",
                "protocol_id": "18",
                "pool_address": "0x3cf44ef1500c1d559c8e81dffd6baeb0966b2712",
                "swap_type": 2,
                "extra_data": "0x0000000000000000000000000000000000000000000000000000000000000000"
            },
            {
                "token_in": "0xfd739d4e423301ce9385c1fb8850539d657c296d",
                "token_out": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
                "rate": "20000",
                "protocol_id": "15",
                "pool_address": "0x5e43a757ba769d4cd5fe568ae2429d4ae69e0ecf",
                "swap_type": 2,
                "extra_data": "0x0000000000000000000000000000000000000000000000000000000000000000"
            }
        ]
    }
}

​
Tips

  1. Always verify the min_received amount matches your expectations
  2. Check that the destination address is correct
  3. Consider gas costs when splitting across multiple protocols
  4. Store the route response before requesting calldata

​
Rate Limits

Please refer to our rate limiting documentation for details about request limits and quotas.