Public Beta

Structured Uniswap v4 data API

Protocol-aware liquidity and market data for teams integrating Uniswap v4 — without building custom indexing infrastructure.

Spend days integrating, not months building data pipelines.

Get API Key View Docs

Built for structured DeFi data

Deterministic indexing

Transparent data freshness

Structured, protocol-aware models

API example

Real response shape from the pools endpoint in the current public beta.

GET /api/v1/uniswap-v4/pools?chain_id=1&limit=50

{
  "indexed_to_block": 24400625,
  "indexed_at": "2026-02-06T21:59:47Z",
  "items": [
    {
      "chain_id": 1,
      "pool_id": "0x8c33f49865ae825f0829d1766b651857495e05ddcabfa8df2331fdf959465cc2",
      "pool_manager": "0x000000000004444c5dc75cb358380d2e3de08a90",
      "fee": 10000,
      "tick_spacing": 200,
      "hooks": null,
      "created_block": 24400625,
      "created_timestamp": "2026-02-06T21:59:47Z",
      "token0": {
        "address": "0x00c83aecc790e8a4453e5dd3b0b4b3680501a7a7",
        "symbol": "SKL",
        "decimals": 18,
        "name": "SKALE"
      },
      "token1": {
        "address": "0xe41d2489571d322189246dafa5ebde1f4699f498",
        "symbol": "ZRX",
        "decimals": 18,
        "name": "0x Protocol Token"
      }
    },
    {
      "chain_id": 1,
      "pool_id": "0xb0fab1cccd66c7e95d8ad92020958d8bf4537db29bccaecf06b86e5109d372ee",
      "pool_manager": "0x000000000004444c5dc75cb358380d2e3de08a90",
      "fee": 500,
      "tick_spacing": 10,
      "hooks": null,
      "created_block": 24400567,
      "created_timestamp": "2026-02-06T21:48:11Z",
      "token0": {
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "decimals": 18,
        "name": "Ether"
      },
      "token1": {
        "address": "0x467b0dca723c4526f03e4dc9d8039424ee59428f",
        "symbol": "USDT",
        "decimals": 6,
        "name": "Tether"
      }
    },
    {
      "chain_id": 1,
      "pool_id": "0xaf290842a7b24381ee2454af514129b6bc0b203930ab49b63d26b077c342ff56",
      "pool_manager": "0x000000000004444c5dc75cb358380d2e3de08a90",
      "fee": 870000,
      "tick_spacing": 17400,
      "hooks": null,
      "created_block": 24400481,
      "created_timestamp": "2026-02-06T21:30:59Z",
      "token0": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "symbol": "USDC",
        "decimals": 6,
        "name": "USD Coin"
      },
      "token1": {
        "address": "0xd9c2d319cd7e6177336b0a9c93c21cb48d84fb54",
        "symbol": "HAPI",
        "decimals": 18,
        "name": "HAPI"
      }
    }
  ],
  "next_cursor": "example_cursor_here",
  "limit": 50
}

Current beta API surface

Public beta, read-only. Historical indexing available with structured, protocol-aware data models and transparent freshness metadata.

Account-level swap history

Query indexed swap activity for a given EVM address — filtered by transaction initiator (tx.from).

Available endpoints:

GET /api/v1/uniswap-v4/accounts/{address}/swaps

Pool-level market activity

Access indexed pools and structured swap streams per pool.

Available endpoints:

GET /api/v1/uniswap-v4/pools
GET /api/v1/uniswap-v4/pools/{pool_id}/swaps

Structured reference data

Token metadata for tokens observed in indexed Uniswap v4 pools, and supported chain metadata.

Available endpoints:

GET /api/v1/uniswap-v4/tokens
GET /api/v1/chains

Who it’s for

Built for teams shipping DeFi products and analytics — without rebuilding indexing from scratch.

DeFi dashboards & frontends

Render pool data, swap history, token metadata, and chain info without maintaining custom indexing infrastructure.

Analytics & research teams

Work with structured, protocol-aware Uniswap v4 data instead of raw on-chain events.

Backend systems & internal tools

Use stable API responses for product logic, internal services, and data workflows.

Teams evaluating Uniswap v4

Explore structured market activity and pool data through a simpler integration surface.

Indexing status & data transparency

Public beta with historical indexing available.
Current beta coverage is historical and not yet continuously updated — the dataset is indexed up to a fixed block boundary.
Near real-time ingestion is planned but not yet enabled.
Every response includes indexing metadata: indexed_to_block, indexed_at. Clients should rely on these fields rather than assuming real-time freshness.

Roadmap

A concrete view of what is already available in the beta, what is currently in progress, and what comes after.

Live now

GET /api/v1/uniswap-v4/pools
GET /api/v1/uniswap-v4/pools/{pool_id}/swaps
GET /api/v1/uniswap-v4/accounts/{address}/swaps
GET /api/v1/uniswap-v4/tokens
GET /api/v1/chains

In progress

GET /api/v1/uniswap-v4/accounts/{address}/positions
GET /api/v1/uniswap-v4/positions/{position_id}/fees

Planned

Position-level impermanent loss analytics
PnL layer
Near real-time ingestion
Multi-protocol expansion

Request API access

Request access to the public beta. We’ll email you an API key and onboarding details.

We'll only use your email for beta access, onboarding, and relevant product updates. If you prefer email: rafael@block-forest.org