uniswap-pool-analysis

What This Skill Does

The uniswap-pool-analysis skill provides OpenClaw agents with the capability to perform deep, on-chain inspections of Uniswap v3 and v4 liquidity pools. By interfacing directly with smart contracts via viem, the agent can retrieve real-time state variables such as the current sqrtPriceX96, tick index, and active liquidity levels. It translates complex blockchain hexadecimal data into human-readable metrics, enabling users to understand price dynamics and fee structures without manually parsing raw contract data. The skill includes built-in conversion utilities for price calculation based on tick index and price square roots, abstracting the underlying math for the user.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/wpank/uniswap-pool-analysis

Ensure that your environment variables, specifically ETHEREUM_RPC_URL or the relevant chain-specific RPC, are configured properly to allow the agent to perform read operations against the blockchain nodes.

Use Cases

This skill is designed for liquidity providers, market makers, and DeFi researchers. Primary use cases include:

• Determining optimal fee tiers for providing liquidity based on pool volatility.
• Auditing liquidity depth at specific price ranges to predict potential slippage.
• Analyzing historical tick data to identify trends in concentrated liquidity.
• Building automated monitoring bots that alert users when price action approaches the edges of their liquidity ranges.

Example Prompts

1. "Analyze the liquidity distribution for the WBTC/USDC 0.05% pool on Ethereum. How much liquidity exists between tick 190000 and 195000?"
2. "What is the current price of the ETH/DAI pool on Arbitrum, and how does that compare to the current tick's fee tier settings?"
3. "Show me the TVL and fee efficiency for the top three liquidity pools on Base for the WETH/USDC pair."

Tips & Limitations

• Rate Limiting: Frequent queries to blockchain nodes may hit RPC rate limits. Consider using high-throughput providers.
• Data Completeness: While slot0 gives the current state, reconstructing full liquidity distributions requires multiple contract calls to tickBitmap and ticks mappings, which can be computationally intensive.
• Chain Specifics: Always ensure the chainId is provided. If querying a non-mainnet chain, verify that the contract addresses for the factory and quoter are correctly mapped in your environment configuration.