Gnosis Analytics Documentation¶

Real-time and historical Gnosis Chain data through REST APIs, AI-powered tools, and interactive dashboards — ingested from chain nodes, network crawlers, and external sources, modeled with dbt, and served through multiple interfaces.

Quick Start API Reference MCP Server

Want to use the API right away? The Quick Start gets you a first call in under a minute — no API key needed for public endpoints. Prefer to understand the platform first? Read the Platform Overview and the Architecture walkthrough.

Data Flow¶

The platform is organized into four layers that form a complete data pipeline from raw blockchain data to consumer-ready APIs and dashboards.

Gnosis Analytics Data Flow

%%{init: {'theme': 'base', 'themeVariables': { 'fontSize': '18px', 'fontFamily': 'Inter, Segoe UI, sans-serif', 'lineColor': '#334155', 'textColor': '#0F172A' }, 'flowchart': { 'nodeSpacing': 40, 'rankSpacing': 70, 'padding': 26, 'subGraphTitleMargin': { 'top': 14, 'bottom': 14 } }}}%%
flowchart TD
    subgraph L1["  DATA ACQUISITION  "]
        direction LR
        EL([Gnosis Chain EL]):::source --> CRYO[cryo-indexer]:::tool
        CL([Gnosis Chain CL]):::source --> BI[beacon-indexer]:::tool
        CL --> ERA[era-parser]:::tool
        EXT([External Data]):::source --> IPC[ip-crawler]:::tool
        EXT --> CR[click-runner]:::tool
        P2P([P2P Network]):::source --> NEB[nebula]:::tool
        COWS([CoW API]):::source --> COWI[cow-indexer]:::tool
        EL --> COWI
        ARCS([Archive RPC]):::source --> RPCI[rpc-state-indexer]:::tool
    end

    subgraph L2["  DATA STORAGE  "]
        CH[(ClickHouse Cloud)]:::storage
    end

    subgraph L3["  DATA MODELING  "]
        DBT[dbt-cerebro]:::modeling
    end

    subgraph L4["  DATA SERVING  "]
        direction LR
        API["cerebro-api"]:::serving ~~~ MCP["cerebro-mcp"]:::serving ~~~ DASH["metrics-dashboard"]:::serving
    end

    CRYO --> CH
    BI --> CH
    ERA --> CH
    IPC --> CH
    CR --> CH
    NEB --> CH
    COWI --> CH
    RPCI --> CH
    CH ~~~ DBT
    CH <--> DBT
    CH --> API
    CH --> MCP
    CH --> DASH

    classDef source fill:#FFFFFF,stroke:#1D4ED8,stroke-width:2px,color:#0F172A,font-weight:700,font-size:16px
    classDef tool fill:#E2E8F0,stroke:#1D4ED8,stroke-width:2px,color:#0F172A,font-weight:700,font-size:16px
    classDef storage fill:#FEE2E2,stroke:#B91C1C,stroke-width:2px,color:#0F172A,font-weight:700,font-size:16px
    classDef modeling fill:#FEF3C7,stroke:#B45309,stroke-width:2px,color:#0F172A,font-weight:700,font-size:16px
    classDef serving fill:#DCFCE7,stroke:#15803D,stroke-width:2px,color:#0F172A,font-weight:700,font-size:16px

    style L1 fill:#EFF6FF,stroke:#1D4ED8,stroke-width:2px,color:#0F172A,font-weight:800,font-size:18px
    style L2 fill:#FEF2F2,stroke:#DC2626,stroke-width:2px,color:#0F172A,font-weight:800,font-size:18px
    style L3 fill:#FFFBEB,stroke:#D97706,stroke-width:2px,color:#0F172A,font-weight:800,font-size:18px
    style L4 fill:#F0FDF4,stroke:#16A34A,stroke-width:2px,color:#0F172A,font-weight:800,font-size:18px

