Gainium

Gerencie seus bots de trading de criptomoedas, negociações e backtests diretamente do seu assistente de IA.

Ver em gainium.ioExperimente este MCPPatrocinado

Documentação

TL;DR

O Gainium MCP permite que aplicativos de IA se conectem à sua conta Gainium. O conector listado nos diretórios de aplicativos é somente leitura (visualizar bots, negociações, o screener, backtests e presets selecionados); adicione o conector personalizado (mcp.gainium.io/mcp) para leitura + escrita. Conecte-se com um login OAuth de um clique — sem necessidade de copiar chave de API. Veja os guias por aplicativo abaixo para configuração.

O Gainium MCP permite que aplicativos de IA — Claude, ChatGPT, Perplexity e outros clientes compatíveis com MCP — se conectem à sua conta Gainium. Eles podem ler seus bots, negociações, saldos, exchanges, backtests, o screener de criptomoedas e presets de estratégias selecionadas. Com o conector de leitura + escrita, eles também podem criar e gerenciar bots e negociações.

Este é o guia geral. Para configuração passo a passo, vá para o seu aplicativo abaixo.

Você também pode acompanhar este vídeo explicativo:

Carregando pré-visualização...

Configurar no seu aplicativo de IA#

Escolha seu aplicativo para instruções passo a passo:

Aplicativo	Guia de configuração
Claude — claude.ai, Desktop e Code	Conectar Gainium ao Claude →
ChatGPT	Conectar Gainium ao ChatGPT →
Perplexity	Conectar Gainium ao Perplexity →

Usando outro cliente MCP (VS Code, Cursor ou o seu próprio)? As URLs do conector e exemplos de configuração estão em Avançado: execute seu próprio servidor ou use outro cliente, abaixo.

Os dois conectores: somente leitura vs leitura + escrita#

O Gainium oferece dois conectores. Escolha com base em se sua IA deve apenas ler sua conta ou também gerenciá-la:

	Somente leitura	Leitura + escrita
URL do conector	`https://mcp.gainium.io/read`	`https://mcp.gainium.io/mcp`
Como adicionar	Listado nos diretórios de conectores dos aplicativos de IA — escolha Gainium	Adicione como conector personalizado por URL
O que a IA pode fazer	Visualizar bots, negociações, saldos, exchanges, o screener, backtests e presets selecionados	Tudo do somente leitura, mais criar / iniciar / parar / modificar bots e negociações
Melhor para	Monitoramento, triagem e análise	Negociação autônoma e gerenciamento de bots

O conector listado nos diretórios de aplicativos de IA é somente leitura. Ele não executa negociações nem movimenta fundos. Negociação (leitura + escrita) é um conector separado que você adiciona manualmente por URL — não é a listagem do diretório.

Antes de começar#

Uma conta Gainium com 2FA habilitado
O aplicativo de IA que você deseja conectar (Claude, ChatGPT, Perplexity ou outro cliente MCP)

Você só precisa de uma chave de API do Gainium se auto-hospedar o servidor MCP (veja Avançado). Para os conectores de diretório e hospedados, você autoriza com um login de um clique — sem necessidade de copiar chave de API.

Como funciona a conexão#

Quando você adiciona o Gainium a partir do diretório de conectores de um aplicativo ou via URL de conector hospedado, o aplicativo autoriza com um login seguro de um clique (OAuth):

Você faz login no Gainium (com 2FA) e aprova o acesso.
O aplicativo obtém sua própria conexão dedicada, com escopo e revogável. O Gainium cria a chave subjacente automaticamente — ela é separada de quaisquer chaves de API que você criar manualmente e não aparecerá na sua lista de Chaves de API.
No conector leitura + escrita, a tela de consentimento permite que você escolha acesso de leitura ou negociação (escrita) e, opcionalmente, somente negociação simulada (paper trading) ou uma restrição de bot único. O conector somente leitura concede apenas acesso de visualização.

