Skip to main content

FAQ

Common questions about the Hgraph platform. Can't find what you're looking for? Contact us or join our Discord community.

Getting Started​

How do I create an account?​

Go to app.hgraph.com and sign in with GitHub, Google, or email. No passwords required. If this is your first time signing in, an account is created automatically.

Which plan do I need?​

Technically it comes down to three things: the requests-per-second and monthly budget you need, whether you need GraphQL subscriptions (Developer and above), and whether you need ERC or protocol data through your API keys rather than the playground (Team and above). See Rate Limits & Quotas for the numbers, and the schema reference for which tables each plan reaches.

How do I get my first API key?​

  1. Create an account at the Hgraph App — an organization, a project, and an API key are created for you automatically
  2. Go to Projects in the sidebar and open your project
  3. Click the eye icon on the API key to reveal its values, then click a copy icon

Both values a key carries (pk_prod_ and sk_prod_) grant the same access, so treat both as secrets and keep them server-side.

See the Getting Started guide for a full walkthrough.

What is an organization and project?​

When you create an Hgraph account, you set up an organization. Within your organization, you create projects, each with their own API keys and usage tracking. Members are users you invite to your organization. The Team and Premium plans support multiple projects, keys, and members for collaborative workflows. See Workspace for details.

Using the Platform​

What APIs are available?​

Hgraph provides access to blockchain data through multiple interfaces. Core APIs are available on every plan including the free tier:

  • GraphQL API - Flexible queries and real-time subscriptions
  • REST API - Standard RESTful endpoints
  • JSON-RPC Relay - EVM-compatible interface
  • WebSocket Subscriptions - Real-time event streams (Developer+)
  • Hgraph SDK - Client libraries for TypeScript

What is the GraphQL API?​

A query language that allows precise data fetching from a single endpoint with real-time subscriptions via WebSocket. Ideal for complex queries where you need to control exactly what data is returned. Learn more.

What is the REST API?​

Standard RESTful endpoints using HTTP methods (GET, POST, PUT, DELETE) for retrieving blockchain network data. Best for simple, structured data retrieval. Learn more.

What is JSON-RPC?​

An EVM-compatible interface for executing smart contract functions, served across Hedera and 20+ EVM networks. Uses the standard Ethereum JSON-RPC specification. Learn more.

How do I authenticate API requests?​

Hgraph supports multiple authentication methods:

  • Authorization header - Include your API key as a Bearer token
  • X-API-KEY header - Pass your API key directly
  • Path-based - Include your API key in the URL path

See Endpoints & Authorization for full details and code examples.

What is Real-Time Streaming?​

GraphQL subscriptions via WebSockets, allowing your application to receive live updates as data changes on the network. Available on Developer plans and above. Learn more.

What is ERC and Ecosystem data access?​

Enriched token and protocol data beyond standard mirror node queries — the ERC indexer plus the DEX, lending, oracle, and bridge schemas. On Free, Essential, and Developer you can query it in the Hgraph App playground; Team and Premium reach it programmatically with your API keys. Learn more.

Hedera Stats metrics are not part of this gate — the ecosystem tables are readable on every plan, including Free, through both the GraphQL and REST APIs. See Hedera Stats.

How do I handle rate limits?​

Each plan has a Max RPS (requests per second) limit. If you exceed your limit:

  • Optimize queries (GraphQL allows fetching only required data)
  • Batch requests to reduce API calls
  • Upgrade to a higher-tier plan for more throughput

Hgraph also enforces a 10-second timeout on API calls. Requests exceeding this are cancelled. Contact support@hgraph.com if you need accommodation.

What are common API errors and how do I fix them?​

Error CodeMeaningSolution
401UnauthorizedCheck if your API key is correct.
403ForbiddenEnsure your plan includes the requested endpoint.
429Too Many RequestsImplement exponential backoff and retry.
500Server ErrorCheck status.hgraph.com or try again later.

Network Support​

What networks does Hgraph support?​

JSON-RPC is live on Hedera and 20+ EVM networks — Ethereum, Base, Optimism, Arbitrum, Polygon, Avalanche, BNB Smart Chain, Celo, and more. Indexed GraphQL covers Hedera in production and Ethereum in beta. REST serves the Hedera mirror node API. Every network is available on all plan tiers, including the free tier.

Hgraph operates bare-metal mirror nodes and EVM nodes for reliable, low-latency data access. New networks are added without requiring changes to your integration — one API key works across all of them. See Endpoints & Authorization for the current list.

Is Ethereum data available?​

Yes. JSON-RPC is live at https://ethereum.hgraph.com/rpc, and indexed GraphQL is in beta at https://ethereum.hgraph.com/beta/graphql. See Endpoints & Authorization.

What is the Token Indexer?​

ERC token balances, transfers, metadata, and NFT ownership from a single endpoint. Discovers contracts automatically and normalizes Hedera IDs, EVM aliases, and hollow accounts. Learn more.

What are mirror nodes?​

Mirror nodes process and store historical transaction data, enabling applications to access and analyze network activity. Hgraph operates bare-metal mirror nodes for reliable data access. Learn more.

Pricing & Billing​

How does billing work?​

Plans are billed monthly or annually through Stripe, and you can upgrade, downgrade, or switch billing period at any time from the Hgraph App. Changes take effect on your next billing cycle, and there is no lock-in on any plan. See hgraph.com/pricing for current prices.

What does Max RPS mean?​

The maximum number of requests per second your plan supports, enforced per API key across every network and API. Requests beyond it are throttled with a 429. See Rate Limits & Quotas.

What happens if I exceed my plan limits?​

Paid plans have soft caps, so temporary spikes are fine. Sustained overage may be metered. Free tier requests are limited to 1 per second.

How do I update or cancel my plan?​

Go to Billing in the Hgraph App and open the Stripe customer portal.

Support​

What support is available?​

Free and Essential include community support through Discord. Developer and Team add direct email support. Premium includes a dedicated support channel with priority response times and an SLA.

How do I get support?​