> ## 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）的查詢範例，以及代幣 metadata 的取得位置 本頁介紹聚合交易與供應資料。**Cube 名稱**為 **Trading** 鏈組中的 **Pairs** 與 **Tokens**（跨鏈 OHLC 與成交統計）。市值與價格隨時間變化來自 **Solana** 或 **EVM** 下的 **TokenSupplyUpdates**。 * **Pairs**（Trading，DWM）— 按分鐘的 K 線 / 蠟燭圖資料（OHLC、成交量、成交筆數） * **Tokens**（Trading，DWM）— 按分鐘的成交統計，含買賣拆分與獨立交易人數 * **TokenSupplyUpdates**（Solana / EVM，DWD）— 鑄幣/銷燬事件，含供應量、價格、市值與 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）蠟燭圖資料？ 按代幣拉取蠟燭圖資料 — 每分鐘的開、高、低、收價格，以及 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) — 貼上上方查詢即可互動執行，並享受自動補全與 schema 瀏覽。 將 `TOKEN_ADDRESS` 替換為代幣 mint 或合約地址。每一行對應一分鐘桶 — 使用 `limit: { count: 60 }` 約一小時，`count: 1440` 約 24 小時。省略 `Market` 篩選可在單次結果中跨所有鏈查詢。 | 欄位 | 說明 | | :-------------------- | :----------------------- | | `Interval.Time.Start` | 分鐘桶起始時間（與蠟燭時間一致） | | `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` 請求更多行，或在客戶端聚合；蠟燭以分鐘粒度儲存 * **成交量篩選**：例如 `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**（聚合）模型 — 資料按分鐘預計算。比掃描原始成交構建圖表要快得多。 *** ## 如何獲取某代幣的成交統計？ 獲取按分鐘的成交統計，含買賣筆數、獨立買/賣家人數與成交量。在 **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` | 分鐘桶起始時間（與蠟燭時間一致） | | `Stats.TradeCount` | 該區間總成交筆數 | | `Stats.BuyCount` | 買方成交筆數 | | `Stats.SellCount` | 賣方成交筆數 | | `Volume.Usd` | USD 總成交量 | | `Stats.UniqueBuyers` | 獨立買家錢包數 | | `Stats.UniqueSellers` | 獨立賣家錢包數 | * **買賣壓力**：對比 `Stats.BuyCount` 與 `Stats.SellCount` * **獨立交易者**：`Stats.UniqueBuyers` 與 `Stats.UniqueSellers` 反映成交量是分散還是集中 * **活動熱力圖**：查詢一整天（`count: 1440`）並按 `Interval.Time.Start`（或 `Block.Time`）製圖 * **買賣成交量**：需要 USD 拆分時，**Tokens** 記錄還提供 `Volume.BuyVolumeUSD` 與 `Volume.SellVolumeUSD` 對同一代幣、鏈與時間視窗同時查詢 **Pairs** 與 **Tokens**，可搭建儀表盤 — OHLC 與資金流、參與者指標並列展示。 *** ## 如何獲取市值、價格與供應量隨時間變化？ 當前 schema 不再使用舊的 **TokenMarketCap** 彙總 Cube。請使用 **TokenSupplyUpdates**（Solana 或 EVM）：每一行對應影響供應量的事件，**TokenSupplyUpdate** 指標含價格、市值、FDV 與總供應量等。 ### 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/合約、小數位、符號、名稱） | | `TokenSupplyUpdate.PriceInUSD` | 本次更新時的 USD 價格 | | `TokenSupplyUpdate.MarketCapInUSD` | 市值 | | `TokenSupplyUpdate.TotalSupply` | 總供應量 | | `TokenSupplyUpdate.FDVInUSD` | 完全稀釋估值（FDV） | | `TokenSupplyUpdate.PostBalance` | 事件後的供應相關餘額 | * **最新快照**：`limit: { count: 1 }` 配合 `orderBy: { descending: Block_Time }` * **跨鏈對比**：在 `Solana` 與 `EVM(network: bsc)`（或其他支援的網路）下執行相同結構 * **更多上下文**：另見 [池子與流動性](/zh-Hant/graphql/examples/pools-liquidity#how-do-i-get-token-supply-and-market-cap) 中與供應量及池子相關的示例 **TokenSupplyUpdates** 為 **DWD**（事件級）。適合與鑄幣/銷燬相關的歷史估值與供應變化，而不是單一靜態「市值」彙總行。 *** ## 代幣搜尋 / 後設資料在哪裡？ **TokenSearch** Cube **不是**當前 API 的一部分。獲取代幣上下文時： * **Pairs** 與 **Tokens** 暴露 **Token** 維度（例如 **Token.Address**），與 OHLC 和統計並列 — 在已知地址且需要聚合交易資料時使用。 * 需要更豐富的後設資料、持有人數、池子或發現能力時，在 **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 池子與流動性資料。