メインコンテンツへスキップ
GraphQL エンドポイントは レスポンスの形を決めたい ときに適しています — 複数のデータプロダクトから必要なフィールドだけを 1 リクエストで正確に取得できます。REST が「この 1 つを取得する」なら、GraphQL は「この 1 つの分析質問に答える」です。

エンドポイント

POST https://graphql.chainstream.io/graphql
または GraphQL IDE でインタラクティブに探索できます。

認証

同等の 2 つのパスがあります — クライアントに合うものを選んでください:
# API Key(ブラウザ、サーバー、ほとんどのクライアント)
-H "X-API-KEY: $CHAINSTREAM_API_KEY"
-H "Content-Type: application/json"

# SIWX ウォレットトークン(エージェント/ホスト内ウォレット)
-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
    }
  }
}
1 リクエストでトークン、メタデータ、直近取引が返ります — N+1 なし。

いつ使うか

  • 複数プロダクトにまたがる分析クエリ
  • オーバーフェッチなしで多フィールドを扱うダッシュボード
  • レポート / BI ワークロード
  • レスポンスを事前整形する SSR
向かないケース:リアルタイムストリーム(WebSocket/Kafka を使用)、REST キャッシュが安いホットパスの読み取り。

CLI から呼び出す

chainstream CLI には graphql schema(探索用)と graphql query(実行用)が同梱されています — 手早い確認やシェル自動化にクライアントライブラリを組み込む必要はありません:
# 27 キューブを探索
chainstream graphql schema --summary
chainstream graphql schema --type DEXTrades

# ファイルからクエリを実行
chainstream graphql query --file ./query.graphql --json

スキーマ

スキーマ概要

型、関係、規約。

Getting Started

最初のクエリの完全なウォークスルー。

次へ

GraphQL IDE

スキーマを探索してインタラクティブにクエリを実行。

chainstream-graphql スキル

GraphQL ワークフローのための構造化 Agent Skill。

CLI `graphql` サブコマンド

chainstream graphql schemaquery リファレンス。

SDK

codegen 経由の型付き GraphQL ラッパー。