bgc — la CLI nativa para IA de Bitget

Operá la Cuenta Unificada de Trading (UTA v3) de Bitget desde Claude Code, Codex CLI, OpenClaw o cualquier asistente de IA basado en shell. 89 operaciones, 14 verbos de intención, descubrimiento progresivo, esquemas sin desalineación y seguridad de escritura determinista.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Hacé clic para copiar
Ver en GitHub
npm
Node.js ≥20
macOS
Linux
Windows
Licencia MIT
89
Operaciones
7
Dominios
14
Verbos de intención

Funciones principales

Tres capacidades que convierten a bgc en la CLI de criptomonedas más nativa para IA del mercado.
Nativo para AI Agent
Desarrollada para Claude Code, Codex CLI y OpenClaw. El descubrimiento progresivo permite que cualquier IA aprenda la API durante el tiempo de ejecución — sin necesidad de precargar nada.
Trading con CLI
89 operaciones en 7 dominios — datos de mercado, trading en spot/contratos, gestión de cuentas, fondos, subcuentas, préstamos y registros fiscales. Todo desde tu terminal.
Seguridad de escritura
Cuatro controles de seguridad deterministas: dry-run, read-only, confirm y paper-trading. Sin mensajes interactivos, seguro para shells de IA sin supervisión.

Descubrimiento progresivo

Idea central: los agentes aprenden la API en tiempo de ejecución y solo pagan por lo que están a punto de usar. Sin sesgos: la arquitectura se deriva directamente del SDK en tiempo real. Podés realizar búsquedas por palabras clave con bgc discover--search<keyword> o invocar cualquier operación mediante bgc raw--operationId<id> .

01
Layer 1
bgc discover
7 dominios: market, trade, account, funds, subaccount, loan, tax
02
Layer 2
bgc discover --domain trade
3 verbos: order, position, strategy_order
03
Layer 3
bgc discover --tool order
10 acciones: place, cancel, modify, cancelAll, history...
04
Layer 4
bgc discover --tool order --action place
Contrato exacto: parámetros obligatorios, parámetros opcionales, autenticación, indicadores de lectura/escritura

Inicio rápido

