Effortless Migration with Subgraph-Compatible GraphQL Queries

4 min readOct 4, 2024

Today we’re introducing a new feature designed to simplify the migration process for developers moving from The Graph to SubQuery: the Subgraph-Compatible GraphQL Query Service!

We know a lot of users are making the switch from The Graph to SubQuery, attracted by the benefits of faster indexing (3.9x faster), enhanced performance, and greater flexibility that our platform provides. It’s a goal of ours to make this migration as seamless as possible and this new Subgraph-compatible query service will help make it a breeze.

Why SubQuery?

Developers migrating from The Graph to SubQuery can take advantage of faster indexing speeds, better control over their data, and improved scalability. The move allows projects to efficiently query on-chain data without sacrificing speed or performance.

Our platform offers a more intuitive and developer-friendly approach to data indexing, allowing for more streamlined and future-proof dApp development. Learn more about the benefits of migrating to SubQuery here.

GraphQL: Compatible with Standard Subgraph Query Services

The default way to query SubQuery projects is through the excellent GraphQL Query service. GraphQL is a widely used, industry-standard API language that allows developers to request only the specific data they need, making it faster and easier to build applications on top of indexed data.

However, to make the transition from The Graph to SubQuery even easier, we’ve launched a new query service that is compatible with the standard query service used by Subgraphs.

SubQuery’s Dual Query Services

We now offer two query services to provide maximum flexibility for developers:

SubQuery Native Query Service (@subql/query): This is our high-performance, native query service designed specifically for SubQuery projects, offering fast and efficient data access.
Subgraph-Compatible Query Service (@subql/query-subgraph): This new service allows developers to use the same API they already used with their Subgraphs. This compatibility is key to a smooth migration, as developers can move their Subgraphs to SubQuery without needing to immediately update their client applications.

Why Use the Subgraph-Compatible Query Service?

The Subgraph-Compatible Query Service was created to make migrations seamless. For developers moving their Subgraphs to SubQuery, the new service means you can continue using the familiar API calls you’re used to. This significantly reduces the complexity of the migration process and allows you to transition at your own pace.

Familiar API: Developers migrating to SubQuery can use the same API they were previously using with Subgraphs, eliminating the need for immediate client app updates.
Incremental Migration: With both the native SubQuery service and the Subgraph-compatible service available, developers have the flexibility to migrate incrementally. Start by using the Subgraph-compatible service, then switch to SubQuery’s native query service when you’re ready to unlock its full potential.

We still recommend the SubQuery native query service for more features such as GraphQL subscriptions and Aggregate Functions, but for ease of migration you may want to temporarily use the Subgraph compatible query service.

The Power of GraphQL

Both our query services use GraphQL, an industry-standard API language. GraphQL allows developers to specify exactly what data they need, reducing over-fetching and speeding up app performance. By sticking to this powerful, familiar pattern, we ensure that building apps on top of your indexed data is both fast and easy.

Get Started with the New Service

The new Subgraph-Compatible GraphQL Query Service is now available and ready for use. This feature is designed to make your migration experience smooth and straightforward, letting you focus on building amazing applications without being bogged down by technical changes.

To dive deeper into this new feature and see how you can leverage it in your projects, visit our detailed guide here.

Ready to make the switch? SubQuery is here to support your journey, reach out if you need any help with the process.

Explore what’s possible with SubQuery today!

About SubQuery

SubQuery Network is innovating web3 infrastructure with tools that empower builders to decentralise the future — without compromise. Our flexible DePIN infrastructure network powers the fastest data indexers, the most scalable RPCs, innovative Data Nodes, and leading open source AI models. We are the roots of the web3 landscape, helping blockchain developers and their cutting-edge applications to flourish. We’re not just a company — we’re a movement driving an inclusive and decentralised web3 era. Let’s shape the future of web3, together.