GraphQL API Overview

Hgraph provides GraphQL API endpoints for accessing our Hedera mirror node and various subscription plans for production access (including free access for experimenting). If you're new to GraphQL, the official documentation is a good starting point.

What is the GraphQL API?

GraphQL is a query language for APIs that allows precise data fetching with a single endpoint, reducing unnecessary data transfer. Its strong type system enables efficient, flexible queries and real-time updates, making it ideal for complex web and mobile applications. This self-documenting approach simplifies development, allowing for rapid frontend changes without backend adjustments, streamlining the creation of responsive, data-driven applications.

Hgraph AI Data Agent

Explore Hedera data with natural language—no coding required. Powered by the Hgraph MCP Server. Try it free →

GraphQL vs REST

REST APIs use multiple endpoints and standard HTTP methods, with the server determining the data returned to the client, which can lead to over-fetching or under-fetching of data. In contrast, GraphQL uses a single endpoint and allows clients to specify exactly what data they need through a query language, reducing unnecessary data transfer. While GraphQL can present challenges in caching and tooling for developers, Hgraph addresses these issues by providing solutions that simplify caching and offer robust tooling, making GraphQL more accessible and efficient.

Finding your way around the schema

The Schema Reference lists every queryable table with its columns, types, and the plan it requires — 105 tables across 8 schemas.

For interactive exploration, the playground in the Hgraph App introspects the live schema, including the relationships between tables.

Start from Common Queries for worked examples, and Data Formats for how entity IDs, timestamps, and amounts are represented.

Specialized Data Access

For comprehensive ERC-20 and ERC-721 token data on Hedera, see our dedicated ERC Token Data section which provides specialized queries and schemas for pure ERC token contracts.