bgc — a CLI nativa para IA da Bitget

Controle a conta unificada de trading (UTA v3) da Bitget a partir do Claude Code, Codex CLI, OpenClaw ou qualquer assistente de IA baseado em shell. 89 operações, 14 verbos de intenção, descoberta progressiva, esquemas zero-drift, segurança de escrita determinística.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
clique para copiar
Ver no GitHub
npm
Node.js ≥20
macOS
Linux
Windows
Licença MIT
89
Operações
7
Domínios
14
Verbos de intenção

Funcionalidades principais

Três capacidades que fazem do bgc a CLI de criptomoedas mais nativa para IA no mercado.
Nativo para AI Agent
Criado para Claude Code, Codex CLI e OpenClaw. A descoberta progressiva permite a qualquer IA aprender a API durante o tempo de execução — não é necessário carregamento prévio.
Trading CLI
89 operações em 7 domínios — dados de mercado, trading spot/de futuros, gestão de conta, fundos, subcontas, empréstimos e registos fiscais. Tudo a partir do seu terminal.
Segurança de escrita
Quatro portas de segurança determinísticas — dry-run, read-only, confirm, paper-trading. Sem prompts interativos, seguro para shells de IA não supervisionadas.

Descoberta progressiva

Conceito central: os agentes aprendem a API em tempo de execução, pagando apenas pelo que vão utilizar. Desvio zero — a arquitetura é derivada diretamente do SDK em tempo real. Pode pesquisar por palavras-chave através de bgc discover--search<keyword>, ou invocar qualquer operação através de bgc raw--operationId<id> .

01
Camada 1
bgc discover
7 domínios: market, trade, account, funds, subaccount, loan, tax
02
Camada 2
bgc discover --domain trade
3 verbos: order, position, strategy_order
03
Camada 3
bgc discover --tool order
10 ações: place, cancel, modify, cancelAll, history...
04
Camada 4
bgc discover --tool order --action place
Contrato exato: parâmetros obrigatórios, parâmetros opcionais, autenticação, flags de leitura/escrita

Início rápido