Gerencie ou revogue qualquer conexão a qualquer momento em Gainium → Configurações → Aplicativos conectados. Revogar exclui imediatamente a chave de acesso dessa conexão.

Connected apps page in Settings with a Revoke control on each authorized app

Página de aplicativos conectados em Configurações com um controle de Revogar em cada aplicativo autorizado

O que sua IA pode fazer#

Leitura (ambos os conectores): listar e inspecionar bots DCA, Combo e Grid e suas negociações; verificar saldos e exchanges conectadas; executar o screener de criptomoedas; revisar backtests; e navegar por presets de estratégias selecionados e testados.

Escrita (somente conector leitura + escrita): criar, clonar, iniciar, parar, arquivar e modificar bots; abrir, ajustar e fechar negociações; adicionar ou reduzir fundos de negociação; definir take-profit e stop-loss.

Backtesting via MCP usa créditos consumíveis#

Quando sua IA executa um backtest via MCP, ele é executado nos servidores do Gainium (um backtest no lado do servidor), não no seu navegador. Cada execução usa créditos consumíveis:

Peça à sua IA para estimar o custo primeiro. A estimativa é gratuita, e o backtest só começa se você tiver créditos suficientes.
O plano gratuito inclui 0 créditos consumíveis, então backtests via MCP exigem um plano pago (cada um inclui uma cota mensal) ou créditos comprados separadamente. Veja Preços.
Se você não tiver créditos suficientes, o backtest é recusado e nunca é executado, e sua IA recebe um erro de "Créditos insuficientes". Se sua IA disser que executou um backtest, mas nenhum resultado aparecer na sua conta, esse é o motivo mais provável.
Backtesting ilimitado no cliente (incluído em todos os planos, inclusive no gratuito) significa backtests que você mesmo executa no aplicativo Gainium, calculados no seu navegador. O MCP não pode executar esses.

Segurança: negociação simulada e restrições#

Use por padrão o conector somente leitura, a menos que sua IA precise colocar ou modificar negociações.
No conector leitura + escrita, mantenha somente negociação simulada habilitado enquanto testa, ou passe paperContext: true por solicitação.
Você pode restringir uma conexão a um bot único na tela de consentimento (ou com uma restrição de chave de API / variável de ambiente de auto-hospedagem).

Veja Negociação Simulada (Teste Avançado) para saber como o modo simulado funciona dentro do Gainium.

Exemplos de prompts para experimentar#

O que você pode fazer depende de qual conector você adicionou — somente leitura ou leitura + escrita.

Com o conector somente leitura#

Estes apenas leem sua conta e o mercado — seguros para executar a qualquer momento:

Encontrar oportunidades:

Encontre as 5 moedas mais voláteis no screener do Gainium e resuma seus movimentos de preço e volume nas últimas 24 horas.
Avaliar estratégias:

Mostre os principais presets DCA selecionados do Gainium para BTC na Binance e compare os níveis de risco curto, médio e longo por ROI e drawdown máximo.
Revisar seu portfólio:

Resuma meus bots, negociações e saldos abertos com par, status, % de take-profit e P&L não realizado, e sinalize qualquer negociação aberta sem stop-loss definido.

Com o conector leitura + escrita#

Estes também criam ou gerenciam bots e negociações — mantenha a conexão em negociação simulada enquanto testa:

Construir a partir do screener:

Encontre as 3 moedas mais voláteis e crie um bot DCA simulado negociando-as com take-profit de 2% e uma escada de segurança de 3 ordens.
Aplicar uma estratégia selecionada:

Crie um bot simulado a partir do preset DCA longo de risco médio do Gainium para BTC na Binance.
Ajustar uma negociação:

Defina um take-profit de 20% na minha negociação simulada de BNBUSDT.

Os prompts 1–3 funcionam em qualquer conector; os prompts 4–6 exigem o conector leitura + escrita — mantenha-o somente simulado (ou passe paperContext: true) até estar pronto para negociar de verdade.

