如何用 Alchemy CLI 從終端機查詢 RPC 用量

Q: 有沒有可以管理區塊鏈基礎設施並查詢 RPC 用量的 CLI？

有。Alchemy CLI 可以從終端機管理 Alchemy app、allowlist 和 webhook，alchemy usage summary 則以運算單位和美金顯示月初至今、7 天與 30 天的用量。alchemy usage timeseries 依 network、app、method 或 request type 拆解用量。用 npm i -g @alchemy/cli@latest 安裝。

Q: 如何從命令列查詢我的 Alchemy 運算單位用量？

安裝 Alchemy CLI，用 alchemy auth 登入，然後執行 alchemy usage summary。它會回傳團隊在月初至今、過去 7 天與過去 30 天的總量，同時以運算單位和美金呈現。加上 --json 就能取得結構化輸出，可以 pipe 到 jq、儀表板或告警系統。

Q: 可以依 method、network 或 app 查看 RPC 用量嗎？

可以。alchemy usage timeseries --start-date --group-by method 會依 method 分組用量，你也可以同時從 app、network、method 和 requestType 中選最多三個來分組。--networks、--methods、--app-ids 和 --request-types 等篩選條件會先縮小資料範圍。用 --granularity 選擇以小時或天為區間。

Q: AI coding agent 能用 Alchemy CLI 查詢用量嗎？

可以。任何能執行終端機指令的 agent，包括 Claude Code、Cursor 和 Codex，都能呼叫 alchemy --json --no-interactive usage summary 並讀取 JSON 結果。執行 alchemy --json --no-interactive agent-prompt 會把完整的指令樹、驗證方式和錯誤代碼交給 agent，讓它不用反覆試錯就能正確呼叫 Alchemy CLI。連上 Alchemy MCP Server 的 agent 也能使用其中的 get_usage_summary 和 get_usage_time_series 工具。

作者：Lisa Ma

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

Alchemy CLI 讓你直接在終端機查詢 RPC 用量。alchemy usage summary 用一個指令顯示團隊的運算單位與美金花費，alchemy usage timeseries 則依 network、app、method 或 request type 拆解這些用量。同一個 CLI 也能管理你的 app、allowlist 和 webhook。

查看用量不必再打開 Dashboard。以下說明這兩個用量指令怎麼運作、如何找出推高運算量的來源、CLI 還能管理什麼，以及如何把用量檢查寫成腳本或交給 coding agent。

如何從終端機查詢 RPC 用量？

登入一次，接著查詢摘要。

bash

Copied

alchemy auth
alchemy usage summary

alchemy auth 會開啟瀏覽器讓你用 Alchemy 帳號登入，用量指令會沿用這次登入，所以不需要複製 API key。在遠端機器、CI runner 或 SSH session 中，執行 alchemy auth login --device-code，再從任何裝置的瀏覽器核准那組短代碼。

alchemy usage summary 會回傳團隊的三個總量：月初至今、過去 7 天與過去 30 天。每個總量都同時以運算單位和美金呈現，並列出目前帳單週期的起訖日期。預設輸出方便人閱讀。當腳本或其他工具需要這些數字時，加上 --json。

bash

Copied

alchemy --json usage summary

先看摘要，快速掌握這個帳單週期的狀況。當某個數字比預期高時，時間序列會告訴你它從哪裡來。

如何看出是哪個 app、network 或 method 在推高用量？

alchemy usage timeseries 會把用量切分成以天或小時為單位的區間。它需要一個起始日期，並可依最多三個維度分組：app、network、method 和 requestType。

bashCopied
# Window start, 6 days ago (macOS syntax first, then Linux)
SINCE=$(date -u -v-6d +%F 2>/dev/null || date -u -d '6 days ago' +%F)
# Usage per network, per day
alchemy usage timeseries --start-date "$SINCE" --group-by network
# Usage per app and method
alchemy usage timeseries --start-date "$SINCE" --group-by app,method
# Hourly usage per method, to pin down when a spike started
alchemy usage timeseries --start-date "$SINCE" --granularity hour --group-by method

篩選條件會在分組前先縮小資料範圍。每個篩選條件都接受以逗號分隔的值，多個篩選條件之間以 AND 結合。

bashCopied
alchemy usage timeseries --start-date "$SINCE" --networks base-mainnet --methods eth_getLogs
alchemy usage timeseries --start-date "$SINCE" --request-types websocket,webhook

--app-ids 依 app 篩選，request type 則有 http、websocket、webhook 和 grpc。時間序列只回報運算單位，因此美金總額要從 usage summary 取得。

時間序列能往回查多久取決於你的方案，而單次請求最多涵蓋 30 天。

方案	時間序列回溯範圍
免費	1 天
用量付費	7 天
企業	最多 90 天，需為你的團隊啟用

如果你指定更早的起始日期，CLI 會把它限縮到方案的上限，並同時顯示你要求的範圍與實際回傳的範圍。當總量突然跳升時，先依 method 分組，再篩選到發出這些呼叫的 app 和 network。

Alchemy CLI 還能管理什麼？

原本要在 Alchemy Dashboard 裡逐一點擊完成的帳號與基礎設施工作，CLI 都能處理。

列出 app 並選擇預設 app。 alchemy app list 和 alchemy app select <id>
建立 app。 alchemy app create --name <name> --networks <ids>
限制 app 的存取。 alchemy app networks、alchemy app origin-allowlist、alchemy app ip-allowlist 和 alchemy app address-allowlist
管理 webhook。 alchemy webhook list 和 alchemy webhook create --body <json>
檢查你的設定。 alchemy auth status 和 alchemy doctor

