What is SwapWizard
SwapWizard is a DeFi execution layer deployed on the major EVM networks that brings together two on-chain operations in a single product: token swaps and adding or removing liquidity in concentrated positions.
SwapWizard does not custody funds, does not act as a counterparty in transactions, and does not control their execution. The user interacts directly, from their own wallet, with SwapWizard's smart contracts and the DeFi protocols they integrate with.
Swaps
When the user requests an exchange between two tokens, SwapWizard's contracts query the available routes on the supported DEXes of the active network and build the transaction that returns the most tokens to the user. If the amount is large enough that concentrating it in a single pool would generate price impact against the user, the contracts distribute the operation across multiple pools within the same transaction.
The user defines execution parameters from the transaction settings: maximum slippage (with presets of 0.1%, 0.5%, 1%, or a custom value) and a time limit in minutes. These are the standard controls of any DeFi execution.
The smart contracts apply a fee of 0.10% (10 basis points) on the output token of each swap operation. This fee is parameterized on-chain — anyone can read it directly from the contract — and is the only retention on the token flow. There are no spreads applied by the contracts, no variable fees, and no cost for using the interface.
The final prices of each operation emerge from the conditions of the DEX pools at the exact moment of on-chain execution. SwapWizard does not set prices, does not create its own liquidity pools, and does not act as a counterparty.
Supported DEXes: Uniswap, PancakeSwap, SushiSwap, THENA, Aerodrome, Balancer, Curve, Fluid, among others.
Adding and removing liquidity
Participating as a liquidity provider on concentrated liquidity DEXes traditionally requires managing two tokens in exact proportions for a specific price range. Users attempting this face three chained frictions: calculating the amount of each token the position needs in the current pool state, making manual swaps to achieve that proportion, and at the end of the process finding small leftovers ("dust") remaining in the wallet with no clear use.
SwapWizard's smart contracts address all three in a single atomic transaction signed by the user:
Add liquidity from a single token
The user chooses the pair, decides whether to contribute to the full range (simple participation, no active management, comparable to the classic model) or customize the price range (to optimize capital in concentrated ranges), and contributes any token. The contracts calculate at that very moment the exact proportion required by the range on the live pool, execute the necessary swaps, create the position, and return any surplus to the user's wallet converted to the network's native token.
Remove liquidity to a single token
The user selects the position and the token they want to exit to. The contracts collect accumulated fees, close the position, and deliver the full result in the chosen token. No two tokens, no residual dust, no additional steps.
Multi-token (advanced)
For cases where the user wants to use multiple different tokens as input or output, SwapWizard also supports adding liquidity from multiple tokens (including combinations of native token with ERC-20) and removing liquidity to multiple tokens in a single transaction. The flow is the same: the contracts coordinate the necessary swaps and return any surplus.
Cost
The contracts managing liquidity operations do not apply any retention of their own on the user's funds. The only on-chain retention is the 0.10% fee described in the swaps section, applied by SwapWizardCore when the liquidity operation requires internal swaps to adjust proportions. Network gas charged by the underlying blockchain is added on top.
Protocol Fee
SwapWizard smart contracts charge a flat 0.10% (10 basis points) fee on the output token of each swap. This fee is applied on-chain by the SwapWizardCore smart contract and is fully transparent and verifiable.
There are no hidden fees, no spreads, no interface charges, and no fees on liquidity operations themselves — only the internal swaps needed to balance token proportions.
My positions
From the Pools section, the user can view all their active liquidity positions across supported protocols in aggregate, with up-to-date information on the range, pending fees, and the status of each position. A unified view that replaces the usual exercise of jumping between different frontends and fragmented dashboards.
Indexed Pools
SwapWizard's system continuously indexes available liquidity pools across supported chains and protocols, keeping information up to date on existing options at all times. The indexing considers public on-chain parameters such as liquidity depth, recent on-chain volume, and the pool's fee structure.
Any pool on any supported protocol can appear in the index; the indexing process is automatic and based on verifiable on-chain data. If a pool's chain or protocol is not yet integrated and you'd like to propose it, you can do so through our support channel.
Security
SwapWizard's smart contracts are execution routers with no fund storage. Tokens enter from the user's wallet, are routed through the DEX pools the contracts interact with, and return to the user's wallet in the same atomic transaction. Between transactions, there are no user funds inside any SwapWizard contract. This property is categorical and can be verified directly on each network's block explorers.
A practical consequence: there is no treasury that an exploit of SwapWizard's contracts could drain. No accumulated balances, no deposits. If any step of an operation fails, the entire transaction reverts and the funds remain intact in the user's wallet.
The system — SwapWizardCore and SwapWizardLiquidityRouter — has been thoroughly reviewed by DeFiRe Labs, including static analysis with Slither v0.11.5, and has an automated test suite for each router and each adapter. The analysis identified no vulnerabilities with risk of fund loss. The findings recorded in the report are limitations inherent to the external protocols SwapWizard interacts with. The audit report is available on each network's block explorer, accessible from the verified contracts in Deployment Addresses.
We recommend users always verify the details of each transaction in the wallet before signing.
How to use it
Connect a wallet with funds on any of the supported networks, choose swap or pools, and sign. That's it. No account, no registration, no KYC, no deposit.
The swapwizard.xyz interface is one way to interact with SwapWizard; the contracts are public and can be invoked from any other interface or integration.
Integrators
SwapWizard provides multi-chain programmatic access from a single endpoint. The API allows developers to query available routes and build transactions on supported protocols, to integrate them into other applications, wallets, or interfaces.
Public API access is available. Register with your wallet to get an API key.
API Documentation
Protocol fee
SwapWizard smart contracts charges a flat 0.10% (10 basis points) fee on the output token of each swap. This fee is applied on-chain by the SwapWizardCore smart contract and is fully transparent and verifiable.
There are no hidden fees, no spreads, no interface charges, and no fees on liquidity operations themselves — only the internal swaps needed to balance token proportions.
Affiliate Widgets
SwapWizard offers embeddable widgets that allow affiliates to integrate swap and liquidity pool functionality directly into their websites. When users execute swaps through an affiliate widget, a 0.02% commission is automatically sent on-chain to the affiliate wallet on every transaction — no claims, no delays.
Widgets are served from SwapWizard's infrastructure and automatically stay up to date with the latest features and improvements. They support theme customization, language selection, and chain preselection, all configurable via simple HTML attributes.
Configure and preview widgetsDeployment addresses
docs.loading
Risks
Interacting with DeFi protocols carries risks. The user is responsible for evaluating them before each operation:
- Smart contract. Vulnerabilities in the contracts of the protocols SwapWizard interacts with.
- Liquidity. Sudden liquidity variations in pools that may affect the operation's output.
- Volatility. Price fluctuations between the moment of submission and execution.
- Divergence loss. In liquidity positions, potential loss compared to holding the tokens separately (impermanent loss).
Terms of use
SwapWizard provides tools for interacting with public DeFi contracts and protocols. By using it, the user acknowledges and accepts that:
- They are solely responsible for their transactions and their consequences.
- SwapWizard does not custody, control, or have access to the user's funds at any time. Funds flow directly between the user's wallet, routed through its public contracts, to the public contracts of each protocol, and vice versa.
- SwapWizard does not act as a counterparty in transactions and does not control their execution.
- SwapWizard does not provide financial, investment, or legal advice.
- Compliance with applicable laws and regulations in the user's jurisdiction is the user's sole responsibility.
Legal entity for contractual purposes: BucleLabs LLC, a Delaware (USA) company.
Contact
For integrations, early API access, or collaboration proposals: