Como verificar o uso de RPC pelo terminal com a Alchemy CLI

A Alchemy CLI permite verificar o uso de RPC pelo terminal. alchemy usage summary mostra as unidades de compute e o gasto em USD da sua equipe em um único comando, e alchemy usage timeseries detalha esse uso por network, app, method ou request type. A mesma CLI gerencia seus apps, allowlists e webhooks.

Verificar o uso não exige mais abrir o Dashboard. Veja como funcionam os dois comandos de uso, como descobrir o que está gerando o compute, o que mais a CLI gerencia e como automatizar verificações de uso com scripts ou entregá-las a um agente de código.

Como verificar o uso de RPC pelo terminal?

Faça login uma vez e depois peça o resumo.

alchemy auth abre um navegador para você fazer login com sua conta Alchemy, e os comandos de uso reaproveitam esse login, então não há chave de API para copiar. Em uma máquina remota, um runner de CI ou uma sessão SSH, rode alchemy auth login --device-code e aprove o código curto em um navegador de qualquer dispositivo.

alchemy usage summary retorna três totais para sua equipe: mês até a data, últimos 7 dias e últimos 30 dias. Cada total vem em unidades de compute e em USD, ao lado do início e do fim do seu período de cobrança atual. A saída padrão é legível para humanos. Adicione --json quando um script ou outra ferramenta precisar dos números.

Comece pelo resumo para ter uma leitura rápida do período de cobrança. Quando um número estiver mais alto do que você esperava, a série temporal mostra de onde ele veio.

Como ver qual app, network ou method está gerando o uso?

alchemy usage timeseries divide o uso em intervalos diários ou horários. Ele exige uma data de início e agrupa por até três dimensões: app, network, method e requestType.

Os filtros restringem os dados antes do agrupamento. Cada um aceita valores separados por vírgula, e eles se combinam com AND.

--app-ids filtra por app, e os request types são http, websocket, webhook e grpc. A série temporal reporta apenas unidades de compute, então os totais em USD vêm de usage summary.

O quanto a série temporal alcança no passado depende do seu plano, e uma requisição cobre no máximo 30 dias.

Se você pedir uma data de início anterior, a CLI a ajusta ao limite do seu plano e mostra tanto o intervalo solicitado quanto o retornado. Quando um total dispara, agrupe primeiro por method e depois filtre pelo app e pela network que enviaram essas chamadas.

O que mais você pode gerenciar com a Alchemy CLI?

A CLI cobre o trabalho de conta e infraestrutura que, de outra forma, você faria clicando no Alchemy Dashboard.

• Liste apps e escolha um padrão. alchemy app list e alchemy app select <id>
• Crie um app. alchemy app create --name <name> --networks <ids>
• Restrinja um app. alchemy app networks, alchemy app origin-allowlist, alchemy app ip-allowlist e alchemy app address-allowlist
• Gerencie webhooks. alchemy webhook list e alchemy webhook create --body <json>
• Verifique sua configuração. alchemy auth status e alchemy doctor

Comandos que alteram um app ou um webhook aceitam --dry-run, para que você possa visualizar uma mudança antes de aplicá-la. Os comandos de webhook também precisam de uma chave de API de webhook do Dashboard, que você define uma vez com alchemy config set webhook-api-key <key>. Nossa página de Alchemy Webhooks explica o que cada tipo de webhook monitora.

A CLI também lê dados de chain e envia transações. alchemy evm data balance vitalik.eth e alchemy evm block latest retornam resultados sem precisar de um script, e as Agent Wallets para a Alchemy CLI adicionam assinatura e envio. Para o restante da superfície de comandos, veja 12 coisas que você pode fazer mais rápido com a Alchemy CLI.

Criar um app, restringir o que ele aceita e verificar o uso que ele gera podem acontecer em uma única sessão de terminal.

Como automatizar verificações de uso com scripts ou entregá-las a um agente?

Duas flags globais tornam qualquer comando seguro para automação. --json imprime saída estruturada (a saída encaminhada por pipe muda para JSON automaticamente), e --no-interactive impede que a CLI fique esperando um prompt.

