bgc — a CLI nativa de IA para a Bitget

Controle a Conta de Trading Unificada (UTA v3) da Bitget pelo Claude Code, Codex CLI, OpenClaw ou qualquer assistente de IA baseado em shell. 89 operações, 14 verbos de intenção, descoberta progressiva, esquemas sem divergência e segurança determinística de escrita.
$
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

Recursos Principais

Três recursos que tornam o bgc a CLI de cripto mais nativa de IA do mercado.
AI Agent Nativo
Criado para Claude Code, Codex CLI e OpenClaw. A descoberta progressiva permite que qualquer IA aprenda a API em tempo de execução — sem necessidade de pré-carregamento.
Trading por CLI
89 operações em 7 domínios — dados de mercado, trading de spot/futuros, gestão de conta, fundos, subcontas, empréstimos e registros fiscais. Tudo a partir do seu terminal.
Segurança de escrita
Quatro barreiras de segurança determinísticas — dry-run, read-only, confirm, paper-trading. Sem prompts interativos, seguro para shells de IA sem supervisão.

Descoberta progressiva

Ideia central: os agentes aprendem a API em tempo de execução e pagam apenas pelo que estão prestes a usar. Zero desvio — a arquitetura é derivada diretamente do SDK em tempo real. É possível pesquisar por palavras-chave com bgc discover--search<keyword> ou chamar qualquer operação com 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, sinalizadores de leitura/gravação

Início Rápido