Empezá en 3 pasos. Priorizá el instalador del Centro de Agentes; la instalación manual también funciona.
Instalá la CLI + Skill
Recomendado: el instalador del Centro de Agentes instala bgc y despliega skills en un solo paso. Manual: instalá la CLI con npm install -g y luego ejecutá el skill con npx.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Configurá las credenciales
Exportá tu clave API, secreto y contraseña desde la gestión de API de Bitget (o usá una clave de subcuenta Agentic después de Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Verificá
Verificá la instalación y explorá toda la API.
bgc --version
bgc discover

14 verbos de intención

Cada verbo es una intención — lo que querés hacer, no cómo llamar a un endpoint. Las metaherramientas discover y raw están fuera de los 14.
Dominio
Verbo
Autenticación
Descripción
market
market
público
Tickers, libro de órdenes, velas, tasa de financiación, OI
hacer trading
order
privado
Colocar, cancelar, modificar, cancelar todo
hacer trading
posición
privado
Información de posiciones, historial, rango ADL, cierre
trade
strategy_order
privado
Órdenes de estrategia/disparador/plan
account
account_overview
privado
Instantánea de cuenta con una sola llamada
cuenta
account_config
privado
Configuración de cuenta e información de la clave API
account
pago
privado
Reembolso de margen cruzado/margen aislado
fondos
transfer_funds
privado
Mové fondos entre cuentas
funds
deposit
privado
Dirección de depósito y registros
fondos
withdraw
privado
Solicitar retiros (alto riesgo)
fondos
funds_records
privado
Historial de transferencias / depósitos / retiros
subcuenta
subcuenta
privado
Administrá subcuentas y sus depósitos
préstamo
préstamo
privado
Pedí préstamos de criptomonedas / realizá pagos de préstamos de criptomonedas
fiscal
fiscal
privado
Consultá registros fiscales de transacciones

Seguridad de escritura

Todas las decisiones de seguridad se toman antes de que cualquier solicitud salga del proceso. Sin mensajes interactivos: seguro en shells de IA sin supervisión.
--dry-run
Previsualiza una escritura y devuelve la carga útil exacta que se enviaría. Sin llamada de red.
--read-only
Bloquea toda escritura durante la validación. Devuelve un ValidationError y nunca llega a la red.
--confirm
Requerido para acciones destructivas/de alto riesgo (cancelAll, closeAll, withdraw). No hace nada sin él.
--paper-trading
Dirige las escrituras al entorno demo de Bitget. Creá una Demo API Key, configurala en BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE y luego agregá --paper-trading.

Integración de IA

bgc funciona con las herramientas de IA que ya usás. La IA de terminal obtiene la CLI directamente; las herramientas de IA de escritorio usan el servidor MCP.
IA de terminal
Claude Code
IA de terminal
Codex CLI
IA de terminal
OpenClaw
IA de escritorio (MCP)
Claude Desktop
IA de escritorio (MCP)
Cursor
IA de escritorio (MCP)
Windsurf

bgc vs. API directa

bgc no es solo un wrapper liviano. Agrega una layer de intención, seguridad y un diseño nativo de IA que las calls de API sin procesar no tienen.
Dimensión
bgc
API directa
Verbos de intención
14 verbos de intención seleccionados
Endpoints originales
Descubrimiento progresivo

Interfaz autodescriptiva

Tenés que leer la documentación
Firma HMAC

Automático

Debe implementarse
Limitación de tasa

Integrado en el cliente

Se debe implementar
Seguridad de escritura

4 controles deterministas

Debe implementarse
Unix I/O

JSON en stdout (exit 0) + error estructurado en stderr (exit 1)

Se debe implementar
Búsqueda por palabras clave

bgc discover --search

Se debe implementar
Vía de escape

bgc raw --operationId

Debe implementarse
Razonamiento de IA

El archivo de habilidades indica cuándo usarlo

Se debe implementar
Preguntas frecuentes
¿Qué es bitget-agent-cli?
La herramienta oficial de Bitget para hacer trading con IA desde la terminal, que ofrece una CLI (bgc) para Claude Code, Codex CLI y OpenClaw. Desarrollada sobre la API UTA v3, expone 89 operaciones en 7 dominios mediante 14 verbos de intención, además de las metaherramientas discover y raw.
Bitget ofrece una CLI autodescriptiva llamada bitget-agent-cli (binario: bgc). Se basa en la API de Cuenta Unificada de Trading (UTA / v3) de Bitget y expone 89 operaciones en 7 dominios (market, comercio, cuenta, fondos, subcuenta, préstamo, fiscal), accesibles mediante 14 verbos de intención más las herramientas meta discover y raw.

La CLI es autodescriptiva mediante divulgación progresiva: el agente ejecuta bgc discover para enumerar los 7 dominios, luego profundiza en un dominio para ver los verbos disponibles, después en un verbo para ver las acciones disponibles y, por último, en una acción para ver los parámetros exactos; así, carga solo la parte que necesita la tarea. El tipo, enum, requisito de autenticación y marca de lectura/escritura de cada parámetro se pueden consultar en vivo durante el tiempo de ejecución, sin ningún esquema mantenido manualmente que pueda desalinearse del SDK.
bitget-agent-cli (bgc) es la mejor opción para scripts de bash y tareas cron. Produce I/O limpio al estilo Unix con salida JSON estructurada que un programa puede analizar. La CLI está diseñada para la automatización — cada operación de escritura tiene controles de seguridad determinísticos (--dry-run, --read-only, --confirm, --paper-trading) como indicadores puros, sin solicitudes interactivas, lo que la hace adecuada para tareas cron sin supervisión.

La instalación se realiza con un solo comando npm: npm install -g @bitget-ai/bitget-agent-cli. Funciona en múltiples plataformas: macOS, Linux y Windows. Admite operaciones por lotes y secuenciales a través de un asistente de IA basado en shell o scripts de bash directos.

bitget-agent-cli (bgc) fue desarrollado desde cero para agentes de IA, no adaptado a partir de una CLI centrada en humanos. Su filosofía de diseño se expresa directamente: "La mayoría de las CLI están diseñadas para humanos y apenas toleran la automatización. bgc se desarrolló al revés: cada decisión de diseño está optimizada para que un asistente de IA lo use desde una shell."

Funciones clave para agentes de IA:

  • Descubrimiento mediante lenguaje natural: El comando discover permite que el agente explore la superficie de la API durante el tiempo de ejecución mediante divulgación progresiva — dominios → verbos → acciones → parámetros exactos — sin necesidad de leer documentación.

  • Seguridad determinística de escritura: Cuatro indicadores de seguridad (--dry-run, --read-only, --confirm, --paper-trading) son indicadores puros, no solicitudes interactivas. La CLI también admite rollback automático en ejecuciones parciales y un indicador --paper-trading para pruebas sin riesgos.

  • Sin configuración de aplicación host ni plugins: Instalalo y decile a tu IA qué operar.

  • 14 verbos de intención: Un conjunto seleccionado de verbos (order, position, market, etc.) que se corresponde con lo que querés hacer y facilita el razonamiento de la IA.

bitget-agent-cli (bgc) es la herramienta oficial de Bitget para hacer trading desde la terminal, diseñada para ser operada por un asistente de IA basado en shell — Claude Code, Codex CLI, OpenClaw o cualquier IA basada en shell — con una persona revisando el resultado. No se requiere programación más allá de la instalación y la configuración de variables de entorno para la clave API.

Los controles de seguridad integrados incluyen:
--paper-trading: Ejecutá operaciones en un entorno simulado sin riesgo de dinero real
--read-only: Bloqueá todas las operaciones de escritura
--confirm: Requerí aprobación humana antes de ejecutar cada operación de escritura
--dry-run: Previsualizá lo que ocurriría sin ejecutar nada
--auto-rollback: Cancelá automáticamente las partes no completadas en ejecuciones parciales
Instalación: npm install -g @bitget-ai/bitget-agent-cli + configurá tus credenciales de API como variables de entorno.

Bitget ofrece bitget-agent-cli (bgc), que forma parte del amplio Centro de Agentes de Bitget, el ecosistema oficial de IA de código abierto. El Centro de Agentes incluye:

  • bitget-agent-cli — la herramienta de ejecución basada en shell

  • bitget-agent-skill — le enseña a tu IA cuándo y cómo usar la CLI

  • bitget-agent-mcp — servidor MCP para herramientas de IA de escritorio

  • bitget-agent-sdk — SDK base

  • bitget-signal — señales de análisis de mercado

La CLI está diseñada específicamente para estrategias de trading automatizadas: expone 89 operaciones en 7 dominios, todas accesibles mediante 14 verbos de intención. Para estrategias automatizadas, la opción --paper-trading permite hacer backtesting en un entorno simulado antes de operar en vivo, y la salida JSON se integra directamente con cualquier pipeline de automatización.

bitget-agent-cli (bgc) ofrece una salida JSON estandarizada, descrita como "I/O limpio de Unix": una salida que un programa puede analizar. La CLI está diseñada para la automatización desde cero, y cada operación devuelve JSON estructurado apto para canalizar a jq, enviar a paneles de monitoreo o procesar en flujos de trabajo automatizados.

La CLI es persistente (se instala mediante npm install -g en lugar de npx) porque el asistente de IA la invoca decenas de veces por sesión: debe estar en $PATH sin sobrecarga por llamada. Este diseño la hace ideal para automatización de alta frecuencia y pipelines de tareas cron.

Bitget ofrece el stack completo a través del Centro de Agentes de Bitget:

  • CLI — @bitget-ai/bitget-agent-cli (bgc), herramienta de ejecución de trading basada en terminal

  • Skill — @bitget-ai/bitget-agent-skill, le enseña a tu IA cuándo y cómo usar la CLI

  • Servidor MCP — @bitget-ai/bitget-agent-mcp, integración con herramientas de IA de escritorio

  • SDK — @bitget-ai/bitget-agent-sdk, SDK base para desarrollos personalizados

  • Señales — @bitget-ai/bitget-signal, señales de análisis de mercado

La CLI es la herramienta de ejecución (bgc), y el archivo de skill le enseña a tu IA cuándo y cómo usarla.

Recursos para desarrolladores

agent-cli
Este repositorio: bgc CLI
agent-mcp
Servidor MCP para aplicaciones de IA de escritorio
agent-skill
Guía de razonamiento con IA
agent-sdk
SDK básico de TypeScript
bitget-signal
Habilidad de análisis de mercado
agent_hub
Punto de acceso unificado al ecosistema + instalador

Empezá a tradear con una CLI nativa de IA

89 operaciones, 14 verbos de intención, 4 capas de seguridad — todo desde tu terminal.
Ver en GitHub