メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt

Use this file to discover all available pages before exploring further.

このページでは、集約された取引データと供給データを扱います。Cube 名は Trading chain group 内の Pairs と Tokens（クロスチェーンの OHLC と取引統計）です。時系列の時価総額と価格スナップショットは、Solana または EVM 配下の TokenSupplyUpdates から取得します。
  • Pairs（Trading, DWM）— 1 分足のローソク足 / K 線データ（OHLC、出来高、取引回数）
  • Tokens（Trading, DWM）— 1 分ごとの取引統計（買い/売りの内訳とユニークなトレーダー数）
  • TokenSupplyUpdates（Solana / EVM, DWD）— mint/burn イベントと供給、価格、時価総額、FDV フィールド
  • トークンメタデータ — 独立した TokenSearch Cube はありません。Pairs / Tokens の Token（および関連）ディメンションを使うか、DEXPools、TokenHolders、DEXTradeByTokens などの Cube で発見・スクリーニングしてください
Trading には network 引数はありません。チェーンは where: { Market: { Network: { is: "sol" } } }（または eth、bsc、polygon）で絞り込みます。Solana と EVM グループは従来どおり Solana { ... }、EVM(network: eth) { ... } のラッパーを使います。

​
K 線（OHLC）のローソク足データはどう取得する？

トークンのローソク足データ（1 分あたりの始値・高値・安値・終値、USD 出来高、取引回数）を取得します。Trading 内の Pairs Cube を使います。 
query {
  Trading {
    Pairs(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      where: { Market: { Network: { is: "sol" } } }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Interval { Time { Start } }
      Token { Address }
      Market { Network }
      Price {
        Ohlc {
          Open
          High
          Low
          Close
        }
      }
      Volume { Usd }
      Stats { TradeCount }
    }
  }
}
GraphQL IDE で開く — 上記クエリを貼り付けて、オートコンプリートとスキーマ探索付きで対話的に実行できます。
TOKEN_ADDRESS をトークンの mint またはコントラクトアドレスに置き換えてください。各行は 1 分バケットです — 約 1 時間分は limit: { count: 60 }、約 24 時間分は count: 1440 を使います。Market フィルタを省略すると、全チェーンをまとめて 1 つの結果セットで問い合わせできます。
フィールド説明
Interval.Time.Start1 分バケットの開始時刻（ローソクの時刻と同じ）
Token.Addressトークンアドレス
Market.Networkチェーン識別子（sol、eth、bsc、…）
Price.Ohlc.Open区間の始値
Price.Ohlc.High区間中の最高価格
Price.Ohlc.Low区間中の最安価格
Price.Ohlc.Close区間の終値
Volume.Usdこの区間の USD 出来高合計
Stats.TradeCountこの区間の取引数
  • 長い期間: limit で行数を増やすか、クライアント側で集約する。ローソクは 1 分粒度で保存されています
  • 出来高フィルタ: 例 — where: { Volume: { Usd: { gt: 100 } }, Market: { Network: { is: "sol" } } } で低出来高の区間をスキップ
  • 時間範囲: 例 — where: { Block: { Time: { since: "2026-03-27T00:00:00Z" } }, Market: { Network: { is: "sol" } } }
Pairs Cube は DWM（集約）モデルで、データは 1 分ごとに事前計算されています。チャート用に生の取引を走査するよりはるかに高速です。

​
トークンの取引統計はどう取得する？

1 分ごとの取引統計（買い/売り件数、ユニークな買い手/売り手数、出来高）を取得します。Trading 内の Tokens Cube を使います。 
query {
  Trading {
    Tokens(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      where: { Market: { Network: { is: "sol" } } }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Interval { Time { Start } }
      Token { Address }
      Market { Network }
      Stats {
        TradeCount
        BuyCount
        SellCount
        UniqueBuyers
        UniqueSellers
      }
      Volume { Usd }
    }
  }
}
フィールド説明
Interval.Time.Start1 分バケットの開始時刻（ローソクの時刻と同じ）
Stats.TradeCountこの区間の取引総数
Stats.BuyCount買い側の取引
Stats.SellCount売り側の取引
Volume.UsdUSD 出来高合計
Stats.UniqueBuyersユニークな買い手ウォレット数
Stats.UniqueSellersユニークな売り手ウォレット数
  • 買い/売り圧力: Stats.BuyCount と Stats.SellCount を比較
  • ユニークなトレーダー: Stats.UniqueBuyers と Stats.UniqueSellers で出来高が分散しているか集中しているかを把握
  • アクティビティヒートマップ: 1 日分（count: 1440）を問い合わせ、Interval.Time.Start（または Block.Time）でチャート化
  • 買い/売りの USD 出来高: USD の内訳が必要な場合、Tokens レコードは Volume.BuyVolumeUSD と Volume.SellVolumeUSD も公開しています
