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

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.

このページでは、DEX プールと流動性分析向けの Cube を扱います。
  • DEXPoolEvents（DWD）— 流動性の追加/削除イベントと、イベントごとのリザーブ・価格
  • DEXPools（DWS）— プールのスナップショット（現在の流動性と価格、定期的に更新）
  • TokenSupplyUpdates（DWD）— トークン供給量、時価総額、FDV の更新
例では Solana と EVM の Chain Groups を使用します: Solana は Solana { ... }、EVM チェーン（Polygon を含む）は EVM(network: eth | bsc | polygon) { ... } です。

​
トークンの流動性プールを取得するには？

スナップショットでトークンが token A として掲載されている DEX プールを検索します。資産が token B にしか現れないプールは、tokenB（または where 句）での 2 回目のクエリが必要です。イベント単位でペア文脈が揃った行が欲しい場合は DEXPoolEvents を使います。 
query {
  Solana {
    DEXPools(
      limit: {count: 10}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool {
        Address
        ProgramAddress
        TokenAAddress
        TokenBAddress
        LiquidityUSD
        PriceAtoB
        PriceBtoA
        LastUpdated
      }
    }
  }
}
GraphQL IDE で開く — 上記クエリを貼り付けて、オートコンプリートとスキーマ探索付きで対話的に実行できます。
TOKEN_ADDRESS をトークンの mint（Solana）またはコントラクトアドレス（EVM）に置き換えてください。トークンがクォート側にあるプールも含めるには、tokenB: {is: "TOKEN_ADDRESS"} で繰り返しクエリします。
フィールド説明
Pool.Address流動性プール / マーケットのアドレス
Pool.ProgramAddressDEX プログラムまたはファクトリのアドレス
Pool.TokenAAddressベース側トークンのアドレス
Pool.TokenBAddressクォート側トークンのアドレス
Pool.LiquidityUSDプール全体の流動性（USD、スナップショット）
Pool.LastUpdatedこのスナップショット行が最後に更新された時刻
  • 流動性でフィルター: where: {Pool: {LiquidityUSD: {gt: 10000}}} で USD 深さの閾値以上のプールのみ
  • 特定 DEX: where: {Pool: {ProgramAddress: {is: "DEX_PROGRAM_OR_FACTORY_ADDRESS"}}}
  • より多くのプール: count を増やしてトークンに対する追加プールを探索
  • イベントごとのリザーブ: DEXPoolEvents で tokenAddress / poolAddress と orderBy: {descending: Block_Time} を使い、追加/削除履歴を取得

​
特定プールの詳細を取得するには？

アドレスで 最新スナップショットを 1 件読み取ります。DEXPools は行ごとのブロックタイムラインは提供しません — 履歴のリザーブ系列は DEXPoolEvents を使います。 
query {
  Solana {
    DEXPools(
      limit: {count: 1}
      poolAddress: {is: "POOL_ADDRESS"}
    ) {
      Pool {
        Address
        TokenAAddress
        TokenBAddress
        ProgramAddress
        LiquidityUSD
        PriceAtoB
        PriceBtoA
        LastUpdated
      }
    }
  }
}
フィールド説明
Pool.TokenAAddress / Pool.TokenBAddressペアのトークンアドレス
Pool.LiquidityUSD合計流動性（USD、スナップショット）
Pool.LastUpdatedこのプールのスナップショットが最後に更新された時刻
  • リザーブ履歴: DEXPoolEvents で poolAddress: {is: "POOL_ADDRESS"} と orderBy: {descending: Block_Time}
  • イベントの期間: DEXPoolEvents で where: {Block: {Time: {since: "2025-03-01T00:00:00Z"}}} を追加して追加/削除を期間限定
poolAddress セレクターは Pool.Address でフィルターします。DEXPools（スナップショット）と DEXPoolEvents（イベント）の両方で利用できます。

​
プールをランキングしたりスナップショット流動性を読むには？

DEXPools（DWS）は 現在状態の行を保持します（通常数分ごとに更新）。LiquidityUSD でプールをランキングし、生イベントを走査せずに DEX プログラムを比較するのに使います。 
query {
  Solana {
    DEXPools(
      limit: {count: 20}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool {
        Address
        ProgramAddress
        TokenAAddress
        TokenBAddress
        LiquidityUSD
        LastUpdated
      }
    }
  }
}
フィールド説明
Pool.Addressプールアドレス
Pool.ProgramAddressDEX プログラム / ファクトリ
Pool.TokenAAddress / Pool.TokenBAddressペアのトークン
Pool.LiquidityUSDスナップショット時の流動性（USD）
Pool.LastUpdatedスナップショットの鮮度
  • 流動性でランキング: クライアント側で LiquidityUSD でソートするか、スキーマでプールスナップショットの orderBy があれば利用
  • アクティブなプール: LastUpdated が新しいプールを優先
  • DEX の比較: Pool.ProgramAddress でグループ化またはフィルター
リザーブと各流動性イベントの時系列には DEXPoolEvents（DWD）が適した Cube です。最新のプール状態と発見には DEXPools（DWS）が最適化されています。

​
トークン供給量と時価総額を取得するには？

供給イベントに紐づく供給量、時価総額、価格、FDV には TokenSupplyUpdates を使います。 
query {
  Solana {
    TokenSupplyUpdates(
      limit: {count: 1}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      TokenSupplyUpdate {
        Currency { MintAddress, Decimals }
        PostBalance
        MarketCapInUSD
        PriceInUSD
        FDVInUSD
        TotalSupply
      }
      Block { Time }
    }
  }
}
フィールド説明
TokenSupplyUpdate.Currency.MintAddressトークンアドレス
TokenSupplyUpdate.Currency.Decimalsトークンの小数桁
TokenSupplyUpdate.PostBalanceイベント後の現在供給量
TokenSupplyUpdate.MarketCapInUSDUSD 建ての時価総額
TokenSupplyUpdate.PriceInUSD供給イベント時点のトークン価格
TokenSupplyUpdate.FDVInUSDフルダイリューション評価額（FDV）
TokenSupplyUpdate.TotalSupplyトークン総供給量
  • 供給の履歴: count を増やして供給が時間とともにどう変わったか（mint/burn）を確認
  • 時価総額の履歴: 複数の供給更新をクエリして時価総額を時系列で可視化
  • 価格との突合: 時価総額計算の検証に PriceInUSD と TotalSupply を併用
このページの TokenSupplyUpdates は、供給に連動した時価総額・価格・FDV 用です。追加のトークンメトリクスとサマリーは OHLC と統計 を参照してください。

​
マルチチェーンの例

query {
  Solana {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

​
次のステップ

DEX 取引

DEX のトレーディングデータ — トークン取引、ウォレット活動、トップトレーダーをクエリします。

送金（Transfers）

ウォレット間のオンチェーン送金を追跡します。

残高とホルダー

ウォレット残高、残高履歴、トップホルダーを調べます。

OHLC と統計

ローソク足、取引統計、時価総額、トークンメタデータを取得します。