跳轉到主要內容

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 鏈組中的 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。 
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 中開啟 — 貼上上方查詢即可互動執行，並享受自動補全與 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。 
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.UsdUSD 總成交量
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

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/合約、小數位、符號、名稱）
TokenSupplyUpdate.PriceInUSD本次更新時的 USD 價格
TokenSupplyUpdate.MarketCapInUSD市值
TokenSupplyUpdate.TotalSupply總供應量
TokenSupplyUpdate.FDVInUSD完全稀釋估值（FDV）
TokenSupplyUpdate.PostBalance事件後的供應相關餘額
  • 最新快照：limit: { count: 1 } 配合 orderBy: { descending: Block_Time }
  • 跨鏈對比：在 Solana 與 EVM(network: bsc)（或其他支援的網路）下執行相同結構
  • 更多上下文：另見 池子與流動性 中與供應量及池子相關的示例
TokenSupplyUpdates 為 DWD（事件級）。適合與鑄幣/銷燬相關的歷史估值與供應變化，而不是單一靜態「市值」彙總行。

​
代幣搜尋 / 後設資料在哪裡？

TokenSearch Cube 不是當前 API 的一部分。獲取代幣上下文時：
  • Pairs 與 Tokens 暴露 Token 維度（例如 Token.Address），與 OHLC 和統計並列 — 在已知地址且需要聚合交易資料時使用。
  • 需要更豐富的後設資料、持有人數、池子或發現能力時，在 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 池子與流動性資料。