Bitget MCP Server
Servidor MCP oficial da Bitget para negociação de criptomoedas, dados de mercado e gerenciamento de portfólio por meio de linguagem natural.
Documentação
Bitget Agent Hub — Ecossistema Oficial de Negociação com IA e Dados de Mercado da Bitget
O kit de ferramentas oficial de código aberto que conecta Claude, Cursor, Codex, ChatGPT e qualquer agente de IA compatível com MCP à sua conta Bitget e aos dados de mercado.
Início Rápido · Ecossistema · Instalador · Ferramentas de Negociação · Ferramentas de Mercado · Arquitetura · Segurança · FAQ
Visão Geral
Bitget Agent Hub é o kit oficial de Agentes de IA da Bitget, cobrindo negociação de criptomoedas e ações dos EUA tokenizadas — levando 89 operações Bitget UTA v3 de negociação e análise de mercado para Claude, Cursor, Codex, ChatGPT e outros agentes de IA.
Feito para traders individuais, desenvolvedores quantitativos e qualquer pessoa que queira operar uma exchange de criptomoedas por meio de linguagem natural.
Este repositório é o ponto de entrada central de todo o ecossistema. Consulte os repositórios de cada pacote para documentação detalhada.
Início Rápido
O Que Você Quer Fazer?
What do you want to do with AI?
|
+-- Let an AI Agent trade on Bitget for me
| |
| +-- Terminal AI (Claude Code / Codex CLI / OpenClaw)
| | -> install agent-cli + agent-skill
| |
| +-- Desktop AI (Claude Desktop / Cursor / Continue)
| -> install agent-mcp
|
+-- Let an AI Agent monitor and analyze the market for me
| -> install bitget-signal (no account, no API key)
|
+-- I'm a developer building my own Bitget AI tool
-> install bitget-agent-sdk
Instale com Sua IA
A árvore de casos de uso acima indica qual pacote você precisa. Para configurar as ferramentas de terminal de uma só vez, cole o seguinte no seu terminal de IA (Claude Code, Codex, OpenClaw):
Please run `npx @bitget-ai/bitget-agent-installer upgrade-all --target all` to set up the Bitget Agent Hub terminal tools (requires Node.js 20+), then help me verify the install.
Isso instala a CLI bgc além das habilidades de negociação e sinais de mercado, e implanta as habilidades no Claude Code, Codex e OpenClaw. IA de desktop (Cursor, Claude Desktop, ChatGPT) usa bitget-agent-mcp — veja Ferramentas de Negociação. Para comandos por pacote, rollback e flags, veja Instalador abaixo.
Ecossistema
O Bitget Agent Hub consiste em 5 pacotes principais, cada um com uma única responsabilidade. Este repositório também inclui a meta-ferramenta bitget-agent-installer, que instala e atualiza todos juntos.
Ferramentas de Negociação (Requer Chave de API)
| Pacote | Ideal Para | O Que Faz |
|---|---|---|
bitget-agent-sdk | Desenvolvedores | SDK TypeScript base com 89 operações UTA v3 |
bitget-agent-cli | Terminal de IA | Ferramenta de linha de comando bgc para Claude Code, Codex, OpenClaw |
bitget-agent-mcp | IA de desktop | Servidor MCP para Claude Desktop, Cursor, Windsurf, ChatGPT |
bitget-agent-skill | Terminal de IA | Guia de raciocínio de IA que ensina como usar bgc corretamente |
Ferramentas de Mercado (Sem Necessidade de Conta)
| Pacote | O Que Faz |
|---|---|
bitget-signal | 5 habilidades de análise de mercado — macro, on-chain, sentimento, técnica, notícias |
Todos os pacotes têm licença MIT e são gratuitos. Podem ser instalados lado a lado sem conflitos.
Instalador
@bitget-ai/bitget-agent-installer é a meta-ferramenta do ecossistema. Um único comando instala, atualiza, faz rollback e implanta os pacotes do Bitget Agent Hub nas suas ferramentas de IA — sem precisar instalar cada pacote e executar a configuração de cada habilidade manualmente.
npx @bitget-ai/bitget-agent-installer
Execute sem argumentos para um menu interativo, ou passe um comando diretamente (veja abaixo).
O Que Ele Gerencia
| Pacote | Função |
|---|---|
bitget-agent-cli | A CLI de negociação de terminal bgc |
bitget-agent-skill | Guia de raciocínio de negociação para terminal de IA |
bitget-signal | Habilidades de análise de mercado (sem chave de API) |
IA de desktop usa
bitget-agent-mcp, que é registrado na configuração do seu cliente MCP em vez de instalado globalmente — configure-o diretamente pelo pacote MCP.bitget-agent-sdké uma dependência de biblioteca e não requer instalação separada.
Por Que Usar
- Um único comando para todo o ecossistema — instale, atualize ou faça rollback de todos os pacotes juntos.
- Sempre atualizado — resolve automaticamente a versão publicada mais recente de cada pacote; nada para fixar, então versões diferentes entre pacotes funcionam sem problemas.
- Implantação de habilidades integrada — conecta as habilidades diretamente no Claude Code, Codex e OpenClaw via
--target. - Reversível — faça rollback de qualquer pacote para uma versão publicada anteriormente.
- Seguro para pré-visualizar —
--dry-runimprime todos os comandos sem executá-los. - Leve — um único script sem dependências executado com
npx; detecta automaticamente npm ou pnpm.
Comandos
| Comando | O Que Faz |
|---|---|
| (sem argumentos) | Menu interativo — atualizar, fazer rollback ou implantar habilidades |
upgrade-all [--target <tools>] | Instala ou atualiza todos os pacotes gerenciados para as versões mais recentes |
upgrade <pkg> [--target <tools>] | Instala ou atualiza um pacote para a versão mais recente |
rollback <pkg> --to <version> | Alterna um pacote para uma versão publicada específica |
install [pkg] [--target <tools>] | Implanta as habilidades de um pacote já instalado nas suas ferramentas de IA |
Flags
--target <tools>— onde implantar habilidades:claude,codex,openclaw,all(separados por vírgula; padrão:claude)--dry-run— pré-visualiza comandos sem executá-los--version·--help
Exemplos
# Install everything and deploy skills to every supported AI tool
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
# Update just the CLI to the latest version
npx @bitget-ai/bitget-agent-installer upgrade @bitget-ai/bitget-agent-cli
# Roll the CLI back to the pre-v3 release
npx @bitget-ai/bitget-agent-installer rollback @bitget-ai/bitget-agent-cli --to 1.2.0
# Deploy already-installed market-signal skills into Claude Code and Codex
npx @bitget-ai/bitget-agent-installer install @bitget-ai/bitget-signal --target claude,codex
# Preview an upgrade without changing anything
npx @bitget-ai/bitget-agent-installer upgrade-all --target all --dry-run
Ferramentas de Negociação
Deixe um Agente de IA Negociar na Bitget Automaticamente por Você
As ferramentas de negociação do Bitget Agent Hub expõem 89 operações UTA v3 por meio de 14 verbos de intenção selecionados:
| Pergunte à Sua IA | O Que Ela Faz |
|---|---|
| "Compre 0,1 BTC ao preço de mercado" | Ordem spot a mercado |
| "Abra uma posição longa de BTC, alavancagem de 10x" | Posição futura |
| "Verifique meu saldo" | Visão geral da conta |
| "Transfira USDT para futuros" | Transferência interna de fundos |
| "Cancele todas as ordens abertas" | Cancelamento em lote |
Escolha Seu Ambiente de IA
| Onde Sua IA Vive… | Pacote Instalado |
|---|---|
| Terminal de IA: Claude Code, Codex CLI, OpenClaw | bitget-agent-cli + bitget-agent-skill |
| IA de desktop: Claude Desktop, Cursor, Continue, Windsurf, ChatGPT Desktop | bitget-agent-mcp |
Comece Agora
- Crie uma Chave de API Bitget em bitget.com/api-management
- Execute o assistente do instalador ou siga a documentação de cada pacote
- Verifique a instalação perguntando à sua IA: "Quais ferramentas Bitget estão disponíveis?"
É a primeira vez? Crie uma Chave de API de Demonstração e use
--paper-tradingpara praticar antes de tocar em fundos reais.
Ferramentas de Mercado
Deixe um Agente de IA Monitorar e Analisar o Mercado em Tempo Real
bitget-signal adiciona 5 habilidades de análise de mercado — sem conta Bitget, sem chave de API:
| Pergunte à Sua IA | Habilidade |
|---|---|
| "Como a política do Fed está afetando o BTC?" | macro-analyst |
| "As baleias estão movendo ativos on-chain?" | market-intel |
| "O mercado está com medo ou ganância?" | sentiment-analyst |
| "O RSI do BTC está sobrecomprado?" | technical-analysis |
| "O que é importante em cripto hoje?" | news-briefing |
Comece Agora
npx @bitget-ai/bitget-signal --target all
Reinicie sua ferramenta de IA e pergunte sobre as condições do mercado.
Próximos Lançamentos
Sinais exclusivos da Bitget:
top-trader-flow: Posicionamento dos líderes de copy-tradingderivatives-structure: Base de perpétuos e estrutura de prazoslarge-flow-detect: Detecção de ordens do tamanho de baleias
Arquitetura
graph TD
subgraph Surfaces
A[bitget-agent-cli<br/>Terminal AI]
B[bitget-agent-mcp<br/>Desktop AI MCP]
C[bitget-agent-skill<br/>AI Reasoning Guide]
end
subgraph Foundation
D[bitget-agent-sdk<br/>TypeScript SDK]
end
subgraph MarketAnalysis
E[bitget-signal<br/>5 Analysis Skills]
end
A --> D
B --> D
C --> A
D --> F[Bitget UTA v3 API]
E --> G[Public Market-Data MCP<br/>no API key]
style D fill:#f9f,stroke:#333,stroke-width:2px
style F fill:#bbf,stroke:#333,stroke-width:2px
Como funciona:
- SDK (
bitget-agent-sdk): Camada base com 89 operações, assinatura HMAC, limitação de taxa - CLI (
bitget-agent-cli): Ferramenta de linha de comando para terminal construída sobre o SDK - MCP (
bitget-agent-mcp): Servidor de IA para desktop construído sobre o SDK - Skill (
bitget-agent-skill): Ensina o terminal de IA a usar a CLI corretamente - Signal (
bitget-signal): Análise de mercado independente por meio de um serviço MCP público de dados de mercado sem chave
Operações Suportadas
Com base na API Bitget UTA v3 — 89 operações por meio de 14 verbos de intenção selecionados:
| Módulo | Padrão | Verbos de Intenção | Requer Chave de API |
|---|---|---|---|
| market | ✅ | market | Não (dados públicos) |
| trade | ✅ | order, position, strategy_order | Sim |
| account | ✅ | account_overview, transfer_funds, … | Sim |
| strategy | — | via raw | Sim |
| cryptoloans | — | loan | Sim |
| tax | — | tax | Sim |
strategy_order é controlado pelo módulo trade — colocar ordens de estratégia é uma capacidade de negociação que um agente espera sempre que a negociação estiver habilitada; as demais operações do módulo strategy permanecem acessíveis por meio de raw.
Além disso, meta-ferramentas: discover (explorar operações) e raw (chamar qualquer operação por operationId).
Navegue pelo catálogo ao vivo a qualquer momento com bgc discover (ou discover em qualquer superfície).
Segurança
Proteção de Credenciais
- ✅ Nunca sai da sua máquina: chaves de API lidas somente de variáveis de ambiente
- ✅ Assinatura local: todas as solicitações autenticadas são assinadas com HMAC-SHA256 em processo
- ✅ Sem análise de
.env: as ferramentas não leem arquivos.envpara evitar vazamentos - ✅ Sem proxy: conexão direta à API oficial da Bitget
Modos de Segurança
--read-only: remove todas as ferramentas de escrita na inicialização — a IA não pode colocar ordens nem transferências--paper-trading: direciona ao ambiente de Demonstração da Bitget — sem fundos reais envolvidos- Limitação de taxa: limitação integrada no lado do cliente evita abuso da API
Melhores Práticas
- Use primeiro uma Chave de API de Demonstração para testes
- Comece com o modo
--read-onlypara verificar consultas - Nunca envie credenciais para controle de versão
- Gire as chaves de API a cada 90 dias
Documentação
| Tópico | Documento |
|---|---|
| Começando | docs/getting-started.md |
| Arquitetura do ecossistema | docs/architecture.md |
Referências por pacote — flags da CLI, configuração do cliente MCP, API do SDK, habilidades de sinal — ficam no repositório de cada pacote (veja a tabela Ecossistema acima). A superfície de ferramentas ao vivo é sempre navegável com bgc discover (ou discover em qualquer superfície).
Links
- Bitget: bitget.com
- Documentação da API: bitget.com/api-doc
- Model Context Protocol: modelcontextprotocol.io
- Todos os repositórios de IA da Bitget: github.com/Bitget-AI
FAQ
O que é o Bitget Agent Hub?
O Bitget Agent Hub é o ecossistema oficial de código aberto de Agentes de IA da Bitget. Ele conecta as capacidades de negociação de criptomoedas da Bitget e os dados de mercado em tempo real a agentes de IA como Claude, Cursor, Codex e ChatGPT — cobrindo 89 operações UTA v3 por meio de 14 verbos de intenção selecionados, além de habilidades de análise de mercado sem necessidade de conta.
Como sei qual pacote instalar?
Depende da sua ferramenta de IA:
- Terminal de IA (Claude Code, Codex) →
bitget-agent-cli+bitget-agent-skill - IA de desktop (Claude Desktop, Cursor) →
bitget-agent-mcp - Somente análise de mercado →
bitget-signal(sem chave de API) - Desenvolvedor criando ferramentas personalizadas →
bitget-agent-sdk
Posso usar IA para negociar criptomoedas automaticamente?
Sim. Após a instalação, você pode dizer a ferramentas de IA compatíveis para "comprar 0,1 BTC" ou "abrir uma posição longa de BTC com alavancagem de 10x" e a IA executará diretamente na sua conta Bitget. Use o modo --paper-trading para ensaiar com segurança.
É seguro conectar minha chave de API?
Sim. As credenciais são:
- Lidas somente de variáveis de ambiente
- Nunca passadas por nenhum servidor intermediário
- Assinadas localmente com HMAC-SHA256
- Nunca registradas em log nem gravadas em disco
Como evito ordens acidentais?
Adicione --read-only na inicialização. Todas as ferramentas de escrita são removidas completamente — a IA não pode vê-las nem chamá-las.
Quais ferramentas de IA são compatíveis?
Claude Desktop, Claude Code, Cursor, Codex CLI, Continue, Windsurf, ChatGPT Desktop, OpenClaw e qualquer cliente compatível com MCP.
É gratuito?
Todos os pacotes têm licença MIT e são gratuitos. bitget-signal é mantido pela Bitget e gratuito — sem chave de API, sem conta.
Como atualizo tudo?
Execute npx @bitget-ai/bitget-agent-installer e escolha atualizar, ou:
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Contribuindo
Issues e pull requests são bem-vindos.
- Relate bugs ou solicite recursos: GitHub Issues
- Problemas de segurança: envie um e-mail para security@bitget.com (não publique publicamente)
Licença
Licença MIT — Gratuita para uso pessoal e comercial. Atribuição é apreciada, mas não obrigatória.
⚠️ Aviso de Risco: Negociar criptomoedas e ações tokenizadas envolve risco substancial. Você é o único responsável por qualquer ordem que seu agente de IA colocar em seu nome. Sempre use os modos --read-only e --paper-trading para ensaiar com segurança antes de entrar ao vivo.
Bitget Agent Hub é um projeto oficial de código aberto da Bitget · Parte do ecossistema de IA da Bitget · Feito para traders, desenvolvedores e entusiastas de IA