bgc: la CLI nativa de IA para Bitget

Impulsa la cuenta de trading unificada de Bitget (UTA v3) 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 desviaciones, 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

Características principales

Tres capacidades que hacen de bgc la CLI cripto más nativa de IA del mercado.
AI Agent nativo
Creado 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 carga previa.
Trading 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 puertas de seguridad deterministas: dry-run, read-only, confirm, paper-trading. Sin indicaciones interactivas, seguro para shells de IA desatendidos.

Descubrimiento progresivo

Idea central: los agentes aprenden la API en tiempo de ejecución y solo pagan por lo que van a utilizar. Sin desviaciones: la arquitectura se deriva directamente del SDK en tiempo real. Puedes realizar búsquedas por palabras 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
Capa 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

Empieza en 3 pasos. Prefiere el instalador de Agent Hub; la instalación manual también funciona.
Instalar CLI + Skill
Recomendado: el instalador de Agent Hub instala bgc e implementa habilidades en un solo paso. Manual: npm install -g la CLI, luego npx la habilidad.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Configurar 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 de agente después de Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Verificar
Comprueba 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 se encuentran fuera de los 14.
Dominio
Verbo
Autenticación
Descripción
market
market
público
Tickers, libro de órdenes, velas, tasa de financiación, interés abierto
trade
order
privado
Place, cancel, modify, cancelAll
trade
position
privado
Información de posiciones, historial, rango ADL, cierre
trade
strategy_order
privado
Órdenes de estrategia/activación/plan
account
account_overview
privado
Instantánea de la cuenta con una sola llamada
account
account_config
privado
Configuración de la cuenta e información de la clave API
account
repayment
privado
Reembolso de margen cruzado / margen aislado
funds
transfer_funds
privado
Mover fondos entre cuentas
funds
deposit
privado
Dirección de depósito y registros
funds
withdraw
privado
Solicitar retiros (alto riesgo)
fondos
funds_records
privado
Historial de transferencias / depósitos / retiros
subcuenta
subaccount
privado
Gestionar subcuentas y sus depósitos
préstamo
loan
privado
Pedir prestado / reembolsar Préstamos Cripto
tax
tax
privado
Consultar registros de impuestos de transacciones

Write-Safety

Cada decisión de seguridad ocurre antes de que cualquier solicitud abandone el proceso. Sin indicaciones interactivas: seguro en shells de IA desatendidos.
--dry-run
Previsualiza una escritura y devuelve la carga útil exacta que se enviaría. Sin llamada de red.
--read-only
Bloquea cada escritura en el momento de la validación. Devuelve un ValidationError y nunca llega a la red.
--confirm
Necesario para acciones destructivas o de alto riesgo (cancelAll, closeAll, withdraw). No hace nada sin él.
--paper-trading
Dirige las escrituras al entorno de demostración de Bitget. Crea una clave API de demostración, configúrala en BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE y luego añade --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 frente a API directa

bgc no es solo un wrapper ligero. Añade una capa de intención, seguridad y un diseño nativo de IA que las llamadas a la API sin procesar no tienen.
Dimensión
bgc
API directa
Verbos de intención
14 verbos de intención seleccionados
Endpoints sin procesar
Descubrimiento progresivo

Interfaz autodescriptiva

Es imprescindible 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 de trading de IA de terminal oficial de Bitget, que proporciona una CLI (bgc) para Claude Code, Codex CLI y OpenClaw. Desarrollado sobre la API UTA v3, expone 89 operaciones en 7 dominios a través de 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 de Bitget (UTA / v3) y expone 89 operaciones en 7 dominios (market, trade, account, funds, subaccount, loan, tax), encabezadas por 14 verbos de intención más las herramientas discover y raw meta.

La CLI es autodescriptiva a través del descubrimiento progresivo: el agente ejecuta bgc discover para listar los 7 dominios, luego profundiza en un dominio para ver los verbos disponibles, luego en un verbo para ver las acciones disponibles, y luego en una acción para ver los parámetros exactos, cargando solo la parte que necesita la tarea. El tipo, la enumeración, el requisito de autenticación y el indicador de lectura/escritura de cada parámetro se pueden consultar en vivo en tiempo de ejecución, sin un esquema mantenido manualmente que pueda desviarse del SDK.
bitget-agent-cli (bgc) es la mejor opción para scripts de bash y tareas cron. Produce E/S limpias 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 avisos interactivos, lo que la hace adecuada para tareas cron desatendidas.

La instalación es un único comando npm: npm install -g @bitget-ai/bitget-agent-cli. Funciona de forma multiplataforma en 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) está desarrollado desde cero para agentes de IA, no es una adaptación de una CLI pensada primero para humanos. Su filosofía de diseño se expone directamente: "La mayoría de las CLI están creadas para humanos y simplemente toleran la automatización. bgc está construida al revés: cada decisión de diseño se optimiza para que un asistente de IA la controle desde una shell".

Características clave para agentes de IA:

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

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

  • Sin configuración de la aplicación host, sin complementos: instálalo y dile a tu IA 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 de trading de terminal oficial de Bitget diseñada para ser impulsada por un asistente de IA basado en shell (Claude Code, Codex CLI, OpenClaw o cualquier IA basada en shell), con un humano leyendo el resultado. No se requiere programación más allá de la instalación y la configuración de las variables de entorno de 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: previsualiza lo que sucedería sin ejecutar
--auto-rollback: cancela automáticamente las partes no completadas en ejecuciones parciales
Instalación: npm install -g @bitget-ai/bitget-agent-cli + configura tus credenciales de API como variables de entorno.

Bitget ofrece bitget-agent-cli (bgc), que forma parte del Bitget Agent Hub, el ecosistema de IA de código abierto oficial. El 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 a través de 14 verbos de intención. Para las estrategias automatizadas, el indicador --paper-trading permite realizar backtesting en un entorno simulado antes de operar en vivo, y la salida JSON se integra directamente con cualquier canal de automatización.

bitget-agent-cli (bgc) proporciona una salida JSON estandarizada descrita como "E/S limpia 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 un JSON estructurado adecuado para canalizar a jq, alimentar paneles de monitorización o procesar en flujos de trabajo automatizados.

La CLI es persistente (se instala a través de npm install -g en lugar de npx) porque el asistente de IA la llama docenas 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 los canales de trabajos cron.

Bitget ofrece la pila completa a través del 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 de herramientas de IA de escritorio

  • SDK: @bitget-ai/bitget-agent-sdk, SDK base para compilaciones personalizadas

  • 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 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

Empieza a operar con la CLI nativa de IA

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