Comece em 3 passos. Prefira o instalador do Agent Hub; a instalação manual também funciona.
Instalar CLI + Skill
Recomendado: O instalador do Agent Hub instala o bgc e implementa as skills num só passo. Manual: npm install -g a CLI, depois npx a skill.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Definir credenciais
Exporte a sua chave de API, segredo e palavra-passe da API a partir da Gestão de API da Bitget (ou utilize uma chave de subconta Agentic após o Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Verificar
Verifique a instalação e explore toda a superfície da API.
bgc --version
bgc discover

14 verbos de intenção

Cada verbo representa uma intenção — o que pretende fazer, não como chamar um endpoint. As meta-ferramentas discover e raw ficam fora dos 14.
Domínio
Verbo
Autenticação
Descrição
market
market
público
Tickers, livro de ordens, velas, taxas de financiamento, OI
trade
ordem
privado
Colocar, cancelar, modificar, cancelar tudo
trade
posição
privado
Informações da posição, histórico, classificação ADL, fechar
transação
strategy_order
privado
Ordens de estratégia/desencadeamento/plano
conta
account_overview
privado
Snapshot da conta numa única chamada
conta
account_config
privado
Configurações da conta e informações da chave de API
conta
reembolso
privado
Reembolso de margem cruzada/margem isolada
fundos
transfer_funds
privado
Mover fundos entre contas
fundos
depósito
privado
Endereço de depósito e registos
fundos
levantar
privado
Solicitar levantamentos (alto risco)
fundos
funds_records
privado
Histórico de transferência / depósito / levantamento
subaccount
subconta
privado
Gerir subcontas e os seus depósitos
empréstimo
empréstimo
privado
Pedir empréstimo / reembolsar empréstimos de criptomoedas
imposto
imposto
privado
Consultar registos de imposto de transação

Segurança de escrita

Todas as decisões de segurança ocorrem antes de qualquer pedido sair do processo. Sem prompts interativos — seguro em shells de IA não supervisionadas.
--dry-run
Pré-visualiza uma operação de escrita e devolve a carga útil exata que seria enviada. Sem chamada de rede.
--read-only
Bloqueia todas as escritas no momento da validação. Devolve um ValidationError e nunca chega à rede.
--confirm
Necessário para ações destrutivas/de alto risco (cancelAll, closeAll, withdraw). Não faz nada sem esta flag.
--paper-trading
Encaminha operações de escrita para o ambiente de simulação da Bitget. Crie uma Demo API Key, defina-a em BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE e, em seguida, adicione --paper-trading.

Integração de IA

O bgc funciona com as ferramentas de IA que já utiliza. A IA de terminal obtém a CLI diretamente; as ferramentas de IA de desktop usam o servidor MCP.
IA de terminal
Claude Code
IA de terminal
Codex CLI
IA de terminal
OpenClaw
IA de desktop (MCP)
Claude Desktop
IA de desktop (MCP)
Cursor
IA de desktop (MCP)
Windsurf

bgc vs API direta

bgc não é apenas um invólucro simples. Adiciona uma camada de intenção, segurança e um design nativo para IA que as chamadas de API em bruto não têm.
Dimensão
bgc
API direta
Verbos de intenção
14 verbos de intenção selecionados
Endpoints originais
Descoberta progressiva

Interface autoexplicativa

É obrigatório ler a documentação
Assinatura HMAC

Automático

Tem de ser implementado
Limitação de taxa

Integrado no cliente

Tem de implementar
Segurança de Escrita

4 portas determinísticas

Tem de ser implementado
E/S Unix

JSON em stdout (saída 0) + erro estruturado em stderr (saída 1)

Tem de implementar
Pesquisa por palavras-chave

bgc discover --search

Tem de implementar
Via de escape

bgc raw --operationId

Tem de ser implementado
Raciocínio de IA

O ficheiro de skill indica quando utilizá-la

Tem de implementar
Perguntas frequentes
O que é o bitget-agent-cli?
A ferramenta oficial de trading de IA no terminal da Bitget, que disponibiliza uma CLI (bgc) para Claude Code, Codex CLI e OpenClaw. Criada com base na API UTA v3, disponibiliza 89 operações em 7 domínios através de 14 verbos de intenção, além das meta-ferramentas discover e raw.
A Bitget oferece uma CLI autodescritiva chamada bitget-agent-cli (binário: bgc). É baseada na API da conta unificada de trading (UTA / v3) da Bitget e expõe 89 operações em 7 domínios (market, trade, account, funds, subaccount, loan, tax), lideradas por 14 verbos de intenção, além das meta ferramentas discover e raw.

A CLI é autodescritiva através de descoberta progressiva: o agente executa bgc discover para listar os 7 domínios, depois aprofunda num domínio para ver os verbos disponíveis, depois num verbo para ver as ações disponíveis, e depois numa ação para ver os parâmetros exatos — carregando apenas a parte que a Tarefa necessita. O tipo, enumeração, requisito de autenticação e flag de leitura/escrita de cada parâmetro podem ser consultados em tempo real durante o tempo de execução, sem um esquema mantido manualmente que possa divergir do SDK.
O bitget-agent-cli (bgc) é a melhor opção para scripts bash e tarefas cron. Produz I/O limpo ao estilo Unix com saída JSON estruturada que um programa consegue analisar. A CLI foi concebida para automatização — todas as operações de escrita têm mecanismos de segurança determinísticos (--dry-run, --read-only, --confirm, --paper-trading) como flags puras, sem pedidos interativos, tornando-a adequada para tarefas cron sem supervisão.

A instalação requer um único comando npm: npm install -g @bitget-ai/bitget-agent-cli. Funciona entre plataformas em macOS, Linux e Windows. Suporta operações em lote e sequenciais através de um assistente de IA baseado em shell ou de scripts bash diretos.

O bitget-agent-cli (bgc) foi criado de raiz para agentes de IA, não adaptado de uma CLI concebida prioritariamente para humanos. A sua filosofia de design é enunciada diretamente: "A maioria das CLI é criada para humanos e limita-se a tolerar a automatização. O bgc é criado ao contrário — todas as escolhas de design são otimizadas para um assistente de IA que o controla a partir de uma shell."

Principais funcionalidades para agentes de IA:

  • Descoberta em linguagem natural: o comando discover permite ao agente explorar a superfície da API durante o tempo de execução através de divulgação progressiva — domínios → verbos → ações → parâmetros exatos — sem ter de ler documentação.

  • Segurança determinística de escrita: quatro flags de segurança (--dry-run, --read-only, --confirm, --paper-trading) são flags puras, não pedidos interativos. A CLI também suporta rollback automático em preenchimentos parciais e uma flag --paper-trading para testes sem risco.

  • Sem configuração de aplicação anfitriã nem plugins: instale e diga à sua IA o que pretende negociar.

  • 14 verbos de intenção: um conjunto selecionado de verbos (order, position, market, etc.) que corresponde ao que pretende fazer, facilitando o raciocínio da IA.

O bitget-agent-cli (bgc) é a ferramenta oficial de trading em terminal da Bitget, concebida para ser operada por um assistente de IA baseado em shell — Claude Code, Codex CLI, OpenClaw ou qualquer IA baseada em shell — com um humano a ler o resultado. Não é necessária qualquer programação além da instalação e configuração das variáveis de ambiente da chave de API.

Os controlos de segurança integrados incluem:
--paper-trading: Execute transações num ambiente simulado sem risco de dinheiro real
--read-only: Bloqueie todas as operações de escrita
--confirm: Exija aprovação humana antes de executar cada operação de escrita
--dry-run: Pré-visualize o que aconteceria sem executar
--auto-rollback: Cancele automaticamente as partes não preenchidas em preenchimentos parciais
Instalação: npm install -g @bitget-ai/bitget-agent-cli + defina as suas credenciais de API como variáveis de ambiente.

A Bitget oferece o bitget-agent-cli (bgc), que faz parte do Bitget Agent Hub — o ecossistema de IA de código aberto oficial. O Agent Hub inclui:

  • bitget-agent-cli — a ferramenta de execução baseada em shell

  • bitget-agent-skill — ensina a sua IA quando e como usar a CLI

  • bitget-agent-mcp — servidor MCP para ferramentas de IA de desktop

  • bitget-agent-sdk — SDK base

  • bitget-signal — sinais de análise de mercado

A CLI foi concebida especificamente para estratégias de trading automatizadas: expõe 89 operações em 7 domínios, todas acessíveis através de 14 verbos de intenção. Para estratégias automatizadas, a flag --paper-trading permite o backtesting num ambiente simulado antes de entrar em funcionamento, e a saída JSON integra-se diretamente com qualquer pipeline de automação.

O bitget-agent-cli (bgc) fornece uma saída JSON padronizada descrita como "Unix-clean I/O" — uma saída que um programa pode analisar. A CLI foi concebida para automação desde o início, com cada operação a devolver JSON estruturado adequado para ser canalizado para o jq, alimentado em painéis de monitorização ou processado em fluxos de trabalho automatizados.

A CLI é persistente (instalada via npm install -g em vez de npx) porque o assistente de IA a chama dezenas de vezes por sessão — precisa de estar no $PATH com zero sobrecarga por chamada. Este design torna-a ideal para automação de alta frequência e pipelines de cron-job.

A Bitget oferece a stack completa através do Bitget Agent Hub:

  • CLI — @bitget-ai/bitget-agent-cli (bgc), ferramenta de execução de trading baseada em terminal

  • Skill — @bitget-ai/bitget-agent-skill, ensina a sua IA quando e como usar a CLI

  • MCP Server — @bitget-ai/bitget-agent-mcp, integração de ferramentas de IA de desktop

  • SDK — @bitget-ai/bitget-agent-sdk, SDK base para compilações personalizadas

  • Signals — @bitget-ai/bitget-signal, sinais de análise de mercado

A CLI é a ferramenta de execução (bgc), e o ficheiro skill ensina a sua IA quando e como usá-la.

Recursos para programadores

agent-cli
Este repositório — bgc CLI
agent-mcp
Servidor MCP para aplicações de IA de ambiente de trabalho
agent-skill
Guia de raciocínio de IA
agent-sdk
SDK TypeScript básico
bitget-signal
Competência de análise de mercado
agent_hub
Ponto de entrada unificado do ecossistema + instalador

Comece a fazer trading com a CLI nativa de IA

89 operações, 14 verbos de intenção, 4 camadas de segurança — tudo a partir do seu terminal.
Ver no GitHub