Introduction

In a major leap forward for developer productivity and accessibility, SubQuery is proud to unveil the SubQuery GraphQL Agent. This powerful new AI tool enables users to interact with their indexed blockchain data using plain English.

Gone are the days of writing and debugging complex GraphQL queries. With the SubQuery GraphQL Agent, developers, analysts, and product teams can simply ask questions in natural language and get instant insights from their data - no coding required.

A Smarter Way to Explore Blockchain Data

The GraphQL Agent works with any SubQuery project, whether it's indexing data from Ethereum, Solana, Polkadot, Cosmos, or any supported network. All a user needs is their Project CID and query URL. Once entered, the AI model scans the dataset and prepares it for natural language interactions.

From there, users can ask questions like:

“What are the top token holders over the past 24 hours?”

“How many transfers happened last week?”

“Which accounts interacted with this smart contract most frequently?”

The AI agent understands the context of your indexed data and translates your questions into precise GraphQL queries under the hood - instantly returning answers in real time.

How It Works: Built for Real-World LLM Integration

Unlike traditional solutions, the SubQuery GraphQL Agent was designed from the ground up for seamless use with AI models. Here's how:

• Natural Language Interface: Speak to your data in plain English
• Automatic Schema Understanding: Learns the structure of your SubQuery project using compressed schema representations
• Query Generation & Validation: Generates accurate GraphQL queries and validates them in real time
• Optimised Context Size: Uses a high-density, entity-based schema (100x smaller than standard GraphQL introspection), ensuring fast and cost-effective responses
• OpenAI-Compatible API: Hosted on a FastAPI server with streaming and non-streaming endpoints for smooth LLM integration

Most GraphQL APIs are simply too large and noisy for LLMs to handle effectively. This toolkit solves that with a novel approach: compressing your schema into only the essential entities and relationships, and combining it with PostGraphile v4 patterns for intelligent, pattern-based query construction.

This means faster results, higher accuracy, and significantly lower costs — all while maintaining compatibility with any SubQuery SDK-powered project.

First-of-its-Kind on the Market

When we set out to build this tool, we first searched the market for an AI solution that could sit on top of an existing GraphQL endpoint and translate natural language into meaningful queries, while understanding the unique structure of blockchain datasets. However, we quickly discovered that nothing like this existed. The tools we found either could not handle the SubQuery schema well, thereby being cumbersome and expensive, or required additional access and raised security concerns.

So we eventually decided to build it ourselves by combining SubQuery’s world-class indexing expertise with cutting-edge AI to create a seamless, production-ready agent that speaks the language of blockchain data.

Try the Demo Today

The SubQuery GraphQL Agent is live and ready to test. Visit the demo, input your SubQuery project details, and start querying your data like never before. It's an intuitive experience that reduces the technical barrier to blockchain data analytics and opens up new possibilities for teams across all levels of expertise.

Try the Demo

Built in Partnership with OnFinality

This innovative tool was developed in partnership with OnFinality, our long-time infrastructure collaborator. Their robust infrastructure and AI hosting capabilities helped bring the SubQuery GraphQL Agent to life.

Soon, OnFinality will offer a fully managed AI Agent hosting service, allowing teams to deploy their own SubQuery-powered community agents (like on Discord) in just a few clicks. 

OnFinality AI Agents can also integrate additional sources like your website, documentation, and live blockchain calls - giving them all the context they need to provide accurate, helpful responses.

Register Your Interest for Updates

Common Questions

1. What is the SubQuery GraphQL Agent?

It’s an AI-powered tool that allows users to ask natural language questions about their indexed blockchain data and get real-time answers – no code needed.

2. Who can use it?

Anyone with a SubQuery indexing project – from developers to analysts to business teams.

3. Is it compatible with any blockchain?

Yes. It works with any chain supported by SubQuery, including Ethereum, Polkadot, Solana, and Cosmos.

4. How does it generate queries?

The agent compresses your GraphQL schema and uses intelligent pattern recognition to build and validate queries instantly.

5. Is it free to use?

Yes – the AI Agent is in beta, a demo version is live and free to test.

A Paradigm Shift for Web3 Data

The SubQuery GraphQL Agent isn't just a productivity booster, it’s a paradigm shift. By rethinking how LLMs interact with blockchain APIs, we’ve created a more scalable, accurate, and cost-effective solution that democratizes access to on-chain data.

Whether you're building dashboards, exploring smart contract activity, or analysing trends — this agent lets you do it all by simply asking a question.

👉Try the SubQuery GraphQL Agent Demo Now

Bring your SubQuery project and start asking questions!

About SubQuery

SubQuery Network is innovating in web3 infrastructure with tools that empower builders to decentralise without compromise. SubQuery’s infrastructure network offers everything from data indexers, RPCs and AI agents - all fully decentralised and production ready.

Our fast, flexible, and open data indexer supercharges thousands of dApps on nearly 300 networks. Our Sharded Data Node will provide breakthroughs in the RPC industry and our AI App framework makes building AI apps easier than ever before. We pioneer the web3 revolution for visionaries and forward-thinkers. We’re not just a company — we’re a movement driving an inclusive and decentralised web3 era, together.

​​​​Linktree | Website | Discord | Telegram | Twitter | Blog | Medium | LinkedIn | YouTube