chainstream-graphql Skill

​

概要

• パターン: ツール（読み取り専用、署名なし）
• エンドポイント: https://graphql.chainstream.io/graphql（APISIX 経由でルーティング）
• CLI: npx @chainstream-io/cli graphql
• 認証: API Key（X-API-KEY）、または SIWX ウォレットトークン
• 支払い: REST と同じ API Key / サブスクリプションプール（x402 / MPP は CLI が自動処理）
• スコープ: 3 つのチェーングループにわたる 27 キューブ — Solana、EVM(network: eth | bsc | polygon)、Trading

​

使うべきとき

​

統合パス

​

チャネルマトリクス

​

AI ワークフロー

​

スキーマ探索

npx @chainstream-io/cli graphql schema --summary
npx @chainstream-io/cli graphql schema --type DEXTrades

​

クエリの構築と実行

query {
  Solana {
    DEXTrades(
      limit: { count: 25 }
      orderBy: { descending: Block_Time }
    ) {
      Block { Time }
      Trade {
        Buy  { Currency { MintAddress } Amount PriceInUSD }
        Sell { Currency { MintAddress } Amount }
        Dex  { ProtocolName }
      }
    }
  }
}

query {
  EVM(network: eth) {
    DEXTrades(
      limit: { count: 25 }
      orderBy: { descending: Block_Time }
      where: { Trade: { Buy: { Amount: { gt: "0" } } } }
    ) {
      Block { Time }
      Trade { Buy { Currency { Symbol } Amount } Sell { Currency { Symbol } Amount } }
    }
  }
}

query {
  Trading {
    Pairs(
      tokenAddress: { is: "So11111111111111111111111111111111111111112" }
      limit: { count: 24 }
    ) {
      TimeMinute
      Price { Open High Low Close }
    }
  }
}

npx @chainstream-io/cli graphql query --file ./query.graphql --json

npx @chainstream-io/cli graphql query \
  --query 'query { Solana { DEXTrades(limit:{count:5}) { Block { Time } } } }' \
  --json

​

クエリ構築クイックリファレンス

• チェーングループラッパー: トップレベルで必須。Solana、EVM(network: ...)、Trading のいずれか。
• network: EVM のみ。値: eth、bsc、polygon。
• limit: { count: N, offset: M }。既定値は 25。
• orderBy: { descending: Field } / { ascending: Field }。計算フィールドには { descendingByField: "field_name" } を使用。
• where: { Group: { Field: { operator: value } } }。OR 条件は any: [{...}, {...}] で指定。
• DateTime 形式: "YYYY-MM-DD HH:MM:SS" — T なし、Z なし（ClickHouse の要件）。
• DateTime フィルタ: since、till、after、before — DateTime フィールドに gt / lt を使わない。
• joinXxx: 関連キューブへの LEFT JOIN。複数クエリよりもこちらを優先。
• dataset ラッパー引数: realtime、archive、combined（既定）。
• aggregates ラッパー引数: yes、no、only。

​

チェーングループとキューブ

​

セーフティルール

​

エラー復旧

​

関連