跳轉到主要內容

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.

​
orderBy InputObject

每個 Cube 會生成 {Cube}OrderBy 輸入物件，包含 ascending 與 descending 欄位。每個欄位接受 CompareFields 列舉值，命名規則為維度路徑以下劃線連線： 
{DimensionGroup}_{DimensionField}
巢狀維度逐級拼接： 
Block_Time
Trade_Buy_Amount
Trade_Buy_PriceInUSD
用法： 
orderBy: {descending: Block_Time}      # newest first
orderBy: {ascending: Trade_Buy_Amount}  # smallest amount first

​
常見 CompareFields 取值

CompareFields 值示例用法Cube說明
Block_TimeorderBy: {descending: Block_Time}DEXTrades, Transfers, BalanceUpdates, DEXPools, TokenSupplyUpdates, Pairs, Tokens最新的在前
Block_TimeorderBy: {ascending: Block_Time}DEXTrades, Transfers, BalanceUpdates, DEXPools, TokenSupplyUpdates, Pairs, Tokens最舊的在前
Interval_Time_StartorderBy: {ascending: Interval_Time_Start}Pairs, Tokens最舊的在前（區間起始時間）
Trade_Buy_AmountorderBy: {descending: Trade_Buy_Amount}DEXTrades買入量大的在前
Trade_Buy_PriceInUSDorderBy: {descending: Trade_Buy_PriceInUSD}DEXTradesUSD 價高的在前
Transfer_AmountInUSDorderBy: {descending: Transfer_AmountInUSD}TransfersUSD 轉賬額大的在前
LatestBalanceUSDorderBy: {descending: LatestBalanceUSD}TokenHolders持倉 USD 大的在前
BuyVolumeUSDStateorderBy: {descending: BuyVolumeUSDState}WalletTokenPnL買入量 USD 高的在前
在 GraphQL IDE 中用自動補全檢視某 Cube 可用的全部 CompareFields——輸入 orderBy: {descending: 後 IDE 會列出可選欄位。

​
用法

傳入 orderBy 輸入物件，將 descending 或 ascending 設為某個 CompareFields 值： 
query {
  Solana {
    DEXTrades(
      orderBy: {descending: Block_Time}
      limit: { count: 10 }
    ) {
      Block { Time }
      Trade { Buy { Amount PriceInUSD } }
    }
  }
}
orderBy 僅接受單一方向/欄位對。不支援多列排序——查詢每次只按一個維度排序。

​
limit 引數

limit 控制返回行數，並支援基於 offset 的分頁： 
input LimitInput {
  count: Int   # Number of rows to return
  offset: Int  # Number of rows to skip
}

​
預設與最大限制

每個 Cube 在省略 limit 時有預設行數，並有最大上限：
Cube預設 count最大 count
DEXTrades2510,000
Transfers2510,000
BalanceUpdates2510,000
DEXPools2510,000
TokenSupplyUpdates2510,000
Pairs2510,000
Tokens2510,000
DEXPoolEvents2510,000
TokenHolders2510,000
WalletTokenPnL2510,000
若請求的 count 超過最大值，服務端會靜默截斷為最大允許值。

​
基於 Offset 的分頁

使用 offset 翻頁，模式很直接：
  • 第 1 頁：limit: { count: 50, offset: 0 }
  • 第 2 頁：limit: { count: 50, offset: 50 }
  • 第 3 頁：limit: { count: 50, offset: 100 }

​
示例：代幣持有者分頁

query {
  Solana {
    TokenHolders(
      tokenAddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
      orderBy: {descending: LatestBalanceUSD}
      limit: { count: 20, offset: 0 }
    ) {
      Holder { Address }
      LatestBalance
      LatestBalanceUSD
    }
  }
}

​
分頁建議

沒有穩定排序時，行間順序可能在翻頁時變化。請始終將 limit 與能產生確定順序的 orderBy 一起使用。
很大的 offset（例如 50,000+）可能拖慢查詢，因為資料庫需掃描並跳過行。對超大結果集，優先用 where 收窄查詢，而非深度 offset 翻頁。
若某頁返回行數少於請求的 count，說明已到達結果末尾。也可事先用 count 指標欄位獲取總行數。

​
實用示例

​
最新大額成交

獲取 Solana 上最近 10 筆買入名義價值超過 10,000 美元的 DEX 成交： 
query {
  Solana {
    DEXTrades(
      where: {
        Trade: { Buy: { PriceInUSD: { gt: 10000 } } }
      }
      orderBy: {descending: Block_Time}
      limit: { count: 10 }
    ) {
      Block { Time }
      Trade {
        Buy {
          Currency { MintAddress }
          Amount
          PriceInUSD
        }
        Dex { ProtocolName }
      }
    }
  }
}

​
OHLC K 線——最近 60 分鐘

獲取某代幣 1 分鐘 K 線，按時間正序： 
query {
  Trading {
    Pairs(
      where: {
        Token: { Address: { is: "So11111111111111111111111111111111111111112" } }
        Market: { Network: { is: "sol" } }
        Block: { Time: { after: "2025-03-27T09:00:00Z" } }
      }
      orderBy: {ascending: Block_Time}
      limit: { count: 60 }
    ) {
      Block { Time }
      Price {
        Ohlc { Open High Low Close }
      }
      Volume { Usd }
      Stats { TradeCount }
    }
  }
}

​
Top 50 代幣持有者

按 USD 餘額排序取前 50 名持有者： 
query {
  Solana {
    TokenHolders(
      tokenAddress: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
      orderBy: {descending: LatestBalanceUSD}
      limit: { count: 50 }
    ) {
      Holder { Address }
      LatestBalance
      LatestBalanceUSD
      FirstSeen
      LastSeen
    }
  }
}

​
下一步

篩選

將排序與篩選結合，構建精確的分析查詢。

指標與聚合

使用 count、sum、avg、min、max、uniq 對已排序資料聚合。