Quickstart

Base URL: https://api.1inch.com/aqua

The gateway rewrites /aqua/... to the Aqua service. OpenAPI spec: /aqua/swagger-json.

All requests require a 1inch API key (Authorization: Bearer ...) — the same key used for the other 1inch APIs; see Authentication. Aqua is enabled per plan — if your key's plan does not include Aqua, requests to /aqua return 404.

Check service availability

Bash
1
2
3
curl 'https://api.1inch.com/aqua/v1.0/general/status' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Discover open strategies

GET /v1.0/strategies/opened returns every currently open strategy (newest first) with its strategy bytes and per-token maker balance/allowance data — cursor-paginated via nextCursor, up to 500 items per page. Balance data is indexed with a delay: re-quote on-chain before execution.

Bash
1
2
3
curl 'https://api.1inch.com/aqua/v1.0/strategies/opened?chainIds=1&limit=100' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example request

Replace the path below with the endpoint you need from the OpenAPI section:

Bash
1
2
3
curl 'https://api.1inch.com/aqua/v1.0/...' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

TypeScript SDK

For on-chain interactions (building ship, dock, pull, and push calldata), use the Aqua SDK:

Bash
1
pnpm add @1inch/aqua-sdk

See the SDK repository for full examples.

Did you find what you need?