Block ForestDeFi intelligence tools
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 KeyView Docs
Built for structured DeFi data
Deterministic indexing
Transparent data freshness
Structured, protocol-aware models
Data Architecture

Raw onchain data is public,
but not product-ready.

Indexing blockchain events is just the first step. The real challenge is interpretation. We turn raw Uniswap v4 logs into structured, protocol-aware data so your team can focus on building UX, not fighting data semantics.

04

Intelligence Layer

Future Vision

Higher-level analytics turn semantic data into insights such as P&L, impermanent loss, accrued fees, position performance, and strategy signals.

03

Semantic Product Data

Current Beta Focus

LP intelligence exposes structured, protocol-aware API responses that products can use directly—like canonical position identities and wallet ownership.

02

Indexed Protocol Data

Block Forest decodes, normalizes, and links protocol-specific records across pools, tokens, swaps, and positions.

01

Raw Blockchain Data

Public onchain activity exists as fragmented transactions, logs, events, and contract state.

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. Indexed Uniswap v4 data with structured, protocol-aware models and transparent indexed_to_block / indexed_at metadata on every list response.

Account-level data

Swap history filtered by transaction initiator (tx.from), and position NFTs currently owned by the address (ownership + identity + pool/token metadata).

Available endpoints:
  • GET /api/v1/uniswap-v4/accounts/{address}/swaps
  • GET /api/v1/uniswap-v4/accounts/{address}/positions
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 — live API access to indexed Uniswap v4 pool registry and related datasets.
  • Every list response includes an indexing boundary: indexed_to_block (highest block in the snapshot) and indexed_at (when indexing reached that block).
  • Use these fields to reason about coverage — do not assume they match the current chain head.
  • Near real-time ingestion is on the roadmap; the demo dashboard shows the current pool-registry watermark inline.

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/accounts/{address}/positions
  • GET /api/v1/uniswap-v4/tokens
  • GET /api/v1/chains
In progress
  • Demo dashboard
  • GET /api/v1/uniswap-v4/positions/{position_id}/fees
  • Near real-time ingestion (<10 min freshness target)
Planned
  • Position-level impermanent loss analytics
  • PnL layer
  • Multi-protocol expansion

Request API access

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

Prefer email? rafael@block-forest.org

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