grimoire-uniswap

Retrieve Uniswap router, token, and pool metadata via the Grimoire venue CLI.

6|2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/franalgaba/grimoire --skill grimoire-uniswap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grimoire-uniswap
Source: https://github.com/franalgaba/grimoire/tree/main/skills/grimoire-uniswap
Command: npx skills add https://github.com/franalgaba/grimoire --skill grimoire-uniswap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a reproducible, CLI-driven way to discover Uniswap router addresses, adapter metadata, token and pool listings, and to generate spell-ready snapshots so users and agents do not need to perform manual, error-prone lookups across subgraphs and on-chain factories.

Core Features & Use Cases

  • Adapter and Router Discovery: Inspect adapter metadata and enumerate router addresses per chain for integration and configuration.
  • Token and Pool Lookup: Query token lists and find pools for token pairs using The Graph or on-chain factory fallbacks with filtering by fee tier and chain.
  • Snapshot Generation: Emit params blocks in spell format for tokens or pools to support agent workflows, reproducible automation, and CI-driven deployments.

Quick Start

Use the Grimoire venue uniswap tokens-snapshot command to emit a spell-ready params block for a specified token on a target chain.

Frequently Asked Questions about grimoire-uniswap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve Uniswap router and pool metadata across multiple chains?

You can retrieve Uniswap router and pool metadata across chains by using the Grimoire venue CLI to query subgraphs with a GRAPH_API_KEY or falling back to on-chain RPC factory lookups to enumerate addresses and token pairs.

How do I generate spell-ready snapshots for Uniswap tokens and pools?

To generate spell-ready snapshots for Uniswap tokens and pools, use the tokens-snapshot CLI command, which emits params blocks in spell format while enforcing required fee_tier and swap constraints for accurate automation outputs.

Can I query Uniswap pool data without a The Graph API key?

Yes, you can query Uniswap pool data without a The Graph API key by providing an RPC_URL or passing a --rpc-url flag, allowing the system to fall back to direct on-chain factory lookups for adapter discovery.

What is needed to filter Uniswap pools for snapshot generation?

Filtering Uniswap pools for snapshot generation requires specifying the fee_tier and related swap constraints, ensuring the emitted spell-ready JSON outputs match exact token pair and chain parameters.

Why does my Uniswap subgraph query fail during adapter discovery?

Uniswap subgraph queries may fail during adapter discovery if the GRAPH_API_KEY is missing or invalid, causing the system to rely on RPC_URL factory fallbacks to retrieve router addresses and pool metadata.

Does the Grimoire venue CLI support listing token pairs for Uniswap pools?

Yes, the Grimoire venue CLI supports listing token pairs for Uniswap pools by querying token lists and finding pools for specific pairs, using either subgraph queries or on-chain factory fallbacks with fee tier filtering.