---
title: "Dados de uso agora são consultáveis na Alchemy CLI"
description: "Extraia os dados de compute e custo da sua equipe pelo terminal com alchemy usage summary e alchemy usage timeseries. Os mesmos dados estão disponíveis para agentes de IA através do Alchemy MCP Server."
---

# Dados de uso agora são consultáveis na Alchemy CLI

<ImageBlock
  src="https://media.alchemy.com/usage-data.png"
  alt="Dados de Uso no Alchemy CLI"
  width={1920}
  height={900}
  priority
/>

Os dados de uso agora podem ser consultados na [Alchemy CLI](https://www.alchemy.com/docs/alchemy-cli#usage). Você pode puxar os dados de compute e custo da sua equipe, tanto os totais quanto o detalhamento ao longo do tempo, direto do terminal. Os mesmos dados estão disponíveis para agentes de IA através do [Alchemy MCP Server](https://www.alchemy.com/docs/alchemy-mcp-server), então um agente consegue ver o que sua equipe está consumindo sem precisar de uma integração personalizada.

Até agora, verificar o uso significava entrar no [Dashboard](https://dashboard.alchemy.com/) e ler os gráficos manualmente. Não havia uma forma programática de primeira classe para acessar os números. Agora há.

## O que você pode fazer

Dois comandos cobrem a maior parte do que você vai precisar.

- `alchemy usage summary` dá os totais do mês até a data, dos últimos 7 dias ou dos últimos 30 dias, tanto em unidades de compute quanto em USD.
- `alchemy usage timeseries` dá os mesmos números plotados ao longo do tempo, para que você veja quando o tráfego e o gasto mudaram.

Ambos são renderizados como um gráfico legível no seu terminal. Adicione `--json` e você recebe saída estruturada, pronta para ser encaminhada a um script, um dashboard ou um alerta.

<CodeSnippet
  language="bash"
  code={`alchemy usage summary
alchemy usage timeseries`}
/>

Para saída legível por máquina:

<CodeSnippet
  language="bash"
  code={`alchemy usage summary --json
alchemy usage timeseries --json`}
/>

## Fatie os dados do mesmo jeito que o Dashboard faz

Você pode agrupar o uso por network, app, method ou request type, e filtrar por qualquer um deles, respondendo perguntas como qual app está gerando mais compute ou qual method teve um pico durante a noite. Escolha granularidade horária ou diária com `--granularity`. Isso tem paridade total com a visão de uso do Dashboard, que continua sendo a fonte visual de referência.

Alguns exemplos:

<CodeSnippet
  language="bash"
  code={`alchemy usage summary --metrics amount,usd
alchemy usage timeseries --group-by network --granularity day
alchemy usage summary --app-ids <id> --methods eth_getLogs`}
/>

## Dê aos seus agentes consciência de uso

Os mesmos dados de uso são expostos através do Alchemy MCP Server como duas tools: `get_usage_summary` e `get_usage_time_series`. Aponte um agente para o seu MCP server e ele pode raciocinar sobre consumo e custo como parte do seu contexto, de modo que um agente monitorando sua infraestrutura também sabe quanto essa infraestrutura está custando.

Se você já conectou o MCP server ao Cursor, Claude Code ou Codex — veja o [guia de configuração do MCP](https://www.alchemy.com/docs/alchemy-mcp-server) ou nosso [anúncio do MCP](/blog/alchemy-mcp-server) — essas tools aparecem junto com o resto da superfície do Alchemy. Combine-as com [Agent Skills](https://www.alchemy.com/docs/alchemy-agent-skills) se você quiser que seu agente saiba como chamar APIs do Alchemy em código; o MCP é o que dá a ele dados de uso ao vivo na conversa.

## Para quem isso é

Se você está construindo agentes ou só quer visibilidade programática e scriptável do que sua equipe consome, isso é para você. Monitore o gasto enquanto desenvolve. Conecte o uso ao contexto de um agente. Construa seu próprio dashboard de custo ou um alerta de orçamento. Descubra qual network, app ou method é responsável por um salto no compute. Tudo isso agora mora onde você já trabalha.

## Como começar

Certifique-se de estar no Node 22 ou posterior, e então instale ou atualize a CLI:

<CodeSnippet
  language="bash"
  code={`npm install -g @alchemy/cli`}
/>

Depois rode `alchemy usage summary` e você já está vendo seus números. Veja a [documentação de uso](https://www.alchemy.com/docs/alchemy-cli#usage) para flags e filtros, ou o nosso passo a passo [12 coisas que você pode fazer mais rápido com a Alchemy CLI](/blog/12-things-faster-with-alchemy-cli) para conhecer toda a superfície de comandos.

Ter uso na CLI e no MCP server é mais um passo em direção a uma plataforma que agentes e desenvolvedores podem operar diretamente. Atualize a CLI, rode um comando, e nos conte o que você gostaria de ver a seguir.