> ## 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. # OHLC と統計 > K ライン（Pairs）、トークン別取引統計（Tokens）、供給量と評価（TokenSupplyUpdates）のクエリ例、そしてトークンメタデータの所在 このページでは、集約された取引データと供給データを扱います。**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 を使います。 ```graphql theme={null} 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 で開く](https://ide.chainstream.io) — 上記クエリを貼り付けて、オートコンプリートとスキーマ探索付きで対話的に実行できます。 `TOKEN_ADDRESS` をトークンの mint またはコントラクトアドレスに置き換えてください。各行は 1 分バケットです — 約 1 時間分は `limit: { count: 60 }`、約 24 時間分は `count: 1440` を使います。`Market` フィルタを省略すると、全チェーンをまとめて 1 つの結果セットで問い合わせできます。 | フィールド | 説明 | | :-------------------- | :--------------------------- | | `Interval.Time.Start` | 1 分バケットの開始時刻（ローソクの時刻と同じ） | | `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 を使います。 ```graphql theme={null} 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.Start` | 1 分バケットの開始時刻（ローソクの時刻と同じ） | | `Stats.TradeCount` | この区間の取引総数 | | `Stats.BuyCount` | 買い側の取引 | | `Stats.SellCount` | 売り側の取引 | | `Volume.Usd` | USD 出来高合計 | | `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 ```graphql theme={null} 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 の例） ```graphql theme={null} 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](/jp/graphql/examples/pools-liquidity#how-do-i-get-token-supply-and-market-cap) も参照 **TokenSupplyUpdates** は **DWD**（イベント単位）です。単一の静的な「時価総額」サマリー行ではなく、mint/burn アクティビティに紐づく履歴の評価と供給変化を扱うのに適しています。 *** ## トークン検索 / メタデータはどこ？ **TokenSearch** Cube は現行 API に**含まれません**。トークンの文脈が必要な場合: * **Pairs** と **Tokens** は OHLC・統計とともに **Token** ディメンション（例: **Token.Address**）を公開します — アドレスが分かっており集約取引データが欲しいときに使います。 * メタデータ、ホルダー数、プール、発見用途には、チェーンに応じて **Solana** または **EVM** 配下の **DEXPools**、**TokenHolders**、**DEXTradeByTokens** などの Cube を使います。 *** ## マルチチェーンの例 ```graphql theme={null} 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 } } } } ``` ```graphql theme={null} query { Trading { Pairs( tokenAddress: { is: "TOKEN_ADDRESS" } where: { Market: { Network: { is: "eth" } } } limit: { count: 10 } orderBy: { descending: Block_Time } ) { Interval { Time { Start } } Price { Ohlc { Open Close } } Volume { Usd } } } } ``` ```graphql theme={null} query { Trading { Pairs( tokenAddress: { is: "TOKEN_ADDRESS" } where: { Market: { Network: { is: "bsc" } } } limit: { count: 10 } orderBy: { descending: Block_Time } ) { Interval { Time { Start } } Price { Ohlc { Open Close } } Volume { Usd } } } } ``` *** ## 次のステップ DEX の取引データ — トークン取引、ウォレットアクティビティ、上位トレーダー。 ウォレット間のオンチェーントークン転送を追跡。 ウォレット残高、残高履歴、上位ホルダーを参照。 DEX プールと流動性データを探索。