home / skills / openclaw / skills / analyze-pool

analyze-pool skill

safe

This skill analyzes a specific Uniswap pool, returning TVL, volume, fee APY, liquidity depth, risk factors to help assess LP viability.

npx playbooks add skill openclaw/skills --skill analyze-pool

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

3.4 KB

---
name: analyze-pool
description: Analyze a specific Uniswap pool's performance, liquidity depth, fee APY, and risk factors. Use when the user asks about pool metrics, TVL, volume, or whether a pool is good for LPing.
model: opus
allowed-tools: [Task(subagent_type:pool-researcher)]
---

# Analyze Pool

## Overview

Provides a detailed analysis of a specific Uniswap pool by delegating to the `pool-researcher` agent. Returns TVL, volume, fee APY, liquidity depth, concentration metrics, and risk factors.

## When to Use

Activate when the user asks:

- "Analyze the ETH/USDC pool"
- "What's the TVL of X/Y pool?"
- "How much volume does the WETH/USDC pool do?"
- "What's the fee APY for ETH/USDC?"
- "Is this pool good for LPing?"
- "Pool info for ETH/USDC on Base"
- "How deep is the liquidity in this pool?"

## Parameters

| Parameter | Required | Default     | Description                                   |
| --------- | -------- | ----------- | --------------------------------------------- |
| token0    | Yes      | —           | First token name, symbol, or address          |
| token1    | Yes      | —           | Second token name, symbol, or address         |
| chain     | No       | ethereum    | Chain name (ethereum, base, arbitrum, etc.)    |
| feeTier   | No       | Auto-detect | Fee tier (e.g., "0.05%", "30bp", "3000")      |
| version   | No       | Auto-detect | Protocol version: "v2", "v3", or "v4"         |

## Workflow

1. **Extract parameters** from the user's request: identify token0, token1, chain, fee tier, and version.

2. **Delegate to pool-researcher**: Invoke `Task(subagent_type:pool-researcher)` with the extracted parameters. The pool-researcher will gather on-chain data, calculate metrics, and produce a structured report.

3. **Present results**: Format the pool-researcher's report into a user-friendly summary covering:
   - Pool identification (address, version, fee tier)
   - Current state (price, TVL, liquidity)
   - Performance (fee APY 7d/30d, volume 24h/7d, utilization)
   - Liquidity depth (trade size at < 1% impact)
   - Risk factors (if any)

## Output Format

Present a clean summary:

```text
Pool Analysis: WETH/USDC 0.05% (V3, Ethereum)

  Address: 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640
  TVL:     $332M
  Price:   $1,963.52

  Performance:
    Fee APY (7d):  21.3%
    Fee APY (30d): 6.65%
    Volume (24h):  $610M
    Utilization:   1.84x

  Liquidity Depth:
    1% impact: $5M trade size
    5% impact: $25M trade size
    Concentration: 78.5% within ±2% of price

  Risk Factors: None identified
```

## Important Notes

- This skill delegates entirely to the `pool-researcher` agent — it does not call MCP tools directly.
- If the pool doesn't exist, the agent will report this clearly.
- Fee APY is historical (not guaranteed). The output distinguishes realized vs projected APY.

## Error Handling

| Error                    | User-Facing Message                          | Suggested Action                |
| ------------------------ | -------------------------------------------- | ------------------------------- |
| Pool not found           | "No pool found for X/Y on this chain."       | Try different fee tier or chain |
| Token not recognized     | "Could not resolve token X."                 | Provide contract address        |
| Insufficient data        | "Limited data available for this pool."       | Pool may be too new             |

Overview

This skill analyzes a specific Uniswap pool and produces a concise, actionable summary of TVL, volume, fee APY, liquidity depth, concentration, and risk factors. It delegates data collection and calculations to a specialized pool-researcher agent and returns a formatted report that helps decide whether to provide liquidity. Results highlight realized vs projected APY and identify potential on-chain or market risks.

How this skill works

The skill extracts token pair, chain, fee tier, and protocol version from the user request, then delegates the heavy lifting to the pool-researcher agent. The pool-researcher queries on-chain sources and historical data to compute TVL, recent volume, fee APY (7d/30d), liquidity depth at defined price impacts, concentration metrics, and a concise list of risk factors. The skill formats those findings into a readable summary with pool ID, price, performance, depth, and risk notes.

When to use it

When you want TVL, recent volume, or fee APY for a Uniswap pool.
To check liquidity depth and expected price impact for a trade size.
When deciding whether a pool is attractive for providing liquidity.
To compare performance across fee tiers or protocol versions.
If you need a clear list of risk factors tied to a pool.

Best practices

Specify both tokens and the chain (e.g., ethereum, base) to avoid ambiguity.
Provide the fee tier or let the skill auto-detect if uncertain.
Use contract addresses when token names are ambiguous.
Treat fee APY as historical; combine with your own risk assessment.
Check liquidity depth before sizing a trade or LP position.

Example use cases

Analyze the WETH/USDC 0.05% pool on Ethereum to decide on LP entry.
Estimate 1% and 5% price-impact trade sizes for a token pair on Base.
Compare 7-day vs 30-day fee APY for candidate pools before reallocating capital.
Confirm whether a reported pool address actually exists and has sufficient TVL.
Surface concentration and impermanent loss risk for a high-priced volatility pair.

FAQ

What if the pool doesn't exist or is new?

The skill will report 'No pool found' if the pool is absent. For very new pools it may return 'Limited data available' and flag insufficient historical metrics.

Are fee APY numbers guaranteed?

No. Fee APY is historical and presented as realized vs projected where applicable; future performance depends on volume and volatility.