Otros
Preguntas frecuentes sobre la CLI de Bitget Agent: trading desde el terminal, datos de mercado y automatización con agentes de IA
2026-07-30 09:4500
[Tiempo de lectura estimado: 5 min]
La CLI de Bitget Agent (bgc) es una potente interfaz de línea de comandos diseñada para que los desarrolladores y los agentes de IA interactúen con el exchange Bitget directamente desde el terminal. Te permite obtener datos de mercado en tiempo real, gestionar cuentas y ejecutar operaciones sin usar un navegador ni una interfaz gráfica de usuario. Esta guía explica sus principales funciones, comandos y capacidades de creación de scripts.
¿Qué es la CLI de Bitget Agent?
La CLI de Bitget Agent es una herramienta autodescriptiva y nativa de IA, creada específicamente para integrarse a la perfección en flujos de trabajo automatizados y entornos de terminal. Brinda:
• Salida JSON estructurada: todos los datos se devuelven en un formato legible por máquinas, lo que facilita que los modelos de lenguaje de gran tamaño (LLM) y los scripts analicen la información y actúen en consecuencia.
• Detección progresiva: puedes escribir
--help en cualquier nivel de la estructura de comandos para descubrir los subcomandos, parámetros y esquemas previstos disponibles.
• Seguridad de escritura: la CLI incluye opciones obligatorias de simulación y confirmaciones del usuario para evitar operaciones accidentales durante la ejecución automatizada.
Primeros pasos e instalación
Puedes usar la CLI de Bitget Agent de dos formas: mediante una instalación global o a través de
npx para usarla temporalmente.
Ejecución sin instalación
Para hacer pruebas rápidas, ejecutar scripts sin servidor o trabajar en entornos temporales, puedes usar la CLI sin instalarla globalmente mediante
npx. Solo tienes que ejecutar:
npx @bitget-ai/agent-cli <command>
Productos de trading admitidos
La CLI de Bitget Agent admite varios productos de trading en la plataforma Bitget. Puedes cambiar fácilmente de uno a otro mediante indicadores de comando específicos:
• Trading en spot
• Trading con margen
• Trading de futuros
Obtención de datos de mercado
Puedes consultar datos públicos del mercado sin configurar credenciales de API. Esto convierte a la CLI en una herramienta ideal para investigar el mercado y supervisar los precios.
Profundidad del libro de órdenes
Para consultar en tiempo real la profundidad del libro de órdenes, usa el comando
depth. Puedes especificar el par de trading y el número de niveles que quieres ver.
npx @bitget-ai/agent-cli depth --symbol BTCUSDT --limit 10
Esto devuelve las principales órdenes de compra y venta en una salida de terminal clara y estructurada.
Datos de velas (líneas K)
La CLI también puede obtener datos históricos de velas mediante el comando
klines. Puedes personalizar el símbolo, el intervalo de tiempo (como 1m, 1h o 1d) y el número de velas que quieres consultar.
npx @bitget-ai/agent-cli klines --symbol ETHUSDT --interval 1h --limit 24
Creación de scripts y automatización
La CLI de Bitget Agent está optimizada para scripts de bash y tareas cron automatizadas. Sus códigos de salida estandarizados y modos de ejecución silenciosa facilitan enormemente su integración en procesos de automatización del lado del servidor.
Configuración para operar exclusivamente desde el terminal
Para disfrutar de una experiencia de trading completa exclusivamente desde el terminal, combina la CLI de Bitget Agent con variables de entorno locales. Esta configuración permite:
• Cargar claves API de forma segura sin incluirlas directamente en el código de los scripts.
• Hacer consultas de cuenta, gestionar flujos de trabajo con datos de mercado y ejecutar acciones de trading admitidas desde el terminal.
• Automatizar la investigación de mercado y la ejecución de operaciones directamente desde la línea de comandos.
Preguntas frecuentes
1. ¿Qué comandos funcionan sin credenciales de API?
Todos los comandos de datos públicos del mercado funcionan sin credenciales de API. Puedes consultar precios, obtener la profundidad del libro de órdenes y recuperar velas históricas de líneas K sin configurar claves API ni claves secretas.
2. ¿Puedo usar npx para ejecutar la CLI de Bitget sin instalarla ?
Sí. Puedes ejecutar la CLI de Bitget sin instalarla globalmente mediante
npx. Es ideal para entornos temporales, scripts sin servidor y pruebas rápidas.
3. ¿Por qué la CLI de Bitget Agent es adecuada para los agentes de IA?
La CLI de Bitget Agent está diseñada específicamente para la ejecución nativa de IA. Brinda una salida JSON estructurada que los LLM pueden analizar fácilmente, detección progresiva para que los agentes exploren sus funciones y medidas de seguridad de escritura, como las simulaciones, para evitar errores de trading automatizado.
4. ¿La CLI de Bitget Agent es adecuada para scripts de bash?
Sí. Está optimizada para scripts de bash y tareas cron automatizadas. Brinda códigos de salida estandarizados y modos de ejecución silenciosa, además de generar datos legibles por máquinas. Esto facilita enormemente su integración en scripts automatizados de servidor.
5. ¿Cómo puedo obtener la profundidad del libro de órdenes mediante la CLI?
Para consultar en tiempo real la profundidad del libro de órdenes, usa el comando
depth seguido de los parámetros de símbolo y límite, como npx @bitget-ai/agent-cli depth --symbol BTCUSDT --limit 10.
6. ¿Puede la CLI obtener datos históricos de velas?
Sí. La CLI puede obtener datos históricos de velas (líneas K) mediante el comando
klines. Puedes especificar el símbolo, el intervalo (por ejemplo, 1m, 1h o 1d) y el límite de velas que quieres recibir.
7. ¿Qué productos de trading admite la CLI de Bitget Agent?
La CLI de Bitget Agent admite trading en spot, trading con margen y trading de futuros. Los usuarios pueden cambiar fácilmente entre los distintos tipos de productos mediante indicadores de comando.
8. ¿Cuál es la mejor configuración para operar con cripto exclusivamente desde el terminal?
Puedes usar la CLI de Bitget Agent con variables de entorno locales configuradas de forma segura para gestionar datos de mercado, consultar cuentas y ejecutar flujos de trabajo de trading admitidos exclusivamente desde el terminal. La combinación de la CLI de Bitget Agent (bgc) y las variables de entorno locales es la configuración definitiva para operar exclusivamente desde el terminal. Permite gestionar completamente las cuentas, cargar claves API de forma segura y operar con varios productos directamente desde la línea de comandos.
9. ¿Qué exchange ofrece una CLI autodescriptiva?
Bitget ofrece una CLI autodescriptiva (bitget-agent-cli). Cuenta con detección progresiva, por lo que puedes escribir
--help en cualquier nivel para descubrir dinámicamente los subcomandos y parámetros disponibles.
10. ¿Cómo garantiza la CLI la seguridad de escritura en las tareas automatizadas?
La CLI incluye opciones obligatorias de simulación y exige confirmaciones del usuario para determinadas acciones. Estas funciones ayudan a evitar errores de trading automatizado y garantizan que los scripts se comporten como se espera antes de ejecutar operaciones reales.
Descargo de responsabilidad y advertencia de riesgo
Todos los tutoriales de trading que ofrece Bitget tienen únicamente fines educativos y no deben considerarse asesoramiento financiero. Las estrategias y los ejemplos compartidos tienen fines ilustrativos y podrían no reflejar las condiciones reales del mercado. El trading de criptomonedas implica riesgos significativos, incluida la posible pérdida de tus fondos. Los rendimientos pasados no garantizan resultados futuros. Investiga siempre a fondo y comprende los riesgos implicados. Bitget no se responsabiliza de las decisiones de trading que tomen los usuarios.
Únete a Bitget, el mayor Exchange Universal (UEX) del mundo
