API & Dashboard¶

This section covers the two public consumption surfaces of the platform:

REST API -- Programmatic access to 500+ endpoints across 11 categories with tiered authentication
Dashboard -- Interactive metrics dashboard at metrics.gnosischain.com

Looking for the AI tooling?

The MCP Server — 190+ tools for AI assistants to query ClickHouse, explore dbt models, and generate visualizations — has its own section.

API Reference¶

The Gnosis Analytics API provides programmatic access to blockchain analytics data for Gnosis Chain. It is built with FastAPI and backed by ClickHouse, with endpoints auto-generated from the dbt manifest.

Base URL¶

https://api.analytics.gnosis.io/v1

All endpoint paths are prefixed with /v1. For example, the full URL for the daily blob commitments endpoint is:

https://api.analytics.gnosis.io/v1/consensus/blob_commitments/daily

Key Features¶

Metadata-driven: Endpoints are automatically generated from dbt model tags and meta.api configuration. No custom Python code is needed to expose new data.
Tiered access control: Four access tiers (tier0 through tier3) with hierarchical permissions. Public endpoints require no API key.
Dual query interface: Supports both GET requests with query parameters and POST requests with JSON bodies for complex filters.
Auto-generated documentation: OpenAPI (Swagger UI) and ReDoc documentation are generated automatically and always reflect the current endpoint catalog.
Automatic endpoint discovery: The API periodically refreshes its route registry from the dbt manifest, so new dbt models become API endpoints without redeployment.

Interactive Documentation¶

Explore all endpoints interactively:

Swagger UI: https://api.analytics.gnosis.io/docs
ReDoc: https://api.analytics.gnosis.io/redoc

API Sections¶

Section	Description
Authentication	API key setup, tier hierarchy, and access control
Endpoints	URL conventions, categories, granularities, and tag mapping
Metrics Explorer	Searchable catalog of every endpoint
Endpoint Catalog	Per-category reference with columns and filters
Filtering & Pagination	Query parameters, POST bodies, operators, and pagination
Rate Limits	Per-tier rate limits and throttling behavior
Swagger UI	Interactive API documentation
Error Handling	HTTP status codes, error response format, and common scenarios
Changelog	Notable changes to the API surface

Quick Example¶

Fetch the latest blob commitment data (no API key required):

curl -s "https://api.analytics.gnosis.io/v1/consensus/blob_commitments/latest" \
  -H "accept: application/json"

Fetch daily token balances with filters (requires tier1 key):

curl -s "https://api.analytics.gnosis.io/v1/execution/token_balances/daily?symbol=GNO&start_date=2024-01-01&limit=50" \
  -H "accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"