Public Beta

DeFi Liquidity Intelligence API

Structured liquidity and market data for DeFi protocols — so you can ship products without building indexing infrastructure.

Spend days integrating, not months building data pipelines.

Get API Key View Docs

Built for DeFi data reliability

Deterministic indexing

Transparent data freshness

Structured, protocol-aware models

API example

Real response shape from the wallet positions endpoint in the current MVP.

GET /api/v1/wallets/0x00.../positions?chain_id=1&limit=50

{
  "indexed_to_block": 21955247,
  "indexed_at": "2025-03-01T23:16:47Z",
  "items": [
    {
      "chain_id": 1,
      "owner": "0xbd216513d74c8cf14cf4747e6aaa6420ff64ee9e",
      "initiator": "0x93c231b64a2b1546fadab54bc9a10e244deb99c8",
      "pool": {
        "pool_id": "0xfa86f15833604c1ee16f0a2f7de9d04d244fd9248a3ffe71220f7718f21871fe",
        "pool_manager": "0x000000000004444c5dc75cb358380d2e3de08a90",
        "token0": {
          "address": "0x6111f3e70fbe68c8d62c3340b32e978ddfd8b08a",
          "symbol": "SETH",
          "decimals": 18,
          "name": "Sethereum"
        },
        "token1": {
          "address": "0xdb99b0477574ac0b2d9c8cec56b42277da3fdb82",
          "symbol": "DECT",
          "decimals": 18,
          "name": "DEC Token"
        },
        "fee": 100,
        "tick_spacing": 1,
        "hooks": null
      },
      "tick_lower": -887272,
      "tick_upper": 887272,
      "salt": "0x00000000000000000000000000000000000000000000000000000000000013ec",
      "liquidity": "30000000000000000001626363"
    }
  ],
  "next_cursor": null,
  "limit": 50
}

Current API surface

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

Wallet-level liquidity & swap history

Query indexed LP positions and swap activity for a given address.

Available endpoints:

GET /api/v1/wallets/{address}/positions
GET /api/v1/wallets/{address}/swaps

Pool-level market activity

Access indexed pools and structured swap streams per pool.

Available endpoints:

GET /api/v1/pools
GET /api/v1/pools/{pool_id}/swaps

Structured reference data

Canonical token and chain metadata aligned with indexed protocol data.

Available endpoints:

GET /api/v1/tokens
GET /api/v1/chains

Position-level fee state

Query fee accrual state for individual LP positions.

Available endpoint:

GET /api/v1/positions/{position_id}/fees

Who it’s for

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

DeFi dashboards & frontends

Render LP positions, swap history, and pool data without running or maintaining custom indexing infrastructure.

Vault & strategy builders

Integrate canonical liquidity and fee state directly into automated strategy logic.

Analytics & research teams

Work with structured, protocol-aware LP datasets instead of raw on-chain events.

Internal data platforms

Standardize DeFi ingestion across teams without bespoke ETL per protocol.

Indexing status & data transparency

Public beta with historical indexing available.
Data freshness currently ~60 minutes (near real-time ingestion planned).
Every response includes indexing metadata: indexed_to_block, indexed_at.

Roadmap

Phase 1 — Indexed Data Layer

Structured liquidity primitives: positions, swaps, pools, and fee state. Historical indexing with transparent metadata.

Phase 2 — Real-Time & Access Control

Near real-time ingestion, API key management, rate limits, and usage-based access tiers.

Phase 3 — Liquidity Intelligence Layer

LP profitability engine (PnL, IL, gas), webhooks, batch endpoints, and multi-protocol expansion.

Request API access

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

No spam — only product updates and onboarding. If you prefer email: hello@blockforest.xyz