Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Welcome to the WheelX.fi GitBook manual for the multichain Bridge&Swap AI-powered Aggregator. This document serves as your comprehensive guide to understanding the WheelX's capabilities, features, and integrations. Whether you're a developer, trader, or simply exploring DeFi, you'll find detailed instructions on using the platform to its fullest.
Cross-Chain Functionality: Support for seamless token transactions across different blockchains.
AI-Powered Aggregation: AI algorithms optimize transaction routes for the most efficient trade execution.
Multi-Asset Management: Integrate and manage assets across more than 60+ chains and tokens.
Secure and Private: Non-custodial wallet support and robust security mechanisms such as MEV protection and dynamic risk control.
Aggregation of DEX and Bridges:
The system aggregates over 100+ cross-chain bridges and 100+ DEXs. This means users can execute trades and transfers across multiple liquidity pools, ensuring they always find the best route for their transactions.
AI Routing: AI-powered algorithms analyze live data from DEXs and bridges to find the optimal route for each trade. The system accounts for factors such as slippage, fees, and trade execution time.
Integration of Over 60+ Chains:
The platform supports both EVM (Ethereum Virtual Machine) and non-EVM blockchains. This broad chain support enables users to perform transactions across multiple ecosystems without having to worry about compatibility issues.
Security Features:
No Capital Commitment: Users can engage with liquidity pools or DEXs without needing to lock in substantial funds. This ensures greater flexibility and security in managing their assets.
MEV Protection: The platform includes protections against Miner Extractable Value (MEV) attacks, which could otherwise result in the manipulation of trade execution and prices.
Commission and Reward Systems:
To C and To B Commission Systems: The platform has built-in reward systems for both consumers (retail traders) and businesses (institutions or platforms that use the service to enable cross-chain transactions). These systems allow users to receive commissions from successful trades or integrations.
Points and Rewards: Users earn points for engaging with the platform, which can later be exchanged for benefits like reduced fees, access to exclusive features, or trading boosts.
Task Platform: The platform offers a task management system for users. Tasks could involve completing certain trading actions or engaging in specific platform-related activities. Completing these tasks helps users accumulate points or earn rewards.
The Need for a Multichain Ecosystem
In the rapidly growing DeFi landscape, users often find themselves dealing with fragmented ecosystems where assets and liquidity are isolated on individual blockchains. WheelX addresses this challenge by serving as a powerful multichain bridge, enabling seamless token transfers across Layer 1 and Layer 2 networks. By connecting previously siloed ecosystems, WheelX allows users to access broader liquidity and a wider range of assets—unlocking the full potential of decentralized finance.
AI-Powered Aggregation
WheelX’s AI-powered aggregator intelligently optimizes transactions by analyzing thousands of possible routes across DEXs and cross-chain bridges. It dynamically selects the most cost-effective and time-efficient path for each asset transfer, ensuring users benefit from lower slippage, reduced transaction fees, and faster execution. This smart routing engine is a key differentiator that makes WheelX not only powerful but also user intent-centric.
Platform Goals
WheelX is built with a mission to democratize access to decentralized liquidity, streamline the complexity of cross-chain operations, and empower users with greater flexibility. Whether you're a DeFi trader, developer, or everyday user, WheelX simplifies multichain navigation—making interoperability effortless and efficient across the entire Web3 ecosystem.
Token Swapping:
Single-Chain Swaps: Token swapping within the same blockchain allows users to exchange one token for another (e.g., swapping Ethereum for USDT within the Ethereum ecosystem).
Cross-Chain Swaps: Token swaps that involve two different blockchains (e.g., swapping Ethereum for Solana tokens) can be done in a few simple steps thanks to the platform’s cross-chain functionality.
Limit Orders for Swapping:
Just like centralized exchanges, users can set a limited price for their swaps. This ensures that a trade only occurs when a specified price is met.
The smart contracts that power the platform are designed for efficiency and security, facilitating seamless cross-chain transactions and token swaps.
What is Aggregating?:
Aggregation refers to the process of pulling liquidity from multiple DEXs and cross-chain bridges into one seamless trading interface. It ensures users always get the best deal possible, whether trading tokens within a single chain or across multiple chains.
Benefits:
AI Optimized Routes: AI routes transactions through the most efficient path, minimizing slippage and reducing trading costs.
Cost Savings: By aggregating liquidity and optimizing transaction routes, users save on both transaction fees and time.
Core Features:
Cross-Chain Transactions: The platform facilitates transfers of a single token across two different blockchains. This is done by bridging the token using the Multichain Bridge and maintaining liquidity across chains.
Swap Transactions: Swapping refers to exchanging one token for another within the same blockchain ecosystem. For example, swapping Ethereum for USDT within the Ethereum network.
Cross-Chain + Swap: This feature allows the user to swap tokens across different blockchains. For example, swapping Ethereum for Solana-based tokens without the need for manual bridging.
Limit Orders: Users can set specific parameters for trades to be executed only when certain price and time conditions are met, similar to a traditional centralized exchange’s limit order functionality.
Protocol Security:
The Multichain Bridge ensures that transactions are secure through the use of non-custodial wallets, meaning the platform never holds users' assets.
Dynamic Risk Control: Automatic adjustments to collateral requirements and interest rates based on market conditions. This helps manage risk more efficiently and reduces the need for oracle-based solutions.
How Bridging Works:
Cross-Chain Communication: Bridging allows for the seamless transfer of tokens between different blockchains. This is achieved through the use of an intelligent routing system that selects the most cost-effective and efficient path between chains.
Key Protocols Used:
The platform utilizes industry-standard protocols such as UNI V4 and others for liquidity and transaction management.
Security and Privacy:
The platform is designed with a no capital commitment policy, reducing risk for users.
Non-Custodial Wallet Support:
Users maintain full control over their private keys and assets, enhancing security and privacy.
Supported Blockchains:
The platform supports over 60+ chains, including both EVM and non-EVM blockchains, such as Ethereum, Base, Arbitrum, Optimism, Unichain, Linea, Binance Smart Chain, Solana, Cosmos, and more.
Integration with major and emerging blockchain ecosystems ensures that users have access to a broad range of tokens and liquidity pools.
The Maker addresses for various platforms, chains, and products are listed for transparency.
What are the supported blockchains?
How do I perform a cross-chain swap?
How are fees calculated?
Are my data and assets secure on the platform?
WheelX Native Token Receiver
Smart contract
0xB10F9Ec04A66b69E3831e1e5b1E6B9D41081B6CC
Maker
EOA Address
0x4fd0FC39eb0d56FE8250496DbFC81c39B1021ac6
ERC20 Approval Proxy
Smart contract
0x7eC9672678509a574F6305F112a7E3703845a98b
Dex Router
Smart contract
0x6222f99443A0d75bd96d40F2904606f60f37cdc2
Ethereum
ETH
Base
ETH
Arbitrum
ETH
Optimism
ETH
BNBChain
BNB
opBNB
BNB
Linea
The /v1/quote endpoint provides token swap and bridge quotes with detailed transaction information for EVM-compatible chains. It returns both pricing information and the complete transaction data needed to execute the swap.
Developers can use the Python SDK to build decentralized applications (dApps) that interact with the Multichain Bridge + DEX AI Aggregator platform.
ETH
Unichain
ETH
Sonic
S
BeraChian
Bera
Soneium
ETH
Polygon
POL
ink
ETH
Mantle
MNT
Gravity
G
Scroll
ETH
zkSync Era
ETH
Taiko
ETH
BOB
ETH
Blast
ETH
Mode
ETH
X Layer
OKB
WorldChain
ETH
Morph
ETH
Hemi
ETH
Celo
CELO
Avalanche
AVAX
Gnosis
GNO
Abstract
ETH
POST https://wheelx.fi/v1/quoteinterface QuoteRequest {
from_chain: number; // Source chain ID (e.g., 1 for Ethereum)
to_chain: number; // Destination chain ID
from_token: string; // Source token address
to_token: string; // Destination token address
from_address: string; // User's wallet address (source)
to_address: string; // Recipient address (destination)
amount: number; // Amount to swap (in smallest units)
slippage?: number; // Optional slippage tolerance (default: auto)
}{
"from_chain": 1,
"to_chain": 1,
"from_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"to_token": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"from_address": "0x742d35Cc6634C0532925a3b8Dc9F6A7c5D3a7C6a",
"to_address": "0x742d35Cc6634C0532925a3b8Dc9F6A7c5D3a7C6a",
"amount": 1000000,
"slippage": 50,
}interface QuoteResponse {
request_id: string; // Unique identifier for this quote
amount_out: string; // Expected output amount
fee: string; // Total fee amount
tx: Tx; // Transaction data for execution
approve?: ApproveAction; // Optional approval transaction data
slippage: number; // Applied slippage percentage
min_receive: string; // Minimum amount to receive after slippage
estimated_time: number; // Estimated completion time in seconds
recipient: string; // Recipient address
router_type: RouterType; // Type of operation (swap/bridge/wrap/unwrap)
price_impact: PriceImpactFormatted; // Detailed fee breakdown
router: string; // Router identifier
created_at: string; // Quote creation timestamp
points: string; // Points earned for this transaction
}
interface Tx {
to: string; // Contract address to interact with
value: number; // ETH value to send (for native token swaps)
data: string; // Transaction calldata
chainId?: number; // Chain ID
gas?: number; // Estimated gas limit
maxFeePerGas?: number; // Max fee per gas (EIP-1559)
maxPriorityFeePerGas?: number; // Max priority fee per gas (EIP-1559)
}
interface ApproveAction {
token: string; // Token address to approve
spender: string; // Spender contract address
amount: number; // Amount to approve
}
interface PriceImpactFormatted {
bridge_fee: string; // Bridge fee amount
swap_fee: string; // Swap fee amount
dst_gas_fee: string; // Destination gas fee
}
type RouterType = "swap" | "bridge" | "wrap" | "unwrap";{
"request_id": "quote_123456789",
"amount_out": "999500",
"fee": "500",
"tx": {
"to": "0x1234567890123456789012345678901234567890",
"value": 0,
"data": "0x1234567890abcdef...",
"chainId": 1,
"gas": 210000,
"maxFeePerGas": 30000000000,
"maxPriorityFeePerGas": 2000000000
},
"approve": {
"token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"spender": "0x1234567890123456789012345678901234567890",
"amount": 1000000
},
"slippage": 50,
"min_receive": "999000",
"estimated_time": 10,
"recipient": "0x742d35Cc6634C0532925a3b8Dc9F6A7c5D3a7C6a",
"router_type": "swap",
"price_impact": {
"bridge_fee": "0",
"swap_fee": "500",
"dst_gas_fee": "0"
},
"router": "wheelx",
"created_at": "2024-01-01T12:00:00Z",
"points": "10"
}WheelX is a community-driven Bridge & Swap DeFi platform, and we aim to build a closer connection with social platforms. As the most active social media platform in Web3, X — along with its Blue verified users — serves as the perfect bridge for this connection.
In mid-September 2025, we launched a call for X Blue verified users, which received an enthusiastic response. Based on the valuable feedback and suggestions we received, we’ve now officially upgraded it to the WheelX Influencer Program.
As long as you’re an X Blue verified user, you can become a WheelX Influencer — no matter how many followers you have.
🏆 1. Special Privileges in the Community Dividend Program
You’ll enjoy higher rewards and commissions as part of the .
1.3× XP Booster: Instantly receive a 1.3× XP multiplier for trading and smart contract deployments (normally, boosters must be unlocked gradually).
Referral Rewards: Your referees will receive 2,000 XP (worth $2) as a newcomer bonus — that’s 100% more than usual! You’ll earn XP 1:1 with your referees’ trading and deployment activities. (e.g., if your referee earns 100 XP, you’ll also receive 100 XP.)
👉 Check details here:
💎 2. Exclusive Status
Receive the Influencer role in the WheelX Discord server →
Get an exclusive blue verification icon on the WheelX platform to showcase your distinguished status →
🌐 3. Exclusive Community Privileges
Be invited to the X private community exclusively for X Blue verified users.
Gain access to the Influencer-only channel on WheelX Discord for special updates and events.
⚙️ 4. Platform Perks
Early access to new features.
Exclusive raffle opportunities.
Priority access to official merchandise and gifts.
Step 1: As an X Blue verified user, comment your address under the or DM your address to . (Your address is essential for verification and helps us confirm your X Blue status.)
Step 2: We’ll add your address to the WheelX Influencer Address List and grant you the Influencer role on our .
Step 3: Once both steps are completed, we’ll DM you on X to confirm your status and invite you to the Influencer community.
Step 4: You can verify your status and privileges at and claim your Influencer role at .
Actively promote and introduce WheelX to your followers — don’t forget to use the hashtag #WheelXInfluencer and include your referral link!
Participate in WheelX events and campaigns.
Grow your XP on — XP serves as a key metric for measuring your impact and performance.
Every month, we’ll announce the Top 10 Influencers by new XP in our X community and Discord Influencer channel.
🏅 Top 10 Influencers will receive:
Extra XP bonuses (which increase your dividends and commissions).
Greater exposure — your posts will be amplified by the official WheelX account.
Exclusive opportunities to join AMAs as featured guests.
WheelX is an AI-powered bridge & swap aggregator that helps and serves users in exploring DeFi with lower fees, faster speed, and stronger security — ultimately delivering and creating value for users.
At the same time, WheelX is also a community-driven collective that represents connection, hope, and happiness. The growth of WheelX cannot happen without every member of the community, which is why we believe that each community member is an essential shareholder of WheelX. Every user who trades or engages on WheelX can earn XP, which represents the ‘options’ of being a shareholder. With these ‘options,’ once certain thresholds are met, users can redeem them for ‘dividends’ from the platform’s revenue. Additionally, every community member can invite others to join WheelX and earn generous referral rewards. The better WheelX grows, the more every community member — as a shareholder — will share in its abundant rewards.
Referral rewards and XP booster do not apply to social tasks or newcomer bouns. This means referrers will not receive the same XP rewards for social tasks and newcomer tasks fom referees. At the same time, XP from social tasks and newcomer bonus will only be granted at the base 1× rate.
As you earn more XP(options), accumulating into certain ranges, you will receive different booster levels. The more XP (options) you accumulate, the higher your XP booster becomes. For example, if your booster is 1x, a transaction earns 100 XP. If your booster is 1.2x, the same transaction will earn 120 XP. The specific levels are as follows:
Special users get a unique icon on the dividends page to show off their status.
If a user has multiple roles, the highest booster applies by default.
To level up to the next booster, special users need to meet the cumulative XP thresholds.
The redeemed dividends will be paid in USDT on the Base network.
Please note that this rate is not fixed. Since part of the XP calculation is based on ETH as the settlement token, fluctuations in the ETH price will affect the rate. Additionally, the rate will also be linked to WheelX’s business development, particularly its revenue. WheelX reserves the final right of interpretation for the dividend mechanism.
Users need to meet specific thresholds to redeem or withdraw dividends. A daily withdrawal limit is also enforced for risk management.
Will my XP be consumed after redeeming dividends or making a withdrawal?
Yes, it will. We have designed XP as redeemable XP and redeemed XP. The XP spent will be recorded as redeemed XP. However, your total accumulated XP remains permanently valid.
Does XP have any value besides redeeming dividends?
WheelX places great importance on the community. Although XP is somewhat similar to points in other projects, we provide real value by quickly converting it into dividends. In addition, XP will have more uses in the future, potentially including lotteries, gift redemptions, and more. Most importantly, we track each user’s total accumulated XP. Even if XP is spent through dividends, redemption, or other means, the total XP remains permanently valid. Total XP serves as a very important credential for every user.
I saw in the promotion that users can earn up to 30% cashback and commission. How is this calculated?
Based on the current rate, when a user’s booster is 1X, they can earn 10% cashback. If the user also invites other users who remain active, they can earn at least an additional 10% cashback plus commission. Since each user can have a maximum XP booster of 1.5X, the maximum a user can earn is 15% + 15% cashback and commission, totaling 30% in dividends.
Are there any benefits to being a referee?
Yes. If you join WheelX directly and connect your wallet, you will receive a 1,000 XP newcomer bonus. But if you join WheelX via someone else’s invitation, the newcomer bonus will be 1,500 XP — that’s 50% more. If you join via an influencer’s invitation, the newcomer bonus will be 2,000 XP — 100% more. In addition, every trade you make and every smart contract you deploy will earn you a certain amount of XP. Once your XP accumulates to a certain threshold, it can be redeemed for cashback.
I became a WheelX user without using an invitation link. Can I still be invited later?
Yes. As long as you haven’t been invited before, you can become a referee at any time.
I invited friend A. Can A invite me back?
If your address hasn’t been used as someone else’s referee, it’s possible. However, if you’ve already been successfully invited by another user, your friend A cannot invite you again. Generally, two “clean” addresses that haven’t been linked can invite each other.
Join the Discord server
20 XP, limited to once
Newcomer Bonus
First time connecting a wallet
(not via an referral link)
Automatically receive 1,000 XP
First time connecting a wallet
(via an refferal link)
Automatically receive 1,500 XP
First time connecting a wallet
(via an Alpha refferal link)
Automatically receive 1,800 XP
First time connecting a wallet
(via an Influencer referral link)
Automatically receive 2,000 XP
Source
Details
XP
Bridge & Swap
Successfully complete a bridge or swap
Each transaction will earn a certain amount of XP
Deploy
Successfully deploy a contract on the mainnet
50 XP per deployment (no XP on testnet)
GM
Successfully complete a check in with onchain GM
Fixed 3 XP per GM
Referral
Successfully invite and the referee completes a transaction
The referee earns XP through Swap, Bridge, or Deploy. The referrer receives the same amount of XP at a 1:1 ratio.
Total XP
Booster
0 - 1500 XP
1x
1501-3000 XP
1.1x
3001 - 10000 XP
1.2x
10001 - 20000 XP
1.3x
20001-100000 XP
1.4x
100000+ XP
1.5x
Special Users
Details
Starting Booster
WheelX Alpha
Participated in the WheelX Alpha Galxe Campaign and are OAT holders: https://app.galxe.com/quest/WheelX.fi/GCHt1t65Hr
1.2X
Influencer
X Blue Verified Accounts.
How to verify your identity and address? Simply DM your address to @WheelX_fi on X.
1.3X
Redemption/Withdrawal Limit
Detail
$5
Users can only start redeeming or withdrawing once their accumulated XP reaches the equivalent of $5. Users may also choose to accumulate more than $5 before redeeming or withdrawing.
$1000
Each user can redeem or withdraw up to $1,000 per day. This limit may be adjusted in the future based on risk control considerations.
Social Task
Developers can use the JavaScript SDK to build decentralized applications (dApps) that interact with the Multichain Bridge + DEX AI Aggregator platform.
https://github.com/wheelx-fi/wheelx-sdk/tree/main/typescript
Developers can integrate the platform’s functionalities into their own projects through SDKs, APIs, and Widgets. The integration process is simplified with the help of code samples and clear documentation.