同じトークン・チェーン・時間窓で Pairs と Tokens を組み合わせると、OHLC とフロー・参加者指標を並べたダッシュボードを構築できます。

​
時価総額・価格・供給の時系列はどう取得する？

従来の TokenMarketCap サマリー Cube は現行スキーマでは使いません。TokenSupplyUpdates（Solana または EVM）を使います。各行は供給に影響するイベントを表し、価格・時価総額・FDV・総供給などの TokenSupplyUpdate メトリクスが含まれます。

​
Solana

query {
  Solana {
    TokenSupplyUpdates(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Block { Time }
      TokenSupplyUpdate {
        Currency {
          MintAddress
          Decimals
          Symbol
          Name
        }
        PriceInUSD
        MarketCapInUSD
        TotalSupply
        FDVInUSD
        PostBalance
      }
      Transaction { Signature }
    }
  }
}

​
EVM（Ethereum の例）

query {
  EVM(network: eth) {
    TokenSupplyUpdates(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Block { Time }
      TokenSupplyUpdate {
        Currency {
          MintAddress
          Decimals
          Symbol
          Name
        }
        PriceInUSD
        MarketCapInUSD
        TotalSupply
        FDVInUSD
        PostBalance
      }
      Transaction { Hash }
    }
  }
}
フィールド説明
Block.Timeイベント時刻
TokenSupplyUpdate.Currency.*トークン識別（mint/コントラクト、decimals、シンボル、名前）
TokenSupplyUpdate.PriceInUSDこの更新時点の USD 価格
TokenSupplyUpdate.MarketCapInUSD時価総額
TokenSupplyUpdate.TotalSupply総供給量
TokenSupplyUpdate.FDVInUSDフルディリューション評価額（FDV）
TokenSupplyUpdate.PostBalanceイベント後の供給関連残高
  • 最新スナップショット: orderBy: { descending: Block_Time } と limit: { count: 1 }
  • チェーン比較: 同じ形を Solana と EVM(network: bsc)（または他の対応ネットワーク）の両方で実行
  • 追加コンテキスト: 供給とプール関連の例は Pools & Liquidity も参照
TokenSupplyUpdates は DWD（イベント単位）です。単一の静的な「時価総額」サマリー行ではなく、mint/burn アクティビティに紐づく履歴の評価と供給変化を扱うのに適しています。

​
トークン検索 / メタデータはどこ？

TokenSearch Cube は現行 API に含まれません。トークンの文脈が必要な場合:
  • Pairs と Tokens は OHLC・統計とともに Token ディメンション（例: Token.Address）を公開します — アドレスが分かっており集約取引データが欲しいときに使います。
  • メタデータ、ホルダー数、プール、発見用途には、チェーンに応じて Solana または EVM 配下の DEXPools、TokenHolders、DEXTradeByTokens などの Cube を使います。

​
マルチチェーンの例

query {
  Trading {
    Pairs(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      where: { Market: { Network: { is: "sol" } } }
      limit: { count: 10 }
      orderBy: { descending: Block_Time }
    ) {
      Interval { Time { Start } }
      Price {
        Ohlc {
          Open
          Close
        }
      }
      Volume { Usd }
    }
  }
}

​
次のステップ

DEX 取引

DEX の取引データ — トークン取引、ウォレットアクティビティ、上位トレーダー。

転送

ウォレット間のオンチェーントークン転送を追跡。

残高とホルダー

ウォレット残高、残高履歴、上位ホルダーを参照。

プールと流動性

DEX プールと流動性データを探索。