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 - Official Bitget AI Trading and Market Data Ecosystem for Claude Cursor Codex ChatGPT

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.

Bitget Agent SDK npm version - foundation TypeScript library Model Context Protocol MCP compatible AI integration standard Requires Node.js version 20 or higher runtime environment MIT open source license - free for commercial use

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)

PacoteIdeal ParaO Que Faz
bitget-agent-sdkDesenvolvedoresSDK TypeScript base com 89 operações UTA v3
bitget-agent-cliTerminal de IAFerramenta de linha de comando bgc para Claude Code, Codex, OpenClaw
bitget-agent-mcpIA de desktopServidor MCP para Claude Desktop, Cursor, Windsurf, ChatGPT
bitget-agent-skillTerminal de IAGuia de raciocínio de IA que ensina como usar bgc corretamente

Ferramentas de Mercado (Sem Necessidade de Conta)

PacoteO Que Faz
bitget-signal5 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

PacoteFunção
bitget-agent-cliA CLI de negociação de terminal bgc
bitget-agent-skillGuia de raciocínio de negociação para terminal de IA
bitget-signalHabilidades 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-run imprime todos os comandos sem executá-los.
  • Leve — um único script sem dependências executado com npx; detecta automaticamente npm ou pnpm.

Comandos

ComandoO 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 IAO 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, OpenClawbitget-agent-cli + bitget-agent-skill
IA de desktop: Claude Desktop, Cursor, Continue, Windsurf, ChatGPT Desktopbitget-agent-mcp

Comece Agora

  1. Crie uma Chave de API Bitget em bitget.com/api-management
  2. Execute o assistente do instalador ou siga a documentação de cada pacote
  3. 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-trading para 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 IAHabilidade
"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-trading
  • derivatives-structure: Base de perpétuos e estrutura de prazos
  • large-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:

  1. SDK (bitget-agent-sdk): Camada base com 89 operações, assinatura HMAC, limitação de taxa
  2. CLI (bitget-agent-cli): Ferramenta de linha de comando para terminal construída sobre o SDK
  3. MCP (bitget-agent-mcp): Servidor de IA para desktop construído sobre o SDK
  4. Skill (bitget-agent-skill): Ensina o terminal de IA a usar a CLI corretamente
  5. 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óduloPadrãoVerbos de IntençãoRequer Chave de API
marketmarketNão (dados públicos)
tradeorder, position, strategy_orderSim
accountaccount_overview, transfer_funds, …Sim
strategyvia rawSim
cryptoloansloanSim
taxtaxSim

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 .env para 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

  1. Use primeiro uma Chave de API de Demonstração para testes
  2. Comece com o modo --read-only para verificar consultas
  3. Nunca envie credenciais para controle de versão
  4. Gire as chaves de API a cada 90 dias

Documentação

TópicoDocumento
Começandodocs/getting-started.md
Arquitetura do ecossistemadocs/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


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 mercadobitget-signal (sem chave de API)
  • Desenvolvedor criando ferramentas personalizadasbitget-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.


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