Usage data 現在可以在 Alchemy CLI 中查詢

最後更新：2026年7月2日1 分鐘閱讀

用量資料現在可以透過 Alchemy CLI 查詢。你可以直接在終端機拉取團隊的運算與成本資料，包含總量以及隨時間變化的明細。同一份資料也能透過 Alchemy MCP Server 提供給 AI agent 使用，讓 agent 不需要額外整合就能看到你的團隊在消耗什麼資源。

在此之前，要查看用量得登入 Dashboard 手動讀圖表，並沒有正規的程式化方式可以取得這些數字。現在有了。

你可以做什麼

大部分情況下，兩個指令就夠用。

alchemy usage summary 會給你月初至今、過去 7 天、或過去 30 天的總量，同時以運算單位與美金呈現。
alchemy usage timeseries 會給你同樣的數字，但以時間序列呈現，讓你看出流量與花費在哪個時間點發生變化。

兩者預設都會在終端機中以易讀的圖表呈現。加上 --json 就會改成結構化輸出，可以直接串接到腳本、儀表板或告警系統。

bash

Copied

alchemy usage summary
alchemy usage timeseries

若要取得機器可讀的輸出：

bash

Copied

alchemy usage summary --json
alchemy usage timeseries --json

用 Dashboard 的方式切分資料

你可以依 network、app、method 或 request type 來分組用量，並針對其中任一項做篩選，藉此回答像是哪個 app 在消耗最多運算量，或哪個 method 在半夜突然暴增之類的問題。用 --granularity 選擇以小時或天為單位呈現。這與 Dashboard 的用量檢視功能完全對等，Dashboard 仍是視覺化資料的權威來源。

幾個範例：

bash

Copied

alchemy usage summary --metrics amount,usd
alchemy usage timeseries --group-by network --granularity day
alchemy usage summary --app-ids <id> --methods eth_getLogs

讓你的 agent 具備用量意識

同一份用量資料也透過 Alchemy MCP Server 以兩個工具的形式提供：get_usage_summary 與 get_usage_time_series。把 agent 指向你的 MCP server，它就能把消耗量與成本納入推理的 context 之中，讓負責監控你基礎設施的 agent 也知道這套基礎設施花了多少錢。

如果你已經把 MCP server 接到 Cursor、Claude Code 或 Codex——可參考 MCP 設定指南或我們的 MCP 公告——這些工具就會出現在 Alchemy 其他功能旁邊。如果你想讓 agent 知道如何在程式碼中呼叫 Alchemy API，可以搭配 Agent Skills 使用；而 MCP 則是讓它在對話中取得即時用量資料的方式。