playbooks

home / skills / openclaw / skills / research-token

research-token skill

/skills/wpank/research-token

This skill performs comprehensive token due diligence on Uniswap liquidity, volume, and risk by delegating to a token-analyst for cross-chain analysis.

npx playbooks add skill openclaw/skills --skill research-token

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

Files (3)
SKILL.md
3.0 KB
---
name: research-token
description: Research a token's Uniswap liquidity, volume profile, pool distribution, and risk factors. Use when the user asks about a token's tradability, liquidity depth, or wants due diligence.
model: opus
allowed-tools: [Task(subagent_type:token-analyst)]
---

# Research Token

## Overview

Performs comprehensive due diligence on a token from a Uniswap protocol perspective. Delegates to the `token-analyst` agent to analyze liquidity across all pools, volume trends, and risk factors.

## When to Use

Activate when the user asks:

- "Research UNI token"
- "Is there enough liquidity for X?"
- "Token analysis for PEPE"
- "Due diligence on this token"
- "What pools trade X?"
- "How liquid is X on Uniswap?"
- "Is X safe to trade?"

## Parameters

| Parameter | Required | Default      | Description                                    |
| --------- | -------- | ------------ | ---------------------------------------------- |
| token     | Yes      | —            | Token name, symbol, or contract address         |
| chain     | No       | All chains   | Specific chain or "all" for cross-chain view   |
| focus     | No       | Full analysis| "liquidity", "volume", or "risk"               |

## Workflow

1. **Extract parameters** from the user's request: identify the token and any chain/focus filters.

2. **Delegate to token-analyst**: Invoke `Task(subagent_type:token-analyst)` with the token identifier. The agent resolves the token, discovers all pools, analyzes liquidity and volume, and produces a risk assessment.

3. **Present results**: Format the token-analyst's report into a user-friendly summary.

## Output Format

```text
Token Research: UNI (Uniswap)

  Address:  0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984
  Chains:   Ethereum, Arbitrum, Optimism, Polygon, Base
  Pools:    24 active pools across all chains

  Liquidity:
    Total TVL:   $85M across all pools
    Best pool:   WETH/UNI 0.3% (49.4% of liquidity)
    Depth (1%):  $2.5M trade size
    Fragmentation: Moderate

  Volume:
    24h: $15M | 7d: $95M | 30d: $380M
    Trend: Stable
    Turnover: 0.18x daily

  Risk Factors:
    - Moderate pool concentration (49.4% in one pool) — LOW severity

  Trading: Suitable for trades up to $2.5M with < 1% price impact
```

## Important Notes

- Delegates entirely to `token-analyst` — no direct MCP tool calls.
- The analysis is from a Uniswap protocol perspective only — not a general investment analysis.
- Risk factors are based on observable on-chain metrics, not price predictions.

## Error Handling

| Error                | User-Facing Message                              | Suggested Action              |
| -------------------- | ------------------------------------------------ | ----------------------------- |
| Token not found      | "Could not find token X on Uniswap."             | Provide contract address      |
| No pools             | "No Uniswap pools found for this token."          | Token may not be listed       |
| Insufficient data    | "Limited trading data available for this token."  | Token may be too new          |

Overview

This skill performs Uniswap-focused due diligence on ERC-20 tokens to determine tradability and liquidity health. It summarizes pool distribution, TVL, depth metrics, volume trends, and observable on-chain risk factors. Use it to decide trade size tolerances and to surface potential execution or concentration risks.

How this skill works

The skill extracts the token identifier and optional chain or analysis focus, then delegates to a specialized token-analyst agent that discovers all Uniswap pools for the token. The agent aggregates TVL across pools, computes depth and 1% price-impact trade sizes, analyzes recent volume and turnover, and identifies risk signals such as pool concentration, low depth, or stale activity. The skill formats that report into a clear, actionable summary for the user.

When to use it

  • You need to know if a token is tradable on Uniswap with acceptable price impact.
  • You want a quick estimate of max trade size at <1% price impact across Uniswap pools.
  • Conducting due diligence before placing large market orders or providing liquidity.
  • Checking pool distribution and concentration across chains (Ethereum, Arbitrum, Optimism, Polygon, Base).
  • Verifying whether there is sufficient 24h/7d volume to support routine trading.

Best practices

  • Provide a contract address when possible to avoid token ambiguity.
  • Specify a chain or set focus to Liquidity, Volume, or Risk for a shorter, targeted report.
  • Use the 1% price-impact depth metric as a conservative execution threshold.
  • Combine this Uniswap-centric view with broader off-chain and protocol-level due diligence for investment decisions.
  • If token-analyst reports limited data, treat estimates as unreliable for large trades.

Example use cases

  • "Research UNI" to get TVL, best pool, and safe trade size across Uniswap.
  • Ask "How liquid is PEPE on Uniswap?" before executing a market order.
  • Due diligence on a new token to confirm whether any Uniswap pools exist and whether they are active.
  • Assess pool concentration to decide whether to route a large swap across multiple pools or chains.
  • Estimate expected slippage and choose the pool with the best depth for a large trade.

FAQ

What chains does the analysis cover?

By default it checks all supported Uniswap deployments (Ethereum, Arbitrum, Optimism, Polygon, Base). You can request a specific chain for a focused view.

Can this replace financial or investment advice?

No. The analysis is strictly Uniswap on-chain metrics (liquidity, volume, pool distribution, quantifiable risks) and is not investment advice.