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 should I choose?
If you're exploring, start with Free. Building an app? Essential or Developer gives you API keys and higher limits. Running a team? The Team plan adds multi-member workspaces and higher throughput. For custom infrastructure, dedicated support, and SLAs, go with Premium or contact us about a custom solution. See Pricing for a full comparison.
How do I get my first API key?
- Create an account at the Hgraph App
- Create an organization and project
- Go to API Keys in the sidebar and click Create API Key
- Copy your Publishable Key (
pk_prod_) or Secret Key (sk_prod_)
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 that allows interaction with the Hedera EVM for executing smart contract functions. 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. "Playground" access lets you query this data in the Hgraph App. "API" access (Team and Premium) lets you query it programmatically via your API keys. Learn more.
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 Code | Meaning | Solution |
|---|---|---|
| 401 | Unauthorized | Check if your API key is correct. |
| 403 | Forbidden | Ensure your plan includes the requested endpoint. |
| 429 | Too Many Requests | Implement exponential backoff and retry. |
| 500 | Server Error | Check Hgraph's status or try again later. |
Network Support
What networks does Hgraph support?
Hedera is fully supported across all plan tiers. Ethereum data support is coming soon with early access available now.
Hgraph operates bare-metal Hedera mirror nodes for reliable, low-latency data access. The platform is designed for multi-chain support, and additional networks will be added without requiring changes to your integration. Learn more about Hedera.
Is Ethereum data available?
Early access is available now for select use cases. Read the announcement for details on what's included and how to get access.
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. Annual billing saves 15%. You can upgrade, downgrade, or cancel at any time from the Hgraph App. Changes take effect on your next billing cycle.
What does Max RPS mean?
The maximum number of requests per second your plan supports. Requests exceeding this rate are throttled. Higher-tier plans include higher RPS limits for production workloads.
Can I switch plans or billing period?
Yes. You can upgrade, downgrade, or switch between monthly and annual billing at any time from the Hgraph App. Changes take effect on your next billing cycle. No lock-in on any plan.
What happens if I exceed my plan limits?
Paid plans have soft caps, so temporary spikes are fine. If you consistently exceed your limits, additional usage may be metered. Free tier requests are rate-limited at 1 request per second.
What's the difference between Platform and Solutions?
Platform is self-serve API access with tiered pricing. You sign up, get an API key, and start querying. Solutions are custom engineering engagements where our team designs, builds, and operates blockchain infrastructure for your architecture. Many clients start on the platform and add solutions as they scale. Learn more.
How do I update or cancel my plan?
Log in to the Hgraph App and navigate to billing. Manage your subscription through the Stripe billing portal.
Solutions & Support
What custom solutions does Hgraph offer?
Dedicated engineering for teams building production systems on blockchain networks:
- Cross-Chain Infrastructure - Multi-chain protocol infrastructure under one architecture
- Backend Operations - Reliable backend services, clean releases, and real accountability
- Data & Indexing - Custom data pipelines on infrastructure that doesn't go down
- Analytics & Observability - Monitoring, dashboards, and alerts across your protocol
- Product & Design - Design system components, tokens, and UI foundations
- AI Agents - Direct blockchain data access for agents without custom integration
Hgraph can also function as an extension of your engineering team. Engagements follow a four-phase model: Build, Stabilize, Operate, and Transition. Explore Solutions.
What support and SLAs are available?
Free and Essential plans include community support through Discord. Developer and Team plans add direct email support. Premium includes a dedicated support channel with priority response times and an SLA.
Custom solution clients receive priority support, dedicated communication channels, 99.9%+ uptime SLAs, and dedicated infrastructure. Specifics are scoped per engagement.
How do I get support?
- Discord community - Community support and discussion
- Support page - Hours, contact info, and ticket process
- Email: support@hgraph.com - Direct support for paid customers
How do I book a demo?
Schedule a 30-minute call to see the platform live and discuss how Hgraph fits your stack.