跳轉到主要內容
本頁介紹聚合交易與供應類資料。Cube 名稱為 Trading 鏈組下的 Pairs（跨鏈 OHLC）與 Tokens（跨鏈成交統計）。市值與價格隨時間變化請用 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）資料？

按分鐘獲取 open / high / low / close、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 中開啟 — 將上方查詢貼上到 IDE 中即可互動式執行，享受自動補全與 Schema 探索。
將 TOKEN_ADDRESS 替換為代幣 mint 或合約地址。每一行對應一個分鐘桶 — limit: { count: 60 } 約 1 小時，count: 1440 約 24 小時。去掉 Market 過濾可在單次查詢中跨鏈返回資料。
FieldDescription
Interval.Time.Start分鐘桶起始時間（與 K 線時間一致）
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 或在客戶端聚合；K 線以分鐘粒度物化儲存
  • 成交量過濾：例如 where: { Volume: { Usd: { gt: 100 } }, Market: { Network: { is: "sol" } } } 跳過低量區間
  • 時間範圍：例如 where: { Block: { Time: { since: "2026-03-27T00:00:00Z" } }, Market: { Network: { is: "sol" } } }
Pairs 屬於 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 }
    }
  }
}
FieldDescription
Interval.Time.Start分鐘桶起始時間（與 K 線時間一致）
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）作圖
  • 買賣成交額拆分：Tokens 記錄還提供 Volume.BuyVolumeUSD、Volume.SellVolumeUSD 等欄位
對同一代幣、同一鏈、同一時間視窗同時查 Pairs 與 Tokens，可搭建看板 — K 線與資金流向、參與者指標並用。

​
如何獲取市值、價格與供應量（時間序列）？

舊版 TokenMarketCap 摘要 Cube 已不在當前 Schema 中。請使用 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 }
    }
  }
}
FieldDescription
Block.Time事件發生時間
TokenSupplyUpdate.Currency.*代幣標識（mint/合約、小數位、符號、名稱）
TokenSupplyUpdate.PriceInUSD該次更新時的 USD 價格
TokenSupplyUpdate.MarketCapInUSD市值
TokenSupplyUpdate.TotalSupply總供應量
TokenSupplyUpdate.FDVInUSD完全稀釋估值
TokenSupplyUpdate.PostBalance事件後的供應相關餘額
  • 最新快照：limit: { count: 1 } 且 orderBy: { descending: Block_Time }
  • 跨鏈對比：在 Solana 與 EVM(network: bsc)（或其他受支援網路）下使用相同查詢結構
  • 更多上下文：另見 Pools & Liquidity 中的供應與池子相關示例
TokenSupplyUpdates 屬於 DWD（事件明細）。適合與鑄幣/銷燬相關的歷史估值與供應變化，而不是單一的靜態「市值」摘要行。

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

當前 API 不包含 TokenSearch Cube。獲取代幣上下文可以：
  • 在已知地址的前提下，透過 Pairs、Tokens 上的 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 Trades

查詢 DEX 交易資料 — 代幣交易、錢包活動與頭部交易者。

Transfers

追蹤錢包間的鏈上代幣轉賬。

Balances & Holders

查詢錢包餘額、餘額歷史與頭部持有者。

Pools & Liquidity

探索 DEX 池與流動性資料。