Product study · DeFi research tooling
DeFi Pool Research
Research EVM liquidity pools by token address, protocol and chain, using indexed data and on-chain checks.
01 / The task
What needed to work
Token symbols and liquidity metrics can hide which contracts, chains and data sources a report covers. This tool ties each result to an address, protocol and source.
My role
I built the Node.js research CLI, pool inspection and liquidity calculations, with source provenance for each result.
02 / Decisions
Where judgment mattered
Start with indexed pool data
Use indexed results for broad discovery, then make bounded RPC calls to verify selected pools.
Preserve unavailable values
Represent missing history, quotes and liquidity as unavailable values.
Match tokens by contract address
Match tokens by contract address and classify only configured USDC, ETH and WETH addresses as direct quotes.
Handle protocol fee models separately
Handle v3 pools and v4 pool IDs separately, including their fee fields and state.
Track source and observation time
Record the data source and observation time for each backend or RPC result.
03 / Agent contribution
How the work was directed
I use AI coding assistants to build independent projects, while owning product decisions, review and testing.
Owner account · General working method
These product decisions are grounded in the implementation and capture notes. The broader workflow is my account of how I work across these projects.
04 / Verification & result
What the evidence supports
Implemented functionality
- Pool discovery by token address. Find indexed pools for an exact token or pair, filter by chain and compare venue, reserves, volume and turnover.
- Source-aware metrics. Keep missing values distinct from zero, record conflicting prices and show the quote assumptions behind each comparison.
- Uniswap v3 and v4 inspection. Inspect pools by URL or chain-specific ID, then compare fee history, recent transactions and competing pools.
Implementation inspected
The screenshots show demo data, public observations or labelled report presentations, as described in each caption.
05 / Product evidence
Selected screens
Supporting detail
Technology
- Node.js ESM with native fetch
- Dexscreener public API
- Uniswap LiquidityService and Data API
- EVM JSON-RPC
- Uniswap v3/v4 concentrated-liquidity math
- Aerodrome Slipstream discovery and position-manager support