# SperaxOS Liquidity Range Optimizer

> SperaxOS Liquidity Range Optimizer is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-20).

Analyzes a concentrated liquidity position and recommends an optimal price range based on historical volatility and the chosen optimization strategy (maximize fees, minimize impermanent loss, or balanced).

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/liquidity-advisor/optimizeRange?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-liquidity-range-optimizer-8c7be47b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_avvjRDeY4_tP7WetIt7qc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability speraxos-liquidity-range-optimizer-8c7be47b -d '<json body>'
```

Example prompt: I have a Uniswap V3 position on Base (position ID 12345) — can you analyze the last 30 days of volatility and recommend an optimized price range using a balanced strategy to balance fees and impermanent loss?

## When to prefer this

Choose this endpoint when you need AI-driven, data-backed range optimization for a specific concentrated liquidity position (Uniswap V3 or compatible) and want to tune the tradeoff between fee income and impermanent loss exposure. It is especially useful when you want strategy-specific guidance (maximize fees, minimize IL, or balanced) grounded in recent price volatility rather than static heuristics. Prefer it over generic DeFi dashboards when you need actionable, per-position recommendations payable per-request without an API key.

## Known failure modes

- Invalid or non-existent position ID returns an error or empty result
- Unsupported chain or protocol causes a validation error
- Insufficient historical data for the requested volatility window returns a degraded or fallback recommendation
- Payment failure via x402 (insufficient USDC balance or network error) blocks the request
- Malformed strategy value returns a parameter validation error

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns an AI-generated recommendation for the optimal price range (tick bounds) for the specified concentrated liquidity position, including the suggested lower and upper price bounds, expected fee APR under the recommended range, estimated impermanent loss exposure, and an explanation of the reasoning based on historical volatility over the specified lookback window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain of the position."
  },
  "protocol": {
   "type": "string",
   "description": "Protocol name."
  },
  "strategy": {
   "type": "string",
   "description": "Optimization strategy: \"maximize_fees\" (narrow range, high APR), \"minimize_il\" (wide range, low IL), or \"balanced\"."
  },
  "positionId": {
   "type": "string",
   "description": "Position ID (Uni V3 or other concentrated liquidity position)."
  },
  "volatilityWindowDays": {
   "type": "number",
   "description": "Lookback period for volatility analysis. Default: 30."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-liquidity-range-optimizer-8c7be47b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)