Comece em 3 etapas. Prefira o instalador da Central Agent; a instalação manual também funciona.
Instale a CLI + Skill
Recomendado: o instalador da Central Agent instala o bgc e disponibiliza as skills em uma única etapa. Manual: instale a CLI com npm install -g e, em seguida, execute a skill com npx.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Configure as credenciais
Exporte sua chave de API, segredo e senha da Gestão de API da Bitget (ou use 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 todos os recursos da API.
bgc --version
bgc discover

14 verbos de intenção

Cada verbo é uma intenção — o que você deseja fazer, não como chamar um endpoint. As metaferramentas discover e raw ficam fora dos 14.
Domínio
Verbo
Autenticação
Descrição
market
market
público
Tickers, livro de ordens, candles, índice de financiamento, OI
trading
order
privado
Criar, cancelar, modificar, cancelarTudo
trading
posição
privado
Informações de posição, histórico, classificação ADL, fechar
trade
strategy_order
privado
Ordens de estratégia/acionar/plano
account
account_overview
privado
Snapshot da conta com uma chamada
conta
account_config
privado
Configurações da conta e informações da chave de API
account
pagamento
privado
Pagamento de margem cruzada / margem isolada
fundos
transfer_funds
privado
Transfira fundos entre contas
funds
deposit
privado
Endereço de depósito e registros
fundos
withdraw
privado
Solicitar saques (alto risco)
fundos
funds_records
privado
Histórico de transferências / depósitos / saques
subconta
subconta
privado
Gerencie subcontas e seus depósitos
empréstimo
empréstimo
privado
Tome empréstimos de cripto / pague empréstimos de cripto
tax
imposto
privado
Consulte registros fiscais de transações

Segurança de escrita

Todas as decisões de segurança ocorrem antes de qualquer solicitação sair do processo. Sem prompts interativos — seguro em shells de IA sem supervisão.
--dry-run
Visualiza uma gravação e retorna o payload exato que seria enviado. Nenhuma chamada de rede.
--read-only
Bloqueia todas as escritas durante a validação. Retorna um ValidationError e nunca chega à rede.
--confirm
Necessário para ações destrutivas / de alto risco (cancelAll, closeAll, withdraw). Não faz nada sem ele.
--paper-trading
Direciona as gravações para o ambiente de Simulador da Bitget. Crie uma chave de API de Simulador, 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 você já utiliza. A IA em terminal recebe a CLI diretamente; as ferramentas de IA para desktop usam o servidor MCP.
IA em terminal
Claude Code
IA em terminal
Codex CLI
IA de Terminal
OpenClaw
IA de Desktop (MCP)
Claude Desktop
IA para desktop (MCP)
Cursor
IA de Desktop (MCP)
Windsurf

bgc vs API Direta

bgc não é apenas uma camada superficial. Ele adiciona uma camada de intenção, segurança e design nativo para IA que chamadas brutas de API não oferecem.
Dimensão
bgc
API Direta
Verbos de intenção
14 verbos de intenção selecionados
Endpoints originais
Descoberta progressiva

Superfície autodescritiva

É necessário ler a documentação
Assinatura HMAC

Automático

Deve implementar
Limitação de taxa

Integrado no lado do cliente

Deve ser implementado
Segurança de Escrita

4 barreiras determinísticas

Deve implementar
Unix I/O

JSON stdout (exit 0) + erro estruturado stderr (exit 1)

Deve ser implementado
Pesquisa por palavra-chave

bgc discover --search

Deve ser implementado
Válvula de escape

bgc raw --operationId

Deve implementar
Raciocínio de IA

O arquivo de habilidade ensina quando usá-lo

Deve ser implementado
Perguntas frequentes
O que é o bitget-agent-cli?
A ferramenta oficial de trading de IA de terminal da Bitget, fornecendo uma CLI (bgc) para Claude Code, Codex CLI e OpenClaw. Construída na API UTA v3, ela expõe 89 operações em 7 domínios por meio de 14 verbos de intenção, além das metaferramentas discover e raw.
A Bitget oferece uma CLI autodescritiva chamada bitget-agent-cli (binário: bgc). Ela é baseada na API da Conta de Trading Unificada da Bitget (UTA / v3) e disponibiliza 89 operações em 7 domínios (market, trade, account, funds, subaccount, loan, tax), acessadas por 14 verbos de intenção, além das ferramentas de metadados discover e raw.

A CLI é autodescritiva por meio da descoberta progressiva: o agente executa bgc discover para listar os 7 domínios, depois explora um domínio para ver os verbos disponíveis, em seguida um verbo para ver as ações disponíveis e, então, uma ação para visualizar os parâmetros exatos — carregando apenas a parte necessária para a tarefa. O tipo, a enumeração, o requisito de autenticação e o indicador de leitura/escrita de cada parâmetro podem ser consultados em tempo de execução, sem nenhum esquema mantido manualmente que possa divergir do SDK.
O bitget-agent-cli (bgc) é a melhor opção para scripts bash e tarefas cron. Ele produz E/S no estilo Unix com saída JSON estruturada que um programa pode analisar. A CLI foi projetada para automação — cada operação de gravação possui portões de segurança determinísticos (--dry-run, --read-only, --confirm, --paper-trading) como sinalizadores puros sem prompts interativos, tornando-a adequada para tarefas cron não supervisionadas.

A instalação é um único comando npm: npm install -g @bitget-ai/bitget-agent-cli. Funciona em várias plataformas no macOS, Linux e Windows. Suporta operações em lote e sequenciais por meio de um assistente de IA baseado em shell ou script bash direto.

O bitget-agent-cli (bgc) foi criado do zero para agentes de IA, e não adaptado de uma CLI voltada para humanos. Sua filosofia de design é declarada diretamente: "A maioria das CLIs é criada para humanos e apenas tolera a automação. O bgc foi criado de forma inversa — cada escolha de design é otimizada para um assistente de IA executando-o a partir de um shell."

Principais recursos para agentes de IA:

  • Descoberta em linguagem natural: O comando discover permite que o agente explore a superfície da API em tempo de execução por meio de divulgação progressiva — domínios → verbos → ações → parâmetros exatos — sem precisar ler a documentação.

  • Segurança de gravação determinística: Quatro sinalizadores de segurança (--dry-run, --read-only, --confirm, --paper-trading) são sinalizadores puros, não prompts interativos. A CLI também suporta rollback automático em preenchimentos parciais e um sinalizador --paper-trading para testes sem risco.

  • Sem configuração de aplicativo host, sem plugins: Instale e diga à sua IA o que operar.

  • 14 verbos de intenção: Um conjunto selecionado de verbos (order, position, market, etc.) que mapeiam o que você deseja fazer, facilitando o raciocínio da IA.

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

Os controles de segurança integrados incluem:
--paper-trading: execute operações em um ambiente simulado, sem risco de perda 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: 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 suas credenciais de API como variáveis de ambiente.

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

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

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

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

  • bitget-agent-sdk — SDK base

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

A CLI foi desenvolvida especificamente para estratégias de trading automatizado: ela disponibiliza 89 operações em 7 domínios, todas acessíveis por meio de 14 verbos de intenção. Para estratégias automatizadas, o parâmetro --paper-trading permite realizar backtesting em um ambiente simulado antes de operar ao vivo, e a saída em JSON se integra diretamente a qualquer pipeline de automação.

O bitget-agent-cli (bgc) fornece saída JSON padronizada, descrita como "Unix-clean I/O" — uma saída que pode ser analisada por um programa. A CLI foi projetada para automação desde o início, com cada operação retornando JSON estruturado adequado para direcionamento ao jq, integração com painéis de monitoramento ou processamento 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 — ela precisa estar no $PATH sem sobrecarga por chamada. Esse design a torna ideal para automação de alta frequência e pipelines de tarefas cron.

A Bitget oferece a pilha completa por meio da Central Bitget Agent:

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

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

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

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

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

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

Recursos para desenvolvedores

agent-cli
Este repositório — bgc CLI
agent-mcp
Servidor MCP para IA de desktop
agent-skill
Guia de inferência de IA
agent-sdk
SDK base em TypeScript
bitget-signal
Habilidade de análise de mercado
agent_hub
Portal unificado do ecossistema + instalador

Comece a fazer trading com uma 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