GraphQL Query Builder

WHAT IT DOES

GraphQL Query Builder is a developer tool that builds and executes GraphQL queries against blockchain subgraphs and other GraphQL endpoints. Enter a GraphQL endpoint (e.g., The Graph subgraph URL), specify the entity name, select fields, optionally add filters, and set a limit — the tool generates a valid GraphQL query and executes it against the endpoint. Results are displayed in a formatted table or JSON view. This is essential for developers working with The Graph, querying subgraph data, testing GraphQL APIs, exploring blockchain data, and debugging query syntax without writing raw GraphQL.

HOW TO USE

Connect your wallet using the BGWallet bridge (MetaMask or any Web3 wallet). Enter the GraphQL endpoint URL — for The Graph, use a subgraph URL like https://api.thegraph.com/subgraphs/name/uniswap/uniswap-v3. Select the query type (Query or Mutation). Enter the entity name (e.g., "pools", "tokens", "users"). Specify the fields to return, separated by commas (e.g., "id, token0, token1, feeTier"). Optionally, add a filter as a JSON object (e.g., {"id": "0x..."}). Set a limit to control the number of results returned. Click "Build & execute query" to generate and send the query. Results display the endpoint, execution status, the generated query, and the returned data in a table or JSON format. The tool handles both successful responses and errors.

TECHNICAL MECHANISM

The tool constructs a GraphQL query string based on user inputs. It builds the query using the format: { queryType { entity(args) { fields } } }. The entity name is used as the top-level field. The fields are split from the comma-separated input and joined with newlines. The filter is added as a where argument if provided, and the limit is added as a first argument. The tool then sends a POST request to the specified endpoint with the query in the request body (Content-Type: application/json). It handles the JSON response, checking for errors and extracting the data. If the data contains an array of objects, it renders them as a table with headers and rows. If the data is a single object or nested structure, it displays the formatted JSON. The tool does not validate the query against the schema — it sends the query as-is and relies on the endpoint to validate and respond. All requests are sent directly from the browser to the GraphQL endpoint.

WHAT IT CANNOT SEE

The tool cannot execute GraphQL queries without a GraphQL endpoint — a valid URL is required. It cannot validate queries against subgraph schemas without the schema being provided — the tool does not have built-in schema introspection. It cannot handle complex nested queries with deep recursion without potential performance degradation — the tool constructs queries based on user input but does not optimize for deep nesting. It cannot connect to private or authenticated GraphQL endpoints without additional configuration — the tool does not support authentication headers or API keys. It cannot generate queries for subgraphs that are not indexed or available — the endpoint must be reachable and responsive. It cannot execute mutations that require variables or complex input objects — only simple mutations without variables are supported. It cannot introspect subgraph schemas or provide auto-completion. The tool is read-only and does not sign any transactions.

PLEASE NOTE

This tool works exclusively with EVM-compatible chains for the wallet connection, but the GraphQL query itself is chain-agnostic and works with any GraphQL endpoint. Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported for wallet connection but the query builder works regardless. The tool does not store any data — all operations are performed client-side. The tool is provided as-is with no warranty or liability. Always verify GraphQL endpoints from trusted sources. Rate limits may apply based on the endpoint provider (e.g., The Graph).