包含什麼
| 欄位組 | 舉例 |
|---|---|
| 身份 | chainId, poolAddress, dex, pairType（v2/v3/v4/CLMM/StableSwap） |
| 代幣 | token0, token1, decimals0, decimals1, reserve0, reserve1 |
| 經濟 | tvlUsd, volume24hUsd, feeTierBps, apy7d |
| 狀態 | priceToken0InToken1, sqrtPriceX96, tick, liquidity |
| 來源 | createdAtBlock, factoryAddress, initCodeHash |
覆蓋與新鮮度
- 池子建立按區塊檢測；狀態欄位在每次 swap / add / remove 之後更新（通常秒級）。
- 歷史 TVL 與成交量按 1h、1d 聚合。
接入方式
REST
pools/{address}、pools/search、pools/{address}/trades。GraphQL
一個查詢把 Pools 與 Tokens、Trades JOIN。
WebSocket
dex-pool-balance:{chain}_{poolAddress} 即時池流動性；池建立事件從 Kafka {chain}.dex.pools 消費。SDK：client.stream.subscribeDexPoolBalance。Kafka
各鏈
*.pool.created、*.pool.sync 主題。常見用例
- 構建按 TVL / 成交量篩選的 all-pools 看板
- 抓新池 / 打新告警
- swap 前檢查具體池子深度
- 驅動需要實時儲備的路由層
計費
單池查詢 1 read unit；搜尋與列表按limit 計費。
下一步
Trades 交易
流經這些池子的成交流。
Candles (OHLC) K 線
想要 K 線而不是狀態快照時用。