| Document type | Technical documentation summary |
|---|---|
| Maintainer | 1inch contributors |
| Date | Living documentation; reviewed October 8, 2026 |
| Project | 1inch |
| License | The historical 1inchProtocol and Limit Order Protocol code repositories use MIT. This does not establish an MIT license for all documentation or API services. |
1inch’s aggregation documentation explains how liquidity from multiple exchanges can be used in one swap. This page reviews its routing model, historical contract interface and later protocol distinctions. The official Classic Swap API documentation is the primary current reference. It is a collection of technical resources, rather than a single dated “Whitepaper v3.”
| Directories | Ethereum Whitepapers & Research |
|---|
A DEX aggregator compares available trading paths. More liquidity sources can improve the choices available, but a quote is not a promise of execution at that price. The route, network costs and transaction conditions all matter.
Scope and version history
The archived 1inchProtocol repository documents an earlier on-chain aggregation design. It is marked deprecated and directs integrators toward the API. Its interfaces remain useful for understanding historical routing, but should not be treated as instructions for a current deployment.
The November 5, 2020 v2 announcement introduced Pathfinder as a discovery and routing algorithm that could divide a swap among protocols and different liquidity depths within one protocol. That announcement describes the 2020 release; current integrations should use the current documentation and identify their contract and API versions.
How Pathfinder combines liquidity
Pathfinder searches for a route from the input asset to the output asset, potentially using intermediate tokens and splitting the amount between liquidity sources. A route with the largest gross output can still be less attractive after its additional gas costs. The Classic Swap API introduction describes splitting across protocols and market depths.
For an illustrative swap of 100 units of token A, a route might assign 60 units to one source and 40 to another. Those numbers explain splitting; they are not a live quote or a fixed 1inch rule. Slippage can arise when the execution conditions differ from the quote.
A June 10, 2025 Pathfinder update describes merging intermediate steps. In its USDC-to-APE example, outputs reaching the same intermediate asset are combined before the final swap, allowing reuse of a more favorable market while reducing redundant steps. This is an optimization described for that release, not evidence that every trade gets a particular saving.
Historical contract interface
The earlier repository’s getExpectedReturn returns an estimated output and a distribution array. Its gas-aware variant also considers estimated gas cost; swap execution uses the selected distribution. These interfaces show the distinction between choosing a route and executing it. More finely divided routes can introduce additional execution costs, so splitting is a trade-off rather than a universal improvement.
Limit orders and Fusion
The Limit Order Protocol uses EIP-712 orders signed off-chain and filled on-chain. Its documented features include optional partial fills, expiration and execution conditions. In v4, the separate RFQ order format is deprecated. The repository warns that development code can be unaudited and directs readers toward tagged versions and their audits.
Fusion was announced on December 25, 2022. It uses an intent-based execution model with Dutch auctions and resolvers that pay settlement gas. This differs from submitting a Classic swap transaction directly. Resolver-paid gas does not mean that execution has no costs, or that earlier aggregation versions used the same mechanism. Claims about MEV protection need to be evaluated for the specific mode.
CHI and governance in historical context
Gas-token designs depended on Ethereum refund rules. EIP-3529 removed the SELFDESTRUCT refund, reduced the storage-clearing refund and capped refunds at one fifth of gas used. It did not eliminate every storage refund. Its rationale explains why the gas-token mechanism became economically unviable; it should not be presented as a current gas-saving feature.
The 1INCH launch announcement is dated December 25, 2020. It describes governance and a distribution with eligibility conditions, rather than an unconditional allocation to every past user. These launch settings are historical context, not a complete account of today’s token utility or DAO configuration.
Limits and further research
Read the exact deployed version’s documentation and audit scope. The official audit archive separates aggregation, limit-order and Fusion components. An audit is evidence about a particular implementation and review scope, not a guarantee for every integration. API availability, supported networks and liquidity sources can change.
Social Media Sentiment
Not applicable to this technical-documentation summary. Project announcements above identify design changes; they are not a measurement of community sentiment or a recommendation about 1INCH.
Last updated: 2026-10
Related Terms
- DEX Aggregators — routing across liquidity sources.
- Slippage — differences between quoted and executed prices.
- MEV — transaction-ordering considerations.
See Also
- Uniswap v3 whitepaper — concentrated liquidity in an individual market.
- 0x’s original protocol paper — an earlier off-chain order and on-chain settlement design.
Sources
- 1inch. Classic Swap API: Introduction. Living documentation; accessed October 8, 2026.
- 1inch. 1inchProtocol: README and MIT license. Historical repository, archived February 13, 2025.
- 1inch. Introducing 1inch v2. November 5, 2020; Pathfinder launch and gas-aware routing.
- Kozlov, V. Better swap rates in DeFi: how 1inch’s upgraded Pathfinder finds optimal routes. June 10, 2025; updated April 24, 2026.
- 1inch. Limit Order Protocol: README. Signed orders, version warnings and v4 RFQ changes; accessed October 8, 2026.
- 1inch. 1inch releases intent-based swaps (Fusion swaps). December 25, 2022; updated May 7, 2026.
- Buterin, V., and Swende, M. EIP-3529: Reduction in refunds. April 22, 2021. Ethereum Improvement Proposals.
- 1inch. 1INCH token is released. December 25, 2020; launch governance and eligibility conditions.
- 1inch. Smart Contract Audit Reports. Official archive grouped by protocol and version; accessed October 8, 2026.