Skip to content

The Graph

The Graph indexes blockchain data into GraphQL-queryable subgraphs. It models histories and aggregates while requiring correct transformation rules, indexing progress checks and consistent block references. Applications use those indexes for historical views and verify whether the indexed block is recent enough for each decision. Mappings define how events become queryable entities.

Written by Isaac GonzálezUpdated October 11, 2026

Key takeaways

  • The Graph transforms network data into entities queryable through GraphQL.
  • A subgraph defines indexed events and how results are organized.
  • Applications should account for indexing delays and schema changes.

What is The Graph?

The Graph provides tools and infrastructure for indexing blockchain data and querying it through GraphQL. A subgraph defines how network information becomes entities an application can query. This supports histories, filters and relationships that would be costly to reconstruct through RPC for every request.

An index is a derived representation of the chain. Its value depends on correct transformation rules and indexing progress. A GraphQL response does not establish that data reflects the latest block or replace state checks before preparing a critical transaction or business decision.

How it works

Subgraphs include a manifest defining sources and handlers, an entity schema and mappings commonly written in AssemblyScript. Handlers process information and update entities. Configuration defines the starting block and how events relate to stable identifiers across the resulting data model.

Graph Node is primarily implemented in Rust. Infrastructure can be self-operated or accessed through ecosystem services according to deployment needs. Network coverage and capabilities should be checked for the selected destination; historical chain lists do not establish support across every publishing or hosting option.

What The Graph offers

A deposit history can retain individual movements and account-level aggregates. Applications query result pages and show transaction references for investigating discrepancies. Identifiers prevent collisions between events within one transaction and link entities without depending on their visual order in the interface.

Queries can include indexing-block and error information. Products should decide when delayed data is acceptable and when to indicate that a view is stale. Reproducible analysis benefits from a shared block reference across queries that are expected to describe the same state of the protocol.

Limitations and selection criteria

Mappings have execution and determinism constraints; they are not arbitrary backends that query private APIs and perform any background work. Combining sensitive business logic with external data may call for a custom indexer or complementary architecture with clearly defined responsibilities.

Schema or mapping changes can require rebuilding the index and updating consumers. Budgets include queries, indexing and operations under the chosen deployment model rather than a universal fee. Selection depends on data shape, tolerable latency and the ability to detect incomplete or stale results.

Also known as

  • Subgraph
  • GRT
  • Graph Protocol
Development at Metlabs

How we approach a project with The Graph

Development capabilities and use cases to assess how The Graph fits your product.

What we build with The Graph at Metlabs

  • Custom subgraphs

    Subgraph development indexing exactly the events and entities your dApp needs.

  • Frontend GraphQL integration

    Typed queries from React/Next.js with codegen to avoid schema mismatches.

  • Use case

    dApp transaction history

    Selected event history with filters, pagination and indexing-block references.

  • Use case

    Protocol metrics dashboard

    Subgraph feeding a protocol leaderboard or dashboard in near real-time, with no database of our own to maintain.

Related content

Go deeper on The Graph

Other Metlabs pages that expand on this entry.

Need to integrate The Graph?

We analyze your case, pick the right stack and ship a production-ready solution.

Tell us about your project

As featured in

CointelegraphInvesting.comEl EspañolEmprendedoresEl ObservadorCriptoNoticias