# SperaxOS Liquidity Advisor – Analyze Positions

> SperaxOS Liquidity Advisor – Analyze Positions is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-16).

Analyzes a wallet's DeFi liquidity positions across chains and protocols using AI-powered intelligence, returning actionable insights and recommendations.

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/liquidity-advisor/analyzePositions?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-liquidity-advisor-analyze-positions-55caf1cc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mAYwqp-GugFt_J-wBl-Tv

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-advisor-analyze-positions-55caf1cc -d '<json body>'
```

Example prompt: Can you analyze all my liquidity positions for wallet 0xABC...123 across Uniswap v3 and Curve on Ethereum and give me AI-powered insights on how they're performing?

## When to prefer this

Choose this endpoint when you need AI-powered analysis of a wallet's DeFi liquidity positions across multiple chains and protocols in a single call, without needing an API key. Ideal for agents that manage or monitor LP portfolios and need actionable intelligence rather than raw on-chain data. Prefer over generic blockchain explorers when the user wants interpreted recommendations, not just raw position data.

## Known failure modes

- Invalid or unrecognized wallet address returns an error
- Unsupported chain or protocol name silently omitted or returns empty results
- Payment of 0.02 USDC via x402 not completed results in 402 Payment Required response
- Wallet has no active liquidity positions returns empty analysis
- Network timeout on multi-chain scan for large portfolios

## 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 analysis of the wallet's active liquidity positions, including position details per protocol and chain, performance metrics, risk indicators (such as impermanent loss exposure), and actionable recommendations for optimizing or managing those positions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Chains to scan. Omit for all supported chains."
  },
  "protocols": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Protocols to scan (e.g. [\"uniswap_v3\", \"curve\"]). Omit for all."
  },
  "walletAddress": {
   "type": "string",
   "description": "Wallet address to analyze."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-liquidity-advisor-analyze-positions-55caf1cc/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)