How To Use The Graph Assistant

Overview

You type a natural language question into the chat interface, such as:

1'On Uniswap, return the top-10 pools by total value locked in USD.'

All users can process 10 free queries per user per hour.

Disclaimer: By using Graph Assistant, you acknowledge that your requests may be logged and used to improve the performance of the underlying agents. Do not share sensitive, personal, or private information.

Behind the Scenes

The Assistant:

Interprets your intent
Maps it to the correct Subgraphs or Token API endpoint
Executes optimized queries
Returns clean, structured results

You don’t need to write queries or understand a Subgraph’s schema, you simply ask.

Example Use Cases

Protocol Analytics

“Compare daily active users on Aave vs. Compound in May 2025.”
“Show me the total value locked (TVL) for XYZDAO over the last quarter.”

Token Insights

“What are the top 10 tokens by market cap on Ethereum right now?”
“How many XYZ did I receive between May 1 and May 15?”

Historical Data Retrieval

“Fetch the token price history of XYZ for the last six months.”
“What was the average gas price on Ethereum during April?”

Portfolio Monitoring

“List my wallet’s current token balances and their USD equivalents.”
“Calculate profit/loss on XYZ since xyz date.”

Cross-Chain Comparison

“Show me the 7-day trading volume of XYZ on Ethereum vs. Polygon.”
“How many XYZ swaps occurred on Arbitrum yesterday?”

To get started follow the quickstart and explore its capabilities.