GraphQL

Flexible, analytical queries that JOIN across data products in a single request.

The GraphQL endpoint is the right choice when you want to shape your response — picking exactly the fields you need across multiple data products in one request. If REST is “look up this one thing”, GraphQL is “answer this one analytical question.”

Endpoint

POST https://graphql.chainstream.io/graphql

Or use the GraphQL IDE to explore interactively.

Authentication

Two equivalent paths — pick whichever fits your client:

# API Key (browser, server, most clients)
-H "X-API-KEY: $CHAINSTREAM_API_KEY"
-H "Content-Type: application/json"

# SIWX wallet token (agents / on-host wallets)
-H "Authorization: SIWX <token>"
-H "Content-Type: application/json"

GraphQL and REST share the same API Key and subscription quota — no separate purchase.

First query

query TopSolanaTokens {
  tokens(chain: SOLANA, orderBy: VOLUME_24H_DESC, limit: 5) {
    address
    symbol
    priceUsd
    marketCap
    recentTrades(limit: 3) {
      timestamp
      sizeUsd
      side
    }
  }
}

One request returns tokens, metadata and their recent trades — no N+1 roundtrips.

When to use

• Analytical queries crossing multiple data products
• Dashboards that need many fields without overfetching
• Reporting / BI workloads
• Server-side rendering where you pre-shape the response

When not to: real-time streams (use WebSocket/Kafka) and hot-path reads where REST caching is cheaper.

Invoke from CLI

The chainstream CLI ships with graphql schema (for discovery) and graphql query (for execution) — no need to wire up a client library for quick checks or shell automation:

# Discover the 27 cubes
chainstream graphql schema --summary
chainstream graphql schema --type DEXTrades

# Run a query from a file
chainstream graphql query --file ./query.graphql --json

Schema

Schema overview

Types, relationships and conventions.

Getting started

Complete first-query walkthrough.

Next

GraphQL IDE

Explore the schema and run queries interactively.

chainstream-graphql skill

Structured Agent Skill for GraphQL workflows.

CLI `graphql` subcommand

chainstream graphql schema and query reference.

SDKs

Typed GraphQL wrappers via codegen.