Documentation

Quick reference for monitoring methodology, the public API, and embeddable badges.

Methodology

dapp.observer runs scheduled check cycles from a Cloudflare Worker. Each cycle probes the frontend URL, executes configured smart-contract read calls, and polls JSON-RPC endpoints for chain heads. Results land in D1 and are aggregated into 90-day rolling uptime metrics.

Public API

All monitoring data is exposed as a read-only JSON API. No auth required for v1. Endpoints follow /api/<resource>:

  • GET /api/dapps — list dApps (filters: category, chain, status)
  • GET /api/dapps/[slug] — single dApp + latest check
  • GET /api/dapps/[slug]/uptime — uptime series (24h/7d/30d/90d)
  • GET /api/dapps/[slug]/incidents — incident history
  • GET /api/chains — latest chain health (7 chains)
  • GET /api/leaderboard — weighted uptime ranking

Status badges

Embed a live status badge for any dApp:

[![Status](https://dapp.observer/api/status/uniswap)](https://dapp.observer/dapp/uniswap)

Or as HTML: <img src="https://dapp.observer/api/status/uniswap" alt="status">

Full reference

For the complete API reference, monitoring internals, and data schemas, see the canonical docs repository:

github.com/dapp-observer/docs →