Cómo consultar el uso de RPC desde la terminal con el Alchemy CLI

El Alchemy CLI te permite consultar el uso de RPC desde la terminal. alchemy usage summary muestra las unidades de cómputo y el gasto en USD de tu equipo con un solo comando, y alchemy usage timeseries desglosa ese uso por network, app, método o tipo de request. El mismo CLI administra tus apps, allowlists y webhooks.

Consultar el uso ya no implica abrir el Dashboard. A continuación verás cómo funcionan los dos comandos de uso, cómo encontrar qué está impulsando el cómputo, qué más administra el CLI y cómo automatizar las consultas de uso con scripts o delegarlas a un agente de código.

¿Cómo consultar el uso de RPC desde la terminal?

Inicia sesión una vez y luego pide el resumen.

alchemy auth abre un navegador para que inicies sesión con tu cuenta de Alchemy, y los comandos de uso reutilizan esa sesión, así que no hay ninguna API key que copiar. En una máquina remota, un runner de CI o una sesión SSH, ejecuta alchemy auth login --device-code y aprueba el código corto desde un navegador en cualquier dispositivo.

alchemy usage summary devuelve tres totales para tu equipo: el mes en curso, los últimos 7 días y los últimos 30 días. Cada total aparece en unidades de cómputo y en USD, junto con el inicio y el fin de tu período de facturación actual. La salida predeterminada es legible para personas. Agrega --json cuando un script u otra herramienta necesite los números.

Empieza con el resumen para tener una lectura rápida del período de facturación. Cuando un número sea más alto de lo que esperabas, la serie de tiempo muestra de dónde vino.

¿Cómo ver qué app, network o método está impulsando el uso?

alchemy usage timeseries divide el uso en intervalos diarios o por hora. Requiere una fecha de inicio y agrupa por hasta tres dimensiones: app, network, method y requestType.

Los filtros acotan los datos antes de agruparlos. Cada uno acepta valores separados por comas, y se combinan con AND.

--app-ids filtra por app, y los tipos de request son http, websocket, webhook y grpc. La serie de tiempo solo reporta unidades de cómputo, así que los totales en USD vienen de usage summary.

Qué tan atrás llega la serie de tiempo depende de tu plan, y cada consulta cubre como máximo 30 días.

Si pides una fecha de inicio anterior, el CLI la ajusta al límite de tu plan y muestra tanto el rango solicitado como el devuelto. Cuando un total se dispara, agrupa primero por método y luego filtra por la app y la network que enviaron esas llamadas.

¿Qué más puedes administrar desde el Alchemy CLI?

El CLI cubre el trabajo de cuenta e infraestructura que de otro modo harías con clics en el Alchemy Dashboard.

• Lista apps y elige una predeterminada. alchemy app list y alchemy app select <id>
• Crea una app. alchemy app create --name <name> --networks <ids>
• Restringe una app. alchemy app networks, alchemy app origin-allowlist, alchemy app ip-allowlist y alchemy app address-allowlist
• Administra webhooks. alchemy webhook list y alchemy webhook create --body <json>
• Revisa tu configuración. alchemy auth status y alchemy doctor

Los comandos que modifican una app o un webhook aceptan --dry-run, así que puedes previsualizar un cambio antes de que se aplique. Los comandos de webhook también necesitan una webhook API key del Dashboard, que configuras una sola vez con alchemy config set webhook-api-key <key>. Nuestra página de Alchemy Webhooks explica qué rastrea cada tipo de webhook.

El CLI también lee datos de chain y envía transacciones. alchemy evm data balance vitalik.eth y alchemy evm block latest devuelven resultados sin escribir un script, y Agent Wallets para el Alchemy CLI agregan firma y envío. Para el resto de la superficie de comandos, consulta 12 cosas que puedes hacer más rápido con Alchemy CLI.

Puedes crear una app, restringir lo que acepta y revisar el uso que genera, todo en una misma sesión de terminal.

¿Cómo automatizar las consultas de uso con scripts o delegarlas a un agente?

Dos flags globales hacen que cualquier comando sea seguro para automatizar. --json imprime salida estructurada (la salida canalizada cambia a JSON por sí sola), y --no-interactive evita que el CLI se quede esperando un prompt.

