跳轉到主要內容
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 钱包令牌（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 技能

面向 GraphQL 工作流的結構化 Agent Skill。

CLI `graphql` 子命令

chainstream graphql schema 和 query 參考。

SDK

透過 codegen 的型別化 GraphQL 封裝。