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

端点

或者在 GraphQL IDE 里交互式探索。

鉴权

两种等价路径——按你客户端的情况选:
GraphQL 与 REST 共用同一个 API Key 和订阅配额——无需单独购买。

第一个查询

一次请求返回代币、元数据与最近成交——没有 N+1 回环。

什么时候用

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

从 CLI 调用

chainstream CLI 自带 graphql schema(探索)与 graphql query(执行)子命令——做快速检查或 shell 自动化时,无需专门接入客户端库:

Schema

Schema 总览

类型、关系与约定。

入门

第一个查询的完整走读。

下一步

GraphQL IDE

交互式探索 schema 与跑查询。

chainstream-graphql skill

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

CLI `graphql` 子命令

chainstream graphql schemaquery 参考。

SDK

通过 codegen 的类型化 GraphQL 封装。