%%{init: {'theme': 'base', 'themeVariables': { 'fontSize': '18px', 'fontFamily': 'Inter, Segoe UI, sans-serif', 'lineColor': '#CBD5E1', 'textColor': '#E2E8F0' }, 'flowchart': { 'nodeSpacing': 40, 'rankSpacing': 70, 'padding': 26, 'subGraphTitleMargin': { 'top': 14, 'bottom': 14 } }}}%%
flowchart TD
    subgraph D1["  DATA ACQUISITION  "]
        direction LR
        ELD([Gnosis Chain EL]):::source --> CRYOD[cryo-indexer]:::tool
        CLD([Gnosis Chain CL]):::source --> BID[beacon-indexer]:::tool
        CLD --> ERAD[era-parser]:::tool
        EXTD([External Data]):::source --> IPCD[ip-crawler]:::tool
        EXTD --> CRD[click-runner]:::tool
        P2PD([P2P Network]):::source --> NEBD[nebula]:::tool
        COWSD([CoW API]):::source --> COWID[cow-indexer]:::tool
        ELD --> COWID
        ARCSD([Archive RPC]):::source --> RPCID[rpc-state-indexer]:::tool
    end

    subgraph D2["  DATA STORAGE  "]
        CHD[(ClickHouse Cloud)]:::storage
    end

    subgraph D3["  DATA MODELING  "]
        DBTD[dbt-cerebro]:::modeling
    end

    subgraph D4["  DATA SERVING  "]
        direction LR
        APID["cerebro-api"]:::serving ~~~ MCPD["cerebro-mcp"]:::serving ~~~ DASHD["metrics-dashboard"]:::serving
    end

    CRYOD --> CHD
    BID --> CHD
    ERAD --> CHD
    IPCD --> CHD
    CRD --> CHD
    NEBD --> CHD
    COWID --> CHD
    RPCID --> CHD
    CHD ~~~ DBTD
    CHD <--> DBTD
    CHD --> APID
    CHD --> MCPD
    CHD --> DASHD

    classDef source fill:#1E293B,stroke:#60A5FA,stroke-width:2px,color:#E2E8F0,font-weight:700,font-size:16px
    classDef tool fill:#2A3A53,stroke:#60A5FA,stroke-width:2px,color:#E2E8F0,font-weight:700,font-size:16px
    classDef storage fill:#4A1F22,stroke:#F87171,stroke-width:2px,color:#FECACA,font-weight:700,font-size:16px
    classDef modeling fill:#4A3814,stroke:#FBBF24,stroke-width:2px,color:#FDE68A,font-weight:700,font-size:16px
    classDef serving fill:#1B3F30,stroke:#4ADE80,stroke-width:2px,color:#BBF7D0,font-weight:700,font-size:16px

    style D1 fill:#132A47,stroke:#60A5FA,stroke-width:2px,color:#DBEAFE,font-weight:800,font-size:18px
    style D2 fill:#3A1B1F,stroke:#F87171,stroke-width:2px,color:#FECACA,font-weight:800,font-size:18px
    style D3 fill:#3F2F13,stroke:#FBBF24,stroke-width:2px,color:#FDE68A,font-weight:800,font-size:18px
    style D4 fill:#163427,stroke:#4ADE80,stroke-width:2px,color:#BBF7D0,font-weight:800,font-size:18px

Explore the Docs¶

Data Ingestion

Indexers and crawlers that feed raw chain, protocol, and external data into ClickHouse.

Data Ingestion
Data Modeling

The dbt-cerebro project, semantic layer, and the ~1,200-model catalog across 14 modules.

Data Modeling
API & Dashboard

REST API with 500+ auto-generated endpoints, plus the public metrics dashboard.

API Reference
MCP Server

190+ AI-assistant tools, ten interactive mini-apps, and multi-phase research workflows.

MCP Server
Research

Measurement methodology (MMM & MTA), protocol deep dives, and ESG reporting.

Research
Developer Guide

Add endpoints, models, scrapers, and protocols to the metadata-driven platform.

Developer Guide
Operations

Infrastructure, deployment, monitoring, and troubleshooting runbooks.

Operations
Reference

Environment variables, glossary, data dictionary, and the Dune query archive.

Reference