Uma verificação de orçamento para cron ou CI é uma única expressão jq. Esta sai com status 1 assim que o gasto do mês até a data passa de 500 USD.

Agentes de código que executam comandos no terminal, como Claude Code, Cursor e Codex, podem chamar os mesmos comandos. Entregue primeiro ao agente as instruções da própria CLI.

A saída lista a árvore de comandos, os métodos de autenticação, os códigos de erro com orientação sobre novas tentativas e exemplos executáveis, prontos para colocar no system prompt de um agente. Também oferecemos outras duas superfícies para agentes. As Agent Skills ensinam um agente a escrever chamadas de API da Alchemy em código, e o Alchemy MCP Server em https://mcp.alchemy.com/mcp dá a ele dados de chain e gerenciamento de apps dentro da conversa. Nosso anúncio do MCP server cobre a configuração para cada cliente.

O MCP server expõe os mesmos dados de uso como duas ferramentas, get_usage_summary e get_usage_time_series. Um agente conectado a ele no Cursor, no Claude Code ou no Codex pode consultar uso e custo no meio da conversa, sem rodar a CLI.

Um agente que consegue ler o uso pode sinalizar um pico de custo enquanto ainda está trabalhando no código que o causou.

Como instalar a Alchemy CLI?

Instale pelo npm, faça login e rode sua primeira verificação de uso.

Se a CLI já estiver instalada, o mesmo comando a atualiza. alchemy doctor aponta o que estiver faltando na sua configuração e imprime o comando que corrige o problema. A seção de uso da documentação da CLI lista todas as flags e filtros.

Perguntas frequentes

Existe uma CLI para gerenciar infraestrutura de blockchain e verificar o uso de RPC?

Sim. A Alchemy CLI gerencia apps, allowlists e webhooks da Alchemy pelo terminal, e alchemy usage summary mostra o uso do mês até a data, dos últimos 7 dias e dos últimos 30 dias em unidades de compute e USD. alchemy usage timeseries detalha o uso por network, app, method ou request type. Instale com npm i -g @alchemy/cli@latest.

Como verifico meu uso de unidades de compute da Alchemy pela linha de comando?

Instale a Alchemy CLI, faça login com alchemy auth e rode alchemy usage summary. O comando retorna os totais do mês até a data, dos últimos 7 dias e dos últimos 30 dias em unidades de compute e USD para sua equipe. Adicione --json para obter saída estruturada que você pode encaminhar para o jq, um dashboard ou um alerta.

Posso ver o uso de RPC por method, network ou app?

Sim. alchemy usage timeseries --start-date <date> --group-by method agrupa o uso por method, e você pode agrupar por até três entre app, network, method e requestType ao mesmo tempo. Filtros como --networks, --methods, --app-ids e --request-types restringem os dados primeiro. Escolha intervalos horários ou diários com --granularity.

Quanto tempo para trás posso consultar o uso com a Alchemy CLI?

A série temporal de uso cobre 1 dia para trás no plano Gratuito, 7 dias no Pay as You Go e até 90 dias no Enterprise, quando habilitado para sua equipe. Cada requisição cobre no máximo 30 dias. Se você pedir um início anterior, a Alchemy CLI o ajusta ao limite do seu plano e mostra o intervalo que retornou.

Agentes de código com IA podem verificar o uso com a Alchemy CLI?

Sim. Qualquer agente que execute comandos no terminal, incluindo Claude Code, Cursor e Codex, pode chamar alchemy --json --no-interactive usage summary e ler o resultado em JSON. Rodar alchemy --json --no-interactive agent-prompt dá ao agente a árvore de comandos completa, os métodos de autenticação e os códigos de erro, para que ele chame a Alchemy CLI corretamente, sem tentativa e erro. Agentes conectados ao Alchemy MCP Server também podem usar as ferramentas get_usage_summary e get_usage_time_series.

Comece a verificar o uso pelo seu terminal

Instale a CLI e rode alchemy usage summary para ver como está o mês. Ela faz login com a conta que você já usa no Dashboard, os comandos de uso não precisam de chave de API e funcionam em todos os planos. Novo na Alchemy? Crie uma conta gratuita no Alchemy Dashboard e depois aponte a CLI para ela com alchemy auth.