會變更 app 或 webhook 的指令都支援 --dry-run，讓你在變更生效前先預覽。webhook 指令還需要一組從 Dashboard 取得的 webhook API key，用 alchemy config set webhook-api-key <key> 設定一次即可。我們的 Alchemy Webhooks 頁面說明了每種 webhook 類型追蹤的內容。

CLI 也能讀取鏈上資料和發送交易。alchemy evm data balance vitalik.eth 和 alchemy evm block latest 不需要寫腳本就能回傳結果，而 Alchemy CLI 的 Agent Wallets 則加上了簽署與發送功能。其他指令可參考使用 Alchemy CLI 更快完成的 12 件事。

建立 app、限制它接受的請求，以及查看它產生的用量，都可以在同一個終端機 session 中完成。

如何把用量檢查寫成腳本或交給 agent？

兩個全域旗標讓任何指令都能安全地自動化。--json 會輸出結構化資料（輸出被 pipe 時會自動切換成 JSON），--no-interactive 則讓 CLI 不會停下來等待提示輸入。

給 cron 或 CI 用的預算檢查只需要一個 jq 運算式。下面這個運算式會在月初至今的花費超過 500 美金時以狀態碼 1 結束。

bash

Copied

alchemy --json --no-interactive usage summary | jq -e '(.data.totals.monthToDate.usd | tonumber) <= 500'

能執行終端機指令的 coding agent，例如 Claude Code、Cursor 和 Codex，也能呼叫同樣的指令。先把 CLI 自己的說明交給 agent。

bash

Copied

alchemy --json --no-interactive agent-prompt

輸出內容列出指令樹、驗證方式、附重試建議的錯誤代碼，以及可直接執行的範例，可以直接放進 agent 的 system prompt。我們還提供另外兩種 agent 介面。Agent Skills 教 agent 在程式碼中撰寫 Alchemy API 呼叫，位於 https://mcp.alchemy.com/mcp 的 Alchemy MCP Server 則讓 agent 在對話中取得鏈上資料並管理 app。我們的 MCP server 公告說明了每個 client 的設定方式。

MCP server 也以 get_usage_summary 和 get_usage_time_series 兩個工具提供同樣的用量資料。在 Cursor、Claude Code 或 Codex 中連上 MCP server 的 agent，不必執行 CLI，就能在對話中查看用量和成本。

能讀取用量的 agent，可以在它仍在處理造成成本暴增的那段程式碼時，就先發出警示。

如何安裝 Alchemy CLI？

從 npm 安裝、登入，然後執行你的第一次用量檢查。

bash

Copied

npm i -g @alchemy/cli@latest
alchemy auth
alchemy usage summary

如果已經安裝過 CLI，同一個指令會把它更新。alchemy doctor 會回報設定中缺少的項目，並印出修正用的指令。CLI 文件的用量章節列出了所有旗標與篩選條件。

常見問題

有沒有可以管理區塊鏈基礎設施並查詢 RPC 用量的 CLI？

有。Alchemy CLI 可以從終端機管理 Alchemy app、allowlist 和 webhook，alchemy usage summary 則以運算單位和美金顯示月初至今、7 天與 30 天的用量。alchemy usage timeseries 依 network、app、method 或 request type 拆解用量。用 npm i -g @alchemy/cli@latest 安裝。

如何從命令列查詢我的 Alchemy 運算單位用量？

安裝 Alchemy CLI，用 alchemy auth 登入，然後執行 alchemy usage summary。它會回傳團隊在月初至今、過去 7 天與過去 30 天的總量，同時以運算單位和美金呈現。加上 --json 就能取得結構化輸出，可以 pipe 到 jq、儀表板或告警系統。

可以依 method、network 或 app 查看 RPC 用量嗎？

可以。alchemy usage timeseries --start-date <date> --group-by method 會依 method 分組用量，你也可以同時從 app、network、method 和 requestType 中選最多三個來分組。--networks、--methods、--app-ids 和 --request-types 等篩選條件會先縮小資料範圍。用 --granularity 選擇以小時或天為區間。

Alchemy CLI 的用量最多可以往回查多久？

用量時間序列在免費方案可回溯 1 天，在用量付費方案可回溯 7 天，在企業方案為你的團隊啟用後最多可回溯 90 天。每次請求最多涵蓋 30 天。如果你指定更早的起始日期，Alchemy CLI 會把它限縮到方案的上限，並顯示實際回傳的範圍。

AI coding agent 能用 Alchemy CLI 查詢用量嗎？

可以。任何能執行終端機指令的 agent，包括 Claude Code、Cursor 和 Codex，都能呼叫 alchemy --json --no-interactive usage summary 並讀取 JSON 結果。執行 alchemy --json --no-interactive agent-prompt 會把完整的指令樹、驗證方式和錯誤代碼交給 agent，讓它不用反覆試錯就能正確呼叫 Alchemy CLI。連上 Alchemy MCP Server 的 agent 也能使用其中的 get_usage_summary 和 get_usage_time_series 工具。

開始從終端機查詢用量

安裝 CLI 並執行 alchemy usage summary，看看這個月的用量狀況。它使用你在 Dashboard 已經在用的帳號登入，用量指令不需要 API key，而且所有方案都能使用。第一次使用 Alchemy？先在 Alchemy Dashboard 建立免費帳號，再用 alchemy auth 讓 CLI 連上這個帳號。