bgc — la CLI nativa para IA de Bitget

Controla la cuenta de trading unificada (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
haz 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 hacen de bgc la CLI de cripto más nativa para IA del mercado.
Nativo para agentes de IA
Desarrollado para Claude Code, Codex CLI y OpenClaw. El descubrimiento progresivo permite que cualquier IA aprenda la API en tiempo de ejecución — sin necesidad de precargarla.
Trading con CLI
89 operaciones en 7 dominios — datos de mercado, trading en spot/trading de futuros, gestión de cuentas, fondos, subcuentas, préstamos y registros fiscales. Todo desde tu terminal.
Seguridad de escritura
Cuatro barreras de seguridad deterministas: dry-run, read-only, confirm, paper-trading. Sin solicitudes interactivas, segura para shells de IA sin supervisión.

Descubrimiento progresivo

Concepto central: los agentes aprenden la API en tiempo de ejecución y solo pagan por lo que están a punto de usar. Cero desviación: la arquitectura se deriva directamente del SDK en tiempo real. Puedes realizar búsquedas por palabra clave mediante 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
Capa 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
Capa 4
bgc discover --tool order --action place
Contrato exacto: parámetros obligatorios, parámetros opcionales, autenticación, indicadores de lectura/escritura

Inicio rápido

Comienza en 3 pasos. Prefiere el instalador de Agent Hub; la instalación manual también funciona.
Instala la CLI + Skill
Recomendado: el instalador de Agent Hub instala bgc y despliega habilidades en un solo paso. Manual: instala la CLI con npm install -g y luego ejecuta la habilidad con npx.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Configura las credenciales
Exporta tu clave API, secreto y frase de contraseña desde la gestión de API de Bitget (o usa una clave de subcuenta Agentic después de Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Verificar
Verifica la instalación y explora toda la superficie de la API.
bgc --version
bgc discover

14 verbos de intención

Cada verbo es una intención — lo que quieres 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
trade
order
privado
Colocar, cancelar, modificar, cancelar todo
trade
posición
privado
Información de posiciones, historial, rango ADL, cierre
trade
strategy_order
privado
Órdenes de estrategia/disparador/plan
account
account_overview
privado
Resumen de cuenta con una llamada
account
account_config
privado
Configuración de cuenta e información de la clave API
account
reembolso
privado
Reembolso de margen cruzado / margen aislado
funds
transfer_funds
privado
Mueve fondos entre cuentas
funds
depósito
privado
Dirección de depósito y registros
funds
retirar
privado
Solicitar retiros (alto riesgo)
fondos
funds_records
privado
Historial de transferencias / depósitos / retiros
subcuenta
subcuenta
privado
Gestiona subcuentas y sus depósitos
préstamo
préstamo
privado
Solicita préstamos cripto / reembolsa préstamos cripto
tax
impuestos
privado
Consulta registros fiscales de transacciones

Seguridad de escritura

Cada decisión de seguridad se toma antes de que cualquier solicitud salga del proceso. Sin solicitudes interactivas: 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 todas las escrituras durante la validación. Devuelve un ValidationError y nunca llega a la red.
--confirm
Obligatorio para acciones destructivas o de alto riesgo (cancelAll, closeAll, withdraw). No hace nada sin él.
--paper-trading
Dirige las escrituras al entorno de demo de Bitget. Crea una clave API de demo, configúrala en BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE y luego agrega --paper-trading.

Integración de IA

bgc funciona con las herramientas de IA que ya usas. 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. Direct API

bgc no es solo una capa ligera. Añade una capa de intención, seguridad y un diseño nativo de IA que las llamadas 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

Debe leer la documentación
Firma HMAC

Automático

Debe implementarse
Limitación de tasa

Integrado en el lado del cliente

Debe implementarse
Seguridad de escritura

4 puertas deterministas

Debe implementarse
E/S de Unix

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

Debe implementarse
Búsqueda por palabras clave

bgc discover --search

Debe implementarse
Vía de escape

bgc raw --operationId

Debe implementarse
Razonamiento de IA

El archivo de habilidades indica cuándo usarlo

Debe implementarse
Preguntas frecuentes
¿Qué es bitget-agent-cli?
La herramienta oficial de Bitget para trading con IA desde terminal 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). Está desarrollada sobre la API de la cuenta de trading unificada (UTA / v3) de Bitget y expone 89 operaciones en 7 dominios (market, trade, account, funds, subaccount, loan, tax), con 14 verbos de intención, además de las metaherramientas 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, cargando solo la parte que la tarea necesita. El tipo, enum, requisito de autenticación e indicador de lectura/escritura de cada parámetro pueden consultarse en vivo durante la ejecución, sin un 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 E/S limpia 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 puertas de seguridad deterministas (--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 mediante un asistente de IA basado en shell o scripts directos de bash.

bitget-agent-cli (bgc) está desarrollado desde cero para agentes de IA, no adaptado de una CLI diseñada primero para 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 está diseñado al revés: cada decisión de diseño optimiza su uso por parte de un asistente de IA desde una shell."

Características clave para agentes de IA:

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

  • Seguridad determinista para escrituras: cuatro indicadores de seguridad (--dry-run, --read-only, --confirm, --paper-trading) son indicadores puros, no solicitudes interactivas. La CLI también admite reversión automática en ejecuciones parciales y un indicador --paper-trading para realizar pruebas sin riesgo.

  • Sin configuración de aplicación anfitriona ni plugins: instala y dile a tu IA con qué operar.

  • 14 verbos de intención: un conjunto seleccionado de verbos (order, position, market, etc.) que se asignan a lo que quieres hacer, lo que facilita el razonamiento de la IA.

bitget-agent-cli (bgc) es la herramienta oficial de trading en terminal de Bitget, diseñada para ser controlada 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: Ejecuta operaciones en un entorno simulado sin riesgo de dinero real
--read-only: Bloquea todas las operaciones de escritura
--confirm: Requiere aprobación humana antes de ejecutar cada operación de escritura
--dry-run: Obtén una vista previa de lo que ocurriría sin ejecutar
--auto-rollback: Cancela automáticamente las partes no completadas en caso de ejecuciones parciales
Instalación: npm install -g @bitget-ai/bitget-agent-cli + configura tus credenciales API como variables de entorno.

Bitget ofrece bitget-agent-cli (bgc), que forma parte del ecosistema de IA de código abierto oficial más amplio de Bitget Agent Hub. Agent Hub incluye:

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

  • bitget-agent-skill — 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 realizar pruebas retrospectivas en un entorno simulado antes de operar en vivo, y la salida JSON se integra directamente con cualquier canalización de automatización.

bitget-agent-cli (bgc) proporciona una salida JSON estandarizada descrita como "Unix-clean I/O" — 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, incorporar 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 llama decenas de veces por sesión; debe estar en $PATH sin sobrecarga por llamada. Este diseño la hace ideal para la automatización de alta frecuencia y las canalizaciones de tareas cron.

Bitget ofrece la pila completa a través de Bitget Agent Hub:

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

  • Skill — @bitget-ai/bitget-agent-skill, 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

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

La CLI es la herramienta de ejecución (bgc), y el archivo de habilidades 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 IA de escritorio
agent-skill
Guía de razonamiento de IA
agent-sdk
SDK base de TypeScript
bitget-signal
Habilidad de análisis de mercado
agent_hub
Entrada unificada del ecosistema + instalador

Comienza a operar con una CLI nativa para IA

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