Uniswap Research And Trade
by @wpank
Research a token and execute a trade if it passes due diligence. Autonomous research-to-trade pipeline: researches the token, evaluates risk, and only trades if the risk assessment approves. Stops and reports if risk is too high. Use when user wants "research X and buy if it looks good" or "due diligence then trade."
clawhub install research-and-tradeπ About This Skill
name: research-and-trade description: >- Research a token and execute a trade if it passes due diligence. Autonomous research-to-trade pipeline: researches the token, evaluates risk, and only trades if the risk assessment approves. Stops and reports if risk is too high. Use when user wants "research X and buy if it looks good" or "due diligence then trade." model: opus allowed-tools: - Task(subagent_type:token-analyst) - Task(subagent_type:pool-researcher) - Task(subagent_type:risk-assessor) - Task(subagent_type:trade-executor) - mcp__uniswap__check_safety_status
Research and Trade
Overview
This is the autonomous research-to-execution pipeline. Instead of manually calling four different agents and wiring their outputs together, this skill runs the full expert workflow in one command: research a token, find the best pool, assess risk, and -- only if the risk assessment approves -- execute the trade.
Why this is 10x better than calling agents individually:
1. Compound context: Each agent receives the accumulated findings from all prior agents. The risk-assessor doesn't just evaluate a swap in isolation -- it sees the token-analyst's liquidity warnings, the pool-researcher's depth analysis, and the exact trade size, enabling a far richer risk assessment than standalone invocation. 2. Automatic risk gating: A VETO at any stage short-circuits the pipeline immediately. No wasted gas, no wasted time, and you get a full explanation of why. 3. Single command for a 4-step expert workflow: Manually coordinating token research, pool selection, risk evaluation, and trade execution takes significant time and expertise. This compresses it into one natural-language request. 4. Progressive disclosure: You see each stage's findings as they complete, not just a final result. If the pipeline stops at risk assessment, you still get the full research report.
When to Use
Activate when the user says anything like:
Do NOT use when the user just wants research without trading (use research-token instead) or just wants to execute a swap without research (use execute-swap instead).
Parameters
| Parameter | Required | Default | How to Extract | | ------------- | -------- | ---------- | ------------------------------------------------------------------ | | token | Yes | -- | Token to research and potentially buy: "UNI", "AAVE", or 0x addr | | amount | Yes | -- | Trade size: "$500", "1 ETH worth", "0.5 ETH" | | chain | No | ethereum | Target chain: "ethereum", "base", "arbitrum" | | riskTolerance | No | moderate | "conservative", "moderate", "aggressive" | | action | No | buy | "buy" (swap into token) or "sell" (swap out of token) | | payWith | No | WETH | Token to spend: "WETH", "USDC", etc. |
If the user doesn't provide an amount, ask for it -- never guess a trade size.
Workflow
RESEARCH-AND-TRADE PIPELINE
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β
β Step 1: RESEARCH (token-analyst) β
β βββ Token metadata, liquidity, volume, risk factors β
β βββ Cross-chain presence β
β βββ Output: Token Research Report β
β β β
β βΌ (feeds into Step 2) β
β β
β Step 2: POOL ANALYSIS (pool-researcher) β
β βββ Find all pools for {token}/{payWith} on {chain} β
β βββ Rank by fee APY, depth, utilization β
β βββ Analyze depth at trade size (can it handle $X?) β
β βββ Output: Pool Research Report + Best Pool Selection β
β β β
β βΌ (feeds into Step 3 with COMPOUND CONTEXT) β
β β
β Step 3: RISK ASSESSMENT (risk-assessor) β
β βββ Receives: token risks + pool risks + trade size + slippage β
β βββ Evaluates: slippage, liquidity, smart contract, token risk β
β βββ Decision: APPROVE / CONDITIONAL_APPROVE / VETO / HARD_VETO β
β βββ Output: Risk Assessment Report β
β β β
β βΌ CONDITIONAL GATE β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β APPROVE β Proceed to Step 4 β β
β β COND. APPROVE β Show conditions, ask user β β
β β VETO β STOP. Show research + reason. β β
β β HARD VETO β STOP. Non-negotiable. β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β (only if APPROVE or user confirms CONDITIONAL) β
β βΌ β
β β
β Step 4: USER CONFIRMATION β
β βββ Present: research summary + risk score + swap quote β
β βββ Ask: "Proceed with this trade?" β
β βββ User must explicitly confirm β
β β β
β βΌ β
β β
β Step 5: EXECUTE (trade-executor) β
β βββ Execute swap through safety-guardian pipeline β
β βββ Monitor transaction confirmation β
β βββ Output: Trade Execution Report β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Step 1: Research (token-analyst)
Delegate to Task(subagent_type:token-analyst) with:
What to pass to the agent:
Research this token for a potential trade:
Token: {token}
Chain: {chain}
Trade size: {amount} Provide a full due diligence report: liquidity across all pools, volume profile
(24h/7d/30d), risk factors, and a trading recommendation with maximum trade size
at < 1% price impact.
Present to user after completion:
Step 1/5: Token Research Complete Token: UNI (Uniswap) on Ethereum
Total Liquidity: $85M across 24 pools
24h Volume: $15M | 7d Volume: $95M
Volume Trend: Stable
Risk Factors: None significant
Max Trade (< 1% impact): $2.5M
Proceeding to pool analysis...
Gate check: If the token-analyst reports critical risk factors (total liquidity < $100K, no pools found, token not verified), present findings and ask the user if they want to continue before proceeding.
Step 2: Pool Analysis (pool-researcher)
Delegate to Task(subagent_type:pool-researcher) with the token research output:
Find the best pool for trading {token}/{payWith} on {chain}.Context from token research:
Total liquidity: {from Step 1}
Dominant pool: {from Step 1}
Risk factors: {from Step 1} Trade details:
Trade size: {amount}
Direction: {action} (buying/selling {token}) Analyze all pools for this pair across fee tiers. For each pool, report:
fee APY, TVL, liquidity depth at the trade size, and price impact estimate.
Recommend the best pool for this specific trade.
Present to user after completion:
Step 2/5: Pool Analysis Complete Best Pool: WETH/UNI 0.3% (V3, Ethereum)
Pool TVL: $42M
Price Impact: ~0.3% for your trade size
Fee Tier: 0.3% (3000 bps)
Proceeding to risk assessment...
Step 3: Risk Assessment (risk-assessor)
Delegate to Task(subagent_type:risk-assessor) with compound context from Steps 1 and 2:
Evaluate risk for this proposed swap:Operation: swap {amount} {payWith} for {token}
Pool: {best pool from Step 2}
Chain: {chain}
Risk tolerance: {riskTolerance}
Token research context (from token-analyst):
{Full token research summary from Step 1}
Pool analysis context (from pool-researcher):
{Full pool analysis from Step 2}
Evaluate all applicable risk dimensions: slippage, liquidity, smart contract risk.
Provide a clear APPROVE / CONDITIONAL_APPROVE / VETO / HARD_VETO decision.
Conditional gate logic after risk-assessor returns:
| Decision | Action | | -------------------- | ------------------------------------------------------------------------------------ | | APPROVE | Present risk summary, proceed to Step 4 (user confirmation) | | CONDITIONAL_APPROVE | Show conditions (e.g., "split into 2 tranches"). Ask user: "Accept conditions?" | | VETO | STOP. Show full research report + risk assessment + veto reason. Suggest alternatives. | | HARD_VETO | STOP. Show reason. Non-negotiable -- do not offer to proceed. |
Present to user (APPROVE case):
Step 3/5: Risk Assessment Complete Decision: APPROVE
Composite Risk: LOW
Slippage Risk: LOW (0.3% estimated)
Liquidity Risk: LOW (pool TVL 840x trade size)
Smart Contract Risk: LOW (V3, 18-month-old pool)
Ready for your confirmation...
Present to user (VETO case):
Step 3/5: Risk Assessment -- VETOED Decision: VETO
Reason: Price impact of 4.2% exceeds moderate risk tolerance (max 2%)
Research Summary:
Token: SMALLCAP ($180K total liquidity)
Best Pool: WETH/SMALLCAP 1% (V3, $95K TVL)
Your trade size ($5,000) represents 5.3% of pool TVL
Suggestions:
- Reduce trade size to < $1,000 for acceptable slippage
- Use a limit order instead: "Submit limit order for SMALLCAP"
- Try a different chain if more liquidity exists elsewhere
Pipeline stopped. No trade executed.
Step 4: User Confirmation
Before executing any trade, present a clear summary and ask for explicit confirmation:
Trade Confirmation Required Research: UNI β $85M liquidity, stable volume, no risk factors
Risk: APPROVED (LOW composite risk)
Swap Details:
Sell: 0.5 WETH (~$980)
Buy: ~28.5 UNI
Pool: WETH/UNI 0.3% (V3, Ethereum)
Impact: ~0.3%
Gas: ~$8 estimated
Proceed with this trade? (yes/no)
Only proceed to Step 5 if the user explicitly confirms.
Step 5: Execute (trade-executor)
Delegate to Task(subagent_type:trade-executor) with the full pipeline context:
Execute this swap:
Sell: {amount} {payWith}
Buy: {token}
Pool: {best pool address from Step 2}
Chain: {chain}
Slippage tolerance: {derived from risk assessment}
Risk assessment: APPROVED, composite risk {level} The token has been researched (liquidity: {X}, volume: {Y}) and risk-assessed
(slippage: {Z}, liquidity: {W}). Proceed with execution through the safety pipeline.
Present final result:
Step 5/5: Trade Executed Sold: 0.5 WETH ($980.00)
Received: 28.72 UNI ($985.50)
Pool: WETH/UNI 0.3% (V3, Ethereum)
Slippage: 0.28% (within tolerance)
Gas: $7.20
Tx: https://etherscan.io/tx/0x...
ββββββββββββββββββββββββββββββββββββββ
Pipeline Summary
ββββββββββββββββββββββββββββββββββββββ
Research: UNI β $85M liquidity, stable, no risk flags
Pool: WETH/UNI 0.3% β best depth for trade size
Risk: APPROVED (LOW)
Execution: Success β 28.72 UNI received
Total cost: $987.20 (trade + gas)
Output Format
Successful Pipeline (all 5 steps)
Research and Trade Complete Token: {symbol} ({name}) on {chain}
Research: {1-line summary from token-analyst}
Pool: {pool pair} {fee}% ({version}, {chain})
Risk: {decision} ({composite_risk})
Trade:
Sold: {amount} {payWith} (${usd_value})
Received: {amount} {token} (${usd_value})
Impact: {slippage}%
Gas: ${gas_cost}
Tx: {explorer_link}
Pipeline: Research -> Pool -> Risk -> Confirm -> Execute (all passed)
Vetoed Pipeline (stopped at risk)
Research and Trade -- Risk Vetoed Token: {symbol} ({name}) on {chain}
Research: {1-line summary}
Pool: {best pool found}
Risk: VETOED β {reason}
Details:
{risk dimension scores}
Suggestions:
- {mitigation 1}
- {mitigation 2}
Pipeline: Research -> Pool -> Risk (VETOED) -- No trade executed.
Important Notes
execute-swap.execute-swap directly if they want to proceed at their own risk -- but this skill will not do it.Error Handling
| Error | User-Facing Message | Suggested Action | | ----------------------------- | ------------------------------------------------------------------------ | ----------------------------------------- | | Token not found | "Could not find token {X} on {chain}." | Check spelling or provide contract address| | No pools found | "No Uniswap pools found for {token}/{payWith} on {chain}." | Try different pay token or chain | | Token-analyst fails | "Token research failed: {reason}. Cannot proceed without due diligence." | Try again or use research-token directly | | Pool-researcher fails | "Pool analysis failed. Research completed but cannot find optimal pool." | Try execute-swap with manual pool choice | | Risk-assessor VETO | "Risk assessment vetoed this trade: {reason}." | Reduce amount, try different token/pool | | Risk-assessor HARD_VETO | "Trade blocked: {reason}. This cannot be overridden." | The trade is unsafe at any size | | Trade-executor fails | "Trade execution failed: {reason}. Research and risk data preserved." | Check wallet, balance, gas; retry | | Safety check fails | "Safety limits exceeded. Check spending limits with check-safety." | Wait for limit reset or adjust limits | | User declines confirmation | "Trade cancelled. Research and risk data are shown above for reference." | No action needed | | Wallet not configured | "No wallet configured. Cannot execute trades." | Set up wallet with setup-agent-wallet | | Insufficient balance | "Insufficient {payWith} balance: have {X}, need {Y}." | Reduce amount or acquire more tokens |