The 1inch Aqua API provides HTTP access to the Aqua Protocol — a shared liquidity layer that lets liquidity providers allocate virtual token balances across multiple trading strategies without fragmenting capital across isolated pools.
Use this API to query protocol state, strategies, and related on-chain data from your applications. For encoding transactions and parsing contract events, see the Aqua TypeScript SDK and the Aqua app template.
Key endpoints
GET /v1.0/strategies/opened— the discovery endpoint: every currently open strategy, newest first, with the strategy bytes and per-token maker balance/allowance data. Filter withchainIds(and app filters); results are cursor-paginated (nextCursor), up to 500 items per page. Balance/allowance values are indexed with a delay — always re-quote on-chain before execution.GET /v1.0/general/status— service availability check.
The full endpoint list lives in the OpenAPI section.
Supported chains
The API covers all 13 Aqua chains. The canonical list with deployment details lives in Supported chains.
| Supported chains | Chain ID |
|---|---|
| Ethereum | 1 |
| Optimism | 10 |
| BNB Chain | 56 |
| Gnosis | 100 |
| Unichain | 130 |
| Polygon | 137 |
| Sonic | 146 |
| zkSync Era | 324 |
| Robinhood Chain | 4663 |
| Base | 8453 |
| Arbitrum | 42161 |
| Avalanche | 43114 |
| Linea | 59144 |
Core concepts
| Term | Meaning |
|---|---|
| Maker | Liquidity provider who ships virtual balances into Aqua strategies. |
| App | Smart contract that implements a trading application on top of Aqua. |
| Strategy | Immutable configuration (identified by keccak256(abi.encode(strategy))) that defines how virtual balances are used. |
| Ship / Dock | Lifecycle operations that allocate or remove virtual balances for a strategy. |
| Pull / Push | Swap interface operations that move tokens during trade execution. |
Authentication
All requests require a valid 1inch API key. See Authentication for header and OAuth details.
Aqua is enabled per plan. If your key's plan does not include Aqua, requests to /aqua return 404.
API reference
For detailed information about each endpoint, refer to the Aqua API OpenAPI section.