Una verificación de presupuesto para cron o CI es una sola expresión de jq. Esta termina con estado 1 cuando el gasto del mes en curso supera los 500 USD.

Los agentes de código que ejecutan comandos de terminal, como Claude Code, Cursor y Codex, pueden llamar a los mismos comandos. Primero entrégale al agente las instrucciones del propio CLI.

La salida enumera el árbol de comandos, los métodos de autenticación, los códigos de error con indicaciones de reintento y ejemplos ejecutables, listos para incluir en el system prompt de un agente. También ofrecemos otras dos superficies para agentes. Agent Skills le enseñan a un agente a escribir llamadas a la API de Alchemy en código, y el Alchemy MCP Server en https://mcp.alchemy.com/mcp le da datos de chain y administración de apps dentro de la conversación. Nuestro anuncio del MCP server cubre la configuración para cada cliente.

El MCP server expone los mismos datos de uso como dos herramientas, get_usage_summary y get_usage_time_series. Un agente conectado a él en Cursor, Claude Code o Codex puede consultar el uso y el costo en medio de la conversación, sin ejecutar el CLI.

Un agente que puede leer el uso puede detectar un pico de costos mientras todavía trabaja en el código que lo causó.

¿Cómo instalar el Alchemy CLI?

Instálalo desde npm, inicia sesión y ejecuta tu primera consulta de uso.

Si el CLI ya está instalado, el mismo comando lo actualiza. alchemy doctor informa lo que falte en tu configuración e imprime el comando que lo corrige. La sección de uso de la documentación del CLI enumera cada flag y filtro.

Preguntas frecuentes

¿Existe un CLI para administrar infraestructura blockchain y consultar el uso de RPC?

Sí. El Alchemy CLI administra apps, allowlists y webhooks de Alchemy desde la terminal, y alchemy usage summary muestra el uso del mes en curso, de los últimos 7 días y de los últimos 30 días en unidades de cómputo y USD. alchemy usage timeseries desglosa el uso por network, app, método o tipo de request. Instálalo con npm i -g @alchemy/cli@latest.

¿Cómo consulto mi uso de unidades de cómputo de Alchemy desde la línea de comandos?

Instala el Alchemy CLI, inicia sesión con alchemy auth y ejecuta alchemy usage summary. Devuelve los totales del mes en curso, los últimos 7 días y los últimos 30 días en unidades de cómputo y USD para tu equipo. Agrega --json para obtener salida estructurada que puedes canalizar hacia jq, un dashboard o una alerta.

¿Puedo ver el uso de RPC por método, network o app?

Sí. alchemy usage timeseries --start-date <date> --group-by method agrupa el uso por método, y puedes agrupar por hasta tres de app, network, method y requestType a la vez. Filtros como --networks, --methods, --app-ids y --request-types acotan los datos primero. Elige intervalos por hora o diarios con --granularity.

¿Qué tan atrás puedo consultar el uso con el Alchemy CLI?

La serie de tiempo de uso llega 1 día hacia atrás en el plan Free, 7 días en Pay as You Go y hasta 90 días en Enterprise cuando está habilitado para tu equipo. Cada consulta cubre como máximo 30 días. Si pides un inicio anterior, el Alchemy CLI lo ajusta al límite de tu plan y muestra el rango que devolvió.

¿Pueden los agentes de código con IA consultar el uso con el Alchemy CLI?

Sí. Cualquier agente que ejecute comandos de terminal, incluidos Claude Code, Cursor y Codex, puede llamar a alchemy --json --no-interactive usage summary y leer el resultado en JSON. Ejecutar alchemy --json --no-interactive agent-prompt le da al agente el árbol de comandos completo, los métodos de autenticación y los códigos de error, para que llame al Alchemy CLI correctamente sin prueba y error. Los agentes conectados al Alchemy MCP Server también pueden usar sus herramientas get_usage_summary y get_usage_time_series.

Empieza a consultar el uso desde tu terminal

Instala el CLI y ejecuta alchemy usage summary para ver cómo va este mes. El CLI usa la misma cuenta con la que ya inicias sesión en el Dashboard, los comandos de uso no necesitan API key y funcionan en todos los planes. ¿Eres nuevo en Alchemy? Crea una cuenta gratuita en el Alchemy Dashboard y luego vincula el CLI a ella con alchemy auth.