PoolScout Otter Mascot

PoolScout

Dive into Uniswap V4 Pool Discovery

Find pools, track hooks, and discover opportunities on Base chain. Fast, simple API for developers and agents.

Get StartedView API Docs
10k+
Pools Indexed
<50ms
API Response Time
Base
Network Supported

What is PoolScout?

PoolScout is a fast, reliable API for discovering Uniswap V4 pools and liquidity on Base chain. We index every pool creation event in real-time, so AI agents can instantly find available liquidity by token, hook, or pool ID.

Built for AI agents and autonomous systems that need instant liquidity discovery without running their own indexer. Enable your agents to find trading opportunities, route swaps efficiently, and discover new pools as they're created.

⚡

Lightning Fast

<50ms API response times. New pools indexed within 30 seconds.

🔍

Complete Discovery

Find pools by token, hook address, or pool ID. Full hook registry included.

🌊

Always Fresh

Real-time indexing from Base mainnet. Never miss a new pool.

API Documentation

Simple REST API with JSON responses. No authentication required (for now). Start querying pools in seconds.

GET/health

Check API health and get pool count

RESPONSE
{
  "status": "ok",
  "pools_indexed": 10234
}
GET/pools/by-token/:address

Find all pools containing a specific token (as currency0 or currency1)

Parameters:

address(string)- Token address (0x + 40 hex chars)
REQUEST
GET /pools/by-token/0x4200000000000000000000000000000000000006
RESPONSE
{
  "pools": [
    {
      "pool_id": "0x60e9425d...",
      "currency0": "0x4200000000000000000000000000000000000006",
      "currency1": "0x9748e49c6dc4faaee7e9945008fb6804040e4ba3",
      "fee": 8388608,
      "tick_spacing": 200,
      "hooks": "0xbb7784a4d481184283ed89619a3e3ed143e1adc0",
      "created_block": 42903206
    }
  ],
  "count": 1
}
GET/pools/by-hook/:address

Find all pools using a specific hook contract

Parameters:

address(string)- Hook contract address
REQUEST
GET /pools/by-hook/0xbb7784a4d481184283ed89619a3e3ed143e1adc0
RESPONSE
{
  "pools": [
    "..."
  ],
  "count": 42
}
GET/pools/by-id/:pool_id

Get a specific pool by its unique ID

Parameters:

pool_id(string)- Pool ID (0x + 64 hex chars)
REQUEST
GET /pools/by-id/0x85375c52343d3696fc79fe93f804cd6ed13817ca...
RESPONSE
{
  "pool": {
    "pool_id": "0x85375c52343d3696fc79fe93f804cd6ed13817ca8821fc10fd2e5dc9b60991b3",
    "currency0": "0x07e1d52555ca4eb428cbecbbf1271f07a54fbba3",
    "currency1": "0x4200000000000000000000000000000000000006",
    "fee": 8388608,
    "tick_spacing": 200,
    "hooks": "0xbb7784a4d481184283ed89619a3e3ed143e1adc0",
    "created_block": 42902806,
    "created_timestamp": 1772594959,
    "liquidity": "0",
    "sqrt_price_x96": "0",
    "tick": 0,
    "updated_at": "2026-03-04T03:29:19.739920"
  }
}
GET/hooks/all

List all discovered hook contracts on Base

RESPONSE
{
  "hooks": [
    {
      "address": "0xbb7784a4d481184283ed89619a3e3ed143e1adc0",
      "category": "custom",
      "verified": false,
      "total_pools": 0
    }
  ],
  "count": 1
}

Quick Start

Get started in 30 seconds. No API keys, no setup, no hassle.

1

Make a Request

Just curl or fetch any endpoint. No auth needed.

2

Get JSON Response

Instant results with pool data, hooks, and metadata.

3

Build Amazing Things

Use the data in your DeFi app, bot, or analytics tool.

Find pools by token (e.g., WETH)

bash
curl https://api.poolscout.dev/pools/by-token/0x4200000000000000000000000000000000000006

Find pools by hook address

bash
curl https://api.poolscout.dev/pools/by-hook/0xbb7784a4d481184283ed89619a3e3ed143e1adc0

JavaScript / TypeScript

javascript
const response = await fetch(
  'https://api.poolscout.dev/pools/by-token/0x4200000000000000000000000000000000000006'
)
const data = await response.json()
console.log(`Found ${data.count} pools`)

Python

python
import requests

response = requests.get(
    'https://api.poolscout.dev/pools/by-token/0x4200000000000000000000000000000000000006'
)
data = response.json()
print(f"Found {data['count']} pools")

Base URL

https://api.poolscout.dev

All endpoints are relative to this base URL