跳转到主要内容
GraphQL 端点适合你想 塑形响应 的场景——在一次请求里精确挑选跨多个数据产品的字段。如果 REST 是”取这一个东西”，GraphQL 就是”回答这一个分析问题”。

​
端点

POST https://graphql.chainstream.io/graphql
或者在 GraphQL IDE 里交互式探索。

​
鉴权

两种等价路径——按你客户端的情况选： 
# API Key（浏览器、服务端、大部分客户端）
-H "X-API-KEY: $CHAINSTREAM_API_KEY"
-H "Content-Type: application/json"

# SIWX 钱包 token（Agent / 宿主钱包）
-H "Authorization: SIWX <token>"
-H "Content-Type: application/json"
GraphQL 与 REST 共用同一个 API Key 和订阅配额——无需单独购买。

​
第一个查询

query TopSolanaTokens {
  tokens(chain: SOLANA, orderBy: VOLUME_24H_DESC, limit: 5) {
    address
    symbol
    priceUsd
    marketCap
    recentTrades(limit: 3) {
      timestamp
      sizeUsd
      side
    }
  }
}
一次请求返回代币、元数据与最近成交——没有 N+1 回环。

​
什么时候用

  • 跨多个数据产品的分析型查询
  • 字段多又不想过度抓取的看板
  • 报表 / BI 负载
  • 服务端渲染，预先塑形响应
不建议用 的场景：实时流（用 WebSocket/Kafka）、REST 缓存更便宜的热读。

​
从 CLI 调用

chainstream CLI 自带 graphql schema（探索）与 graphql query（执行）子命令——做快速检查或 shell 自动化时，无需专门接入客户端库： 
# 探索 27 个 cube
chainstream graphql schema --summary
chainstream graphql schema --type DEXTrades

# 从文件运行查询
chainstream graphql query --file ./query.graphql --json

​
Schema

Schema 总览

类型、关系与约定。

入门

第一个查询的完整走读。

​
下一步

GraphQL IDE

交互式探索 schema 与跑查询。

chainstream-graphql skill

面向 GraphQL 工作流的结构化 Agent Skill。

CLI `graphql` 子命令

chainstream graphql schema 与 query 参考。

SDK

通过 codegen 的类型化 GraphQL 封装。