Avançado: execute seu próprio servidor ou use outro cliente#

A maioria dos usuários pode pular esta seção. Use-a se seu cliente não for um aplicativo de diretório — ou se quiser executar o Gainium MCP você mesmo com sua própria chave de API.

Você precisará de uma chave e segredo de API do Gainium (crie uma). Ao criar a chave, você pode definir escopo somente leitura e uma restrição de modo de negociação ou bot único; esses limites são aplicados no lado do servidor.

Stdio local (recomendado para auto-hospedagem)#

Seu cliente inicia gainium-mcp localmente; as credenciais permanecem na sua máquina:

{
  "mcpServers": {
    "gainium": {
      "command": "npx",
      "args": ["-y", "gainium-mcp"],
      "env": {
        "GAINIUM_API_KEY": "YOUR_GAINIUM_API_KEY",
        "GAINIUM_API_SECRET": "YOUR_GAINIUM_API_SECRET"
      }
    }
  }
}

Adicione "GAINIUM_PAPER_ONLY": "true" e/ou "GAINIUM_ALLOWED_BOT_ID": "<botId>" para forçar negociação simulada ou bloquear o servidor em um bot único, independentemente das permissões da própria chave de API.

HTTP hospedado com chave de API#

Para clientes que autenticam com cabeçalhos em vez do conector OAuth:

{
  "mcpServers": {
    "gainium": {
      "transport": "http",
      "url": "https://mcp.gainium.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_GAINIUM_API_KEY",
        "X-API-Secret": "YOUR_GAINIUM_API_SECRET"
      }
    }
  }
}

Qualquer restrição de modo de negociação ou ID de bot incorporada na chave de API também é aplicada aqui. (Conectando do Claude, ChatGPT ou Perplexity? Use o conector de um clique no seu guia por aplicativo — sem necessidade de cabeçalhos.)

HTTP e SSE locais#

Execute o servidor em modo HTTP se seu cliente precisar de um endpoint HTTP ou SSE local:

export GAINIUM_API_KEY=YOUR_GAINIUM_API_KEY
export GAINIUM_API_SECRET=YOUR_GAINIUM_API_SECRET
export GAINIUM_MCP_TRANSPORT=http
export GAINIUM_MCP_HOST=127.0.0.1
export GAINIUM_MCP_PORT=3000
node dist/server.js

Em seguida, conecte-se a http://127.0.0.1:3000/mcp. Endpoints SSE legados (GET /sse, POST /messages?sessionId=...) também estão disponíveis; prefira /mcp quando seu cliente suportar MCP moderno via HTTP.

Solução de problemas#

O conector não autoriza / o login falha. Certifique-se de estar conectado ao Gainium com 2FA e de que pop-ups sejam permitidos para a janela de login. Você pode revisar ou remover a conexão em Configurações → Aplicativos conectados e tentar novamente.

Uma ação de escrita é recusada. O conector somente leitura não pode criar ou modificar nada — adicione o conector leitura + escrita para isso. Se você estiver no leitura + escrita, verifique se a conexão (ou sua chave de API) não está restrita a leitura, somente simulado ou bot único.

Auto-hospedagem: "credenciais ausentes". Defina GAINIUM_API_KEY e GAINIUM_API_SECRET no processo do servidor (stdio/HTTP local), ou envie cabeçalhos X-API-Key / X-API-Secret (HTTP hospedado com chave de API).

Seu cliente só suporta SSE. Execute o servidor em modo HTTP local e conecte-se a /sse (veja Avançado).

Padrões recomendados#

Use o conector somente leitura, a menos que sua IA precise colocar ou modificar negociações.
Para negociação, use o conector leitura + escrita e mantenha somente negociação simulada ativado enquanto testa.
Auto-hospedagem? Prefira stdio local com uma chave de API com escopo e defina GAINIUM_PAPER_ONLY / GAINIUM_ALLOWED_BOT_ID se quiser limites aplicados pelo servidor.