​
HyperEVM API Overview

Welcome to the HyperEVM API documentation. Our API provides powerful endpoints for finding optimal trading routes and executing swaps on HyperEVM network. API accept HYPE addresses are listed below.
TokenAddress
HYPE0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
HYPE0x0000000000000000000000000000000000000000

​
HyperEVM URL

https://api.fibrous.finance/hyperevm

​
Common Concepts

​
Authentication

No authentication is required for the API endpoints.

​
Rate Limiting

Please refer to our Rate Limit documentation for details about rate limiting.

​
Common Token Addresses

Here are some commonly used token addresses on HyperEVM:
TokenAddressDecimals
HYPE0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE18
USDC0xb88339cb7199b77e23db6e890353e22632ba630f6
WHYPE0x555555555555555555555555555555555555555518

​
Response Codes

CodeDescription
200Success - The request was successful
400Bad Request - Check your request parameters
429Too Many Requests - You’ve hit the rate limit
500Internal Server Error - Something went wrong on our end

​
Available Endpoints

​
Route

Find the optimal trading route through Fibrous Finance’s liquidity pools to maximize output and minimize slippage.

​
Execute

Generate calldata for the Fibrous Finance router contract to execute the swap.

​
Calldata

Combined Route enpoint and Execute endpoint. Get the calldata and route for executing the swap transaction.

​
Best Practices

​
Slippage Protection

  • Always set a reasonable slippage value (0.1% - 1% for stable pairs)
  • Use higher slippage for volatile pairs or low liquidity tokens
  • Monitor price impact to ensure favorable trades

​
Gas Optimization

  • Use the direct parameter for simple swaps between major tokens
  • Set excludeProtocols to skip specific protocols if needed
  • Consider batch swaps for multiple transactions

​
Error Handling

  • Always check the success field in responses
  • Implement proper error handling in your code
  • Monitor transaction status after execution

​
Quick Start Example

Here’s a complete example of how to perform a swap using our API:
  1. First, get the optimal route:
curl -X GET "https://api.fibrous.finance/hyperevm/route" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1000000000000000000",  # 1 WHYPE
    "tokenInAddress": "0x5555555555555555555555555555555555555555",
    "tokenOutAddress": "0xb88339cb7199b77e23db6e890353e22632ba630f"
  }'
  1. Then, get the execution calldata:
curl -X GET "https://api.fibrous.finance/hyperevm/execute" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1000000000000000000",
    "tokenInAddress": "0x5555555555555555555555555555555555555555",
    "tokenOutAddress": "0xb88339cb7199b77e23db6e890353e22632ba630f",
    "slippage": 0.5,
    "destination": "YOUR_ADDRESS"
  }'
  1. Finally, execute the transaction using the returned calldata with your preferred Web3 library.

​
Need Help?