uniswap-v3-expert

uniswap-v3-expert is an agent for Claude Code from ccashwell/evm-cortex. It costs 29 tokens per session (2,233 once invoked), scanned A, original, MIT.

A guide to integrating with Uniswap V3, a decentralized exchange that lets liquidity providers choose price ranges for their funds. It covers the deployed contracts and the process for creating pools, managing positions, swapping, and using price oracles.

In plain words
What is it for?
Use it to work with factories, pools, liquidity-position NFTs, routers, multi-hop swaps, time-weighted average prices, flash loans, and Uniswap callback interfaces.
Why use it?
Uniswap V3 integrations involve several contracts, callbacks, price ranges, and token-handling steps. Missing one of these details can cause failed transactions or incorrect liquidity and swap behavior.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: model in frontmatter.

Good fit Use it to work with factories, pools, liquidity-position NFTs, routers, multi-hop swaps, time-weighted average prices, flash loans, and Uniswap callback interfaces.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/ccashwell/evm-cortex/uniswap-v3-expert
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/ccashwell/evm-cortex

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for uniswap-v3-expert

README.md
[![agentmods](https://agentmods.dev/badge/agents/ccashwell/evm-cortex/uniswap-v3-expert.svg)](https://agentmods.dev/agents/ccashwell/evm-cortex/uniswap-v3-expert)
Your own site
<a href="https://agentmods.dev/agents/ccashwell/evm-cortex/uniswap-v3-expert"><img src="https://agentmods.dev/badge/agents/ccashwell/evm-cortex/uniswap-v3-expert.svg" alt="Measured on agentmods" height="20"></a>
Per session 29 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,233 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00029 $0.02233
Opus 5 $0.00015 $0.01117
Sonnet 5 $0.00006 $0.00447
Haiku 4.5 $0.00003 $0.00223

Measured 8d ago against content hash 340909bcea4d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

uniswap-v3-expert scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/uniswap-v3-expert.md · 173 lines

How it starts

The opening of the file, as written. The whole thing — 173 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Uniswap V3 Expert

You are the definitive authority on Uniswap V3 protocol architecture, concentrated liquidity mechanics, and production integration patterns. You understand the factory-pool model, NonfungiblePositionManager, SwapRouter, oracle system, and callback patterns. You write code that integrates with the real, deployed V3 contracts.

Expertise

  • Factory-pool architecture — UniswapV3Factory creates per-pair-per-fee pools via CREATE2
  • Concentrated liquidity — tick-based pricing, position ranges [tickLower, tickUpper], active vs inactive liquidity
  • Tick system — price = 1.0001^tick, tick spacing per fee tier (1/10/60/200), tick bitmap for efficient traversal
  • NonfungiblePositionManager — ERC-721 LP position NFTs, mint/increase/decrease/collect/burn lifecycle
  • SwapRouter — exactInputSingle, exactInput (multi-hop), exactOutputSingle, exactOutput
  • Oracle system — built-in TWAP via observation array, cumulative ticks, cardinality management
  • Callbacks — uniswapV3SwapCallback, uniswapV3MintCallback, uniswapV3FlashCallback
  • Flash loans — pool.flash() for atomic borrow/repay
  • Fee tiers — 0.01% (stables), 0.05% (correlated), 0.30% (standard), 1.00% (exotic)
  • Multi-hop routing — path encoding via abi.encodePacked(token, fee, token, ...)

Production Deployment Addresses (Ethereum)

UniswapV3Factory:                0x1F98431c8aD98523631AE4a59f267346ea31F984
NonfungiblePositionManager:      0xC36442b4a4522E871399CD717aBDD847Ab11FE88
SwapRouter (v1):                 0xE592427A0AEce92De3Edee1F18E0157C05861564
SwapRouter02:                    0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45
QuoterV2:                        0x61fFE014bA17989E743c5F6cB21bF9697530B21e
UniversalRouter:                 0x66a9893cC07D91D95644AEDD05D03f95e1dBA8Af

CRITICAL: Addresses vary by chain. Base, BNB, Avalanche, and Celo use different addresses. Always verify with cast code.

Key V3 Pools (Ethereum)

ETH/USDC 0.05%:   0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640
ETH/USDC 0.30%:   0x8ad599c3A0ff1De082011EFDDc58f1908eb6e6D8
ETH/USDT 0.05%:   0x11b815efB8f581194ae79006d24E0d814B7697F6
WBTC/ETH 0.30%:   0xCBCdF9626bC03E24f779434178A73a0B4bad62eD
USDC/USDT 0.01%:  0x3416cF6C708Da44DB2624D63ea0AAef7113527C6
DAI/USDC 0.01%:   0x5777d92f208679DB4b9778590Fa3CAB3aC9e2168

Read the full file on GitHub · 173 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 173 lines · 29 tokens per session scan A 340909bcea4d

Subscribe to this mod's changes

uniswap-v3-expert is an agent published in the GitHub repository ccashwell/evm-cortex (128 stars, last pushed yesterday), licensed MIT. It adds 29 tokens to every session and 2,233 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

chainaware-ltv-estimator

Estimates the 12-month revenue potential (Lifetime Value) of any Web3 wallet using behavioral signals from ChainAware's Prediction MCP. Combines on-chain experience, activity categories, risk profile, forward-looking intent, and fraud-based retention probability into a USD revenue range. Use this agent PROACTIVELY…

ChainAware/behavioral-prediction-mcp · 297 tokens

chainaware-counterparty-screener

Real-time pre-transaction counterparty screening using ChainAware's Behavioral Prediction MCP. Returns a fast go/no-go Interaction Risk Level (Safe / Caution / Block) with a one-line reason before a trade, transfer, or contract interaction. Use this agent PROACTIVELY whenever a user is about to interact with an…

ChainAware/behavioral-prediction-mcp · 231 tokens

token-economics-designer

Token economics and tier design specialist. Use when designing pricing models, access tiers, or token distribution strategies.

Matt-Dionis/claude-code-configs · 28 tokens

crypto-analyst

Cryptocurrency market analyst - price trends, fundamentals, risk assessment using CoinPaprika data for 12,000+ cryptocurrencies and 350+ exchanges.

coinpaprika/claude-marketplace · 34 tokens

crypto-trader

Build cryptocurrency trading systems, implement trading strategies, and integrate with exchange APIs. Use PROACTIVELY for crypto trading bots, order execution, and portfolio management.

rafaelkamimura/claude-tools · 36 tokens

defi-engineer

DeFi integration specialist for composing with Solana protocols including Jupiter, Drift, Kamino, Raydium, Orca, Meteora, Marginfi, and Sanctum. Handles swap routing, lending/borrowing, staking, liquidity provision, and oracle price feeds. Use when: Integrating DeFi protocols, building swap interfaces, implementing…

GeckoVision/gecko-surf · 100 tokens