> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/ai-agents.md).

# Agentes de IA

Conecte o Claude Desktop, o Claude Code, o Codex, o Cursor ou qualquer app MCP à sua instalação do goodcryptoX, com chaves que leem, propõem ou operam dentro dos seus limites.

O goodcryptoX tem um servidor MCP e uma API integrados: o Claude Desktop, o Claude Code, o Codex, o Cursor ou qualquer app MCP pode ler suas posições, propor ordens e operar nas exchanges que você conecta dentro dos limites que você definir, na sua própria instalação, sem conta no goodcryptoX. Um programa usa a [API](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/api.md). O seu goodcryptoX é uma instalação privada no seu computador, NAS ou servidor, e o servidor MCP do goodcryptoX e a API se conectam a essa instalação; não operamos nenhuma API de trading nem servidor MCP público para você se conectar.

Nosso relay é a forma padrão de acessar sua instalação de outro dispositivo. Ele não pode ler sua chave de acesso, solicitações ou respostas. Um computador pode usar um [túnel SSH](#use-an-ssh-tunnel-instead) no lugar, evitando o relay; um [celular](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/phone-access.md) também pode conectar pelo relay.

As contas demo e a visualização Bybit para desenvolvedores, incluindo exemplos de envio com chave somente leitura e recuperação, são para pessoas conectadas ao painel. Chaves de acesso e MCP não podem usar `demoBybitView` nem `demo=1`.

## O que um agente pode fazer <a href="#what-an-agent-can-do" id="what-an-agent-can-do"></a>

Estas ações estão disponíveis tanto pelo MCP quanto pela API. A chave define o que o goodcryptoX permite; as regras próprias do agente de IA podem permitir menos. Um pagamento da sua carteira, como comprar créditos, continua sendo seu: o agente pode dizer como fazê-lo.

Com qualquer chave, ele pode:

* **Contas e posses**: ler suas contas, saldos, posições, ordens abertas e bots, além do status da conta e do goodcryptoX. A ferramenta `portfolio` identifica moedas conhecidas entre contas e ativos de exchange sem correspondência, com o preço próprio de cada ativo e os preços que faltam ([API](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/api.md#portfolio-identities)).
* **Configurações de garantia**: ler as configurações de garantia de cada conta no retrato `balances` (`perCoinCollateral`). Ele informa a carteira, se a exchange aceita cada moeda e se ela é usada como garantia; um valor ausente não significa desativado. Só a pessoa pode mudar as configurações de garantia no goodcryptoX; chaves de API e ferramentas MCP podem lê-las. Contas demo e suas configurações só estão disponíveis em uma sessão da pessoa.
* **Volume de trading**: consultar quanto você negociou desde que conectou cada conta, suas execuções, taxas e PnL realizado, por conta e por quem enviou a ordem, de todo o período ou por dia UTC. A resposta indica onde faltam dados do histórico ou preços ([API](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/api.md#trading-volume)).
* **Ordens e histórico**: ler os detalhes das ordens e as ordens terminadas, e perguntar agora à exchange sobre uma ordem, como o Atualizar do card da ordem faz (nada muda na exchange).
* **Detalhes do bot**: ler planos, ordens, resultados e pagamentos de funding.
* **Pagamentos de funding**: ler quanto uma conta pagou ou recebeu em um mercado, a moeda do pagamento e a parte de cada bot.
* **Mercados**: ler os mercados disponíveis, as regras de trading deles e os preços e volumes dos candles.
* **Moeda base**: ler a moeda que você escolheu para o goodcryptoX e a cotação dela em dólar.
* **Créditos**: ler seus créditos, o volume inicial restante em CEX (`remaining`; some o volume que `balance` compra pela tarifa `rate` para obter o volume total restante em CEX mostrado no painel), a taxa, quais das suas exchanges pagam com créditos, se estão acabando ou se novas ordens e bots estão em pausa e como adicionar mais. Na Solana, os créditos também podem ser pagos em $GOOD, que você já tem ou que é comprado com qualquer moeda no mesmo pagamento, com o desconto do $GOOD; um programa pode cotar um pagamento com `POST /api/v1/credits/pay` (`input`, o valor da moeda, ou `amount`, com `build: false`); o pagamento em si continua sendo seu, feito da sua carteira. A mesma ferramenta `credits` retorna `totals`: USD pagos, créditos de pagamentos, concessões, volume CEX e taxas desde o início; médias diárias e mensais de 30 dias do volume e das taxas; intervalo de datas, indicação de custos estimados e diferença do saldo. As consultas por dia com `before` continuam disponíveis.
* **Código de indicação**: ler o código com que você entrou e sua taxa, seus três códigos, quanto renderam, quantos amigos entraram e quantos deles enviaram uma ordem, e seu pagamento.
* **A própria chave**: ler o escopo, as contas, os mercados e os limites dela, e quanto já usou das 24 horas.
* **Chaves de API da exchange**: verificar novamente a chave de API de uma conta Binance depois que você muda suas permissões na Binance e ler o que ela pode fazer agora.
* **Prévias e relatórios**: prever ordens e bots sem operar, e investigar o que aconteceu.

Com uma chave **Operar**, ele também pode:

* **Ordens**: colocar ordens com take profit e stop loss, mudar as próprias ordens e cancelar ordens que não são de bots nas contas permitidas.
* **Alavancagem**: definir a alavancagem e o modo de margem.
* **Manter a chave de API ativa**: vê se Manter minha chave de API ativa está ativado para uma conta Binance; só você pode ativar ou desativar.
* **Pagar taxas em BNB**: vê se uma conta da Binance paga as taxas em BNB; só você pode ligar ou desligar.
* **Margem isolada**: adicionar ou remover margem de uma posição isolada.
* **Bots**: criar e lançar bots; mudar, parar ou fechar os bots que criou.
* **Ações em lote**: cancelar ordens que não são de bots, parar os próprios bots ou fechar posições que correspondam a um filtro, inclusive as suas. As moedas dos bots ficam, a menos que ele também pare os próprios bots com as posições fechadas.

O trading segue as suas [contas, mercados e limites](#keys-and-limits); os cancelamentos alcançam ordens que não são de bots nas contas permitidas, seja qual for o mercado. Você pausa e retoma os bots dele pelos botões **Suspender** e **Retomar** da chave no goodcryptoX; o agente não pode fazer isso diretamente.

Uma chave **Propor** ou **Operar** pode preparar ordens e bots para você revisar e lançar no goodcryptoX. As [propostas](#proposals) não operam até você lançá-las. Ele pode retirar uma proposta própria enquanto ela espera.

Nenhuma chave pode sacar nem transferir fundos, mudar as suas configurações nem criar outra chave. Uma chave Operar só modifica as próprias ordens e bots, mas pode cancelar qualquer ordem que não seja de um bot nas contas permitidas. Ela não pode cancelar diretamente as ordens de um bot, nem depois que o bot para.

A **Proposta de ordem** e a **Proposta de bot** de uma chave, e o momento em que ela está **No limite**, chegam a você pelo Telegram, com o nome da chave. **Ordem aceita**, **Cancelamento aceito** e **Bot criado** chegam também, a menos que você desligue **Me avisar no Telegram** nos detalhes da chave; ele começa ligado. O que você mesmo faz no painel não envia nenhum. Os detalhes da chave em **Configurações › MCP & API** guardam a atividade dela em **O que ela fez**: as ordens que ela colocou e cancelou, a alavancagem que definiu e a margem que adicionou ou removeu.

## Conecte qualquer app MCP ou programa <a href="#connect-any-mcp-app-or-program" id="connect-any-mcp-app-or-program"></a>

Abra **Configurações › MCP & API**. Pressione **Criar chave**, dê um nome a ela e escolha o que ela pode fazer:

* **Ler** lê suas ordens, posições e bots. Não muda nada.
* **Propor** lê e propõe ordens e bots para você lançar no painel. Nada opera sem você.
* **Operar** lê, coloca e cancela ordens e roda os próprios bots dentro das suas [contas, mercados e limites](#keys-and-limits).

Pressione **Criar chave** de novo e depois **Copiar** e **Pronto**. Para ver a chave de novo mais tarde, abra a linha dela: **Chave** a mostra oculta, com **Exibir** e **Copiar**. Dê a cada app ou programa a própria chave, para poder revogar uma de forma independente.

Abaixo das chaves, o bloco de conexão tem dois lados, **Agentes de IA** e **API**, e no canto superior direito a chave que ele preenche: a última que você criou já está escolhida; escolha outra na lista. Cada app tem uma linha que diz onde vai a configuração: copie e cole lá. Sua chave, o endereço da instalação e a forma de acessá-la de outro computador já estão dentro, então não há nada para preencher. Copiada pelo nosso relay, a mesma linha funciona no computador onde o goodcryptoX roda e em qualquer outro ([De outro computador](#from-another-computer)). As linhas são para o sistema do navegador em que você as copia: copie no computador onde o app roda.

O Claude Code, o Codex e o Cursor iniciam o conector com Node.js 18 ou mais novo no computador em que rodam; o Claude Desktop traz o dele. Se o seu app disser que não encontra o `npx`, instale o Node.js para o seu sistema em [nodejs.org](https://nodejs.org/) e inicie o app de novo. O primeiro início baixa o conector, o que pode levar alguns segundos.

### Claude Desktop <a href="#claude-desktop" id="claude-desktop"></a>

No Mac e no Windows.

1. Pressione **Baixar** ao lado de **Claude Desktop** e abra o arquivo, com o nome da sua chave (dê um clique duplo). O Claude Desktop abre a janela de instalação.
2. Pressione **Instalar**. O Claude Desktop mostra isso para todo conector fora do diretório dele. O nosso fala só com o goodcryptoX, com a chave que você der, e não lê mais nada no seu computador.
3. O Claude Desktop pede a sua **chave de acesso do goodcryptoX**. Pressione **Copiar** ao lado de **Baixar** no goodcryptoX, cole a chave e pressione **Salvar**.
4. Ative a extensão: o Claude Desktop a instala desativada até a chave ser salva.
5. Toda ferramenta do goodcryptoX começa em **Ask**: o Claude Desktop pergunta antes de usar uma. Na linha do goodcryptoX, pressione **Configure** e mude as ferramentas que quer que ele use sem perguntar de **Ask** para **Allow**; no mínimo as de leitura (as de título **Read …**), para que ele possa olhar sem perguntar toda vez.
6. Pergunte “Quais ordens tenho abertas?”. Sua chave define o máximo que o agente pode fazer no goodcryptoX; as permissões do Claude Desktop decidem sobre o que ele pergunta a você.

### Claude Code <a href="#claude-code" id="claude-code"></a>

No terminal, na IDE e na aba Code.

1. Pressione **Copiar** ao lado de **Claude Code**.
2. Abra um terminal no computador em que você usa o Claude Code (Terminal no Mac e no Linux, PowerShell no Windows; o terminal da sua IDE também serve), cole a linha e pressione Return. O Claude Code responde `Added stdio MCP server gcx … to user config`. Uma vez basta: o terminal, a IDE e a aba Code usam todos. Para substituí-la depois (outra chave, uma linha nova), rode antes `claude mcp remove <name>` com o nome que vem depois de `--scope user` na linha: o Claude Code recusa uma segunda linha com o mesmo nome.
3. Execute `claude mcp list`: a entrada do goodcryptoX diz `✓ Connected`. Em uma sessão do Claude Code, `/mcp` a lista com as ferramentas dela.
4. Pergunte sobre as suas ordens. O Claude Code pergunta antes de usar uma ferramenta pela primeira vez: responda **Sim**, ou **Yes, and don't ask again** para essa ferramenta; `/permissions` mostra e muda o que ele pode usar sem perguntar.

### Codex <a href="#codex" id="codex"></a>

1. Pressione **Copiar** ao lado de **Codex**.
2. O jeito fácil: cole as linhas no Codex e peça para ele adicioná-las à configuração. O Codex faz isso e diz para reiniciar; inicie-o de novo.
3. Ou adicione você mesmo: abra o arquivo de configuração do Codex em qualquer editor de texto e crie-o se não existir: `~/.codex/config.toml` no Mac e no Linux, `%USERPROFILE%\.codex\config.toml` no Windows. A pasta dele, `.codex`, é oculta: no diálogo **Abrir** do editor, no Mac pressione Cmd+Shift+G e digite `~/.codex`; no Windows digite o caminho acima no campo do nome do arquivo. Cole as linhas no fim, mantendo o que já está lá, e salve. Depois inicie o Codex de novo: um `codex` novo no terminal, ou feche e reabra o app do Codex.
4. `codex mcp list` mostra o goodcryptoX como `enabled`; em uma sessão, `/mcp` lista as ferramentas dele.
5. Pergunte sobre as suas ordens. Se o Codex pergunta antes de uma ferramenta depende da configuração de aprovação dele (`/approvals` em uma sessão).

### Cursor e outros apps <a href="#cursor-and-other-apps" id="cursor-and-other-apps"></a>

1. Pressione **Copiar** ao lado de **Cursor e outros apps**.
2. O jeito fácil: cole as linhas no chat do Cursor e peça para ele adicioná-las às configurações de MCP.
3. Ou adicione você mesmo: no Cursor, abra **Cursor Settings** (Cmd+Shift+J no Mac, Ctrl+Shift+J no Windows e no Linux), depois **Tools & MCPs**, e pressione **Add Custom MCP**: o Cursor abre o `mcp.json` dele. Se o arquivo estiver vazio, cole as linhas; se já listar servidores, cole só a entrada do goodcryptoX dentro do `"mcpServers"`. Salve.
4. De volta em **Tools & MCPs**, o goodcryptoX aparece listado com as ferramentas dele e uma chave que o liga ou desliga.
5. Pergunte ao agente sobre as suas ordens. O Cursor pergunta antes de rodar uma ferramenta, a menos que você o deixe rodar ferramentas sozinho nas configurações dele.

Qualquer outro app que rode servidores MCP por entrada e saída padrão aceita a mesma entrada: o comando, os argumentos e o ambiente dela. O conector não é um endereço web para um serviço de chat hospedado.

## De outro computador <a href="#from-another-computer" id="from-another-computer"></a>

A linha copiada pelo nosso relay funciona de qualquer computador. Quando o goodcryptoX não roda no computador onde seu app roda, o conector acessa a instalação pelo nosso relay, que não pode ler sua chave de acesso, solicitações ou respostas. Abra o goodcryptoX nesse computador pelo nosso relay, copie a linha do app e cole como acima.

Na primeira vez que um app inicia o conector, ele pareia esse computador com a sua instalação, com um código de uso único que a linha leva. O código vale até ser usado, por um dia no máximo, com a página do goodcryptoX aberta ou não; reiniciar o goodcryptoX também o encerra. Daí em diante, todo app desse computador se conecta sozinho. O computador aparece em **Configurações › Dispositivos** como **Programas em …**, com **Remover**.

Se o seu app disser **This connector has expired. Download it again from goodcryptoX**, nem sempre passou um dia: reiniciar o goodcryptoX ou usar o código em outro computador também torna a linha antiga inutilizável. Copie uma nova linha de **Configurações › MCP & API** e substitua a entrada do seu app seguindo os passos dele acima (no Claude Code, remova antes a antiga com `claude mcp remove`); para o Claude Desktop, baixe o arquivo de novo. Se a conexão salva não puder ser aberta, siga os passos abaixo.

O conector usa o endereço da sua instalação quando consegue confirmar que o seu goodcryptoX responde ali. Caso contrário, conecta pelo nosso relay. Em outro computador, usar o relay é normal.

Se o seu app disser **Can't open or save the connection on this computer**, confira primeiro se você entrou com o usuário do computador que fez a primeira conexão. A mensagem também pode indicar que um arquivo está danificado, que o acesso foi negado ou que o Windows não consegue abri-lo ou salvá-lo. Só copiar uma nova linha não repara os arquivos salvos.

Se os arquivos salvos precisarem ser substituídos, siga estes passos. Eles substituem as conexões salvas do seu usuário atual do computador; não resolvem um bloqueio do PowerShell nem as permissões da pasta.

1. Feche os apps de IA que usam o goodcryptoX e pare qualquer `gcx connect` em execução.
2. Abra a pasta que contém os arquivos: no Windows, digite `%LOCALAPPDATA%\goodcryptoX` na barra de endereços do Explorador de Arquivos; no Mac, use **Ir para Pasta** do Finder com `~/Library/Application Support/goodcryptoX`; no Linux, abra `~/.local/share/goodcryptoX` no gerenciador de arquivos.
3. Renomeie `connect` com um nome ainda não usado, como `connect-old`. Se não conseguir renomeá-lo, resolva primeiro o acesso à pasta.
4. Copie uma nova linha de **Configurações › MCP & API**, substitua a entrada de um app seguindo os passos dele acima e inicie esse app. Para o Claude Desktop, baixe o arquivo de novo.
5. Repita para cada instalação do goodcryptoX que você usa. Os outros apps do mesmo usuário do computador e da mesma instalação passam a reutilizar essa conexão salva.

Se o seu app disser **The connection took too long. Try again in a minute**, tente de novo em um minuto. Um conector em execução tenta de novo sozinho; se o app de IA parou o conector, reinicie o app. Se continuar acontecendo, é preciso examinar o problema mais de perto.

Mantenha as linhas copiadas em sigilo: elas guardam a sua chave e, por um dia, o código que pareia um computador. O arquivo do Claude Desktop guarda o código, mas não a chave: o Claude Desktop pede a chave. O código sozinho não lê nem opera nada; ainda é preciso uma chave de acesso.

Um conector em execução se reconecta depois do repouso ou de uma interrupção de rede; sua instalação continua operando enquanto roda e está conectada à exchange. Para conectar sem o nosso relay, use [um túnel SSH](#use-an-ssh-tunnel-instead).

De um [endereço doméstico](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-your-mac.md#your-home-network), a linha que você copia conecta seu app de IA ou programa diretamente à instalação que a criou, com a chave escolhida, e nunca pelo nosso relay. Use em uma rede em que confia ou pelo seu próprio endereço HTTPS confiável: em HTTP, alguém que consegue ler o tráfego pode copiar a chave.

## Use um túnel SSH em vez disso <a href="#use-an-ssh-tunnel-instead" id="use-an-ssh-tunnel-instead"></a>

Em vez do relay, você pode usar um túnel SSH; se não sabe o que é, não precisa dele. Essa alternativa conecta o seu computador diretamente ao computador em que o goodcryptoX roda.

<details>

<summary>Conectar por SSH</summary>

1. No seu computador, abra o Terminal (PowerShell no Windows) e encaminhe uma porta local para a porta do goodcryptoX no outro computador. Por exemplo, se o goodcryptoX usa a porta 8128:

   ```sh
   ssh -N -L 8128:127.0.0.1:8128 <user>@<server-address>
   ```

   Use o seu usuário e o endereço de SSH, adicionando `-i <private-key-file>` se precisar. Use a porta real do goodcryptoX nos dois lados da linha e no endereço abaixo. Deixe esse comando rodando.
2. Abra `http://127.0.0.1:8128/gcx` pelo túnel, usando a porta do goodcryptoX. Para entrar, execute `gcx open --print` na instalação (`docker exec gcx gcx open --print` no Docker) e abra o link dele em até 60 segundos. Veja o guia do [servidor](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-a-server.md#sign-in) ou do [NAS](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-a-nas.md#sign-in) para os detalhes de como entrar.
3. Em **Configurações › MCP & API**, copie a linha do seu app como acima. Enquanto o túnel roda, o conector encontra o goodcryptoX nesse endereço local e fala diretamente com ele.

Os programas usam esse mesmo endereço local e a própria chave. Fechar o comando SSH encerra o acesso a partir deste computador; os bots e as ordens continuam rodando na instalação.

</details>

## Dispositivos e remoção <a href="#devices-and-removal" id="devices-and-removal"></a>

**Configurações › Dispositivos** lista os navegadores e computadores pareados. Cada linha **Programas em …** cobre os apps e programas que compartilham o login de um computador; você pode renomeá-la ou **Remover**. As conexões de navegador têm linhas separadas.

**Remover** encerra as conexões de programas desse computador, não as chaves de acesso dele. Pareie de novo para reconectar. Os outros computadores continuam conectados. Ordens já enviadas podem terminar; a remoção não cancela ordens, não para bots nem fecha posições. Revogue uma chave separadamente para tirar o acesso dela em todos os lugares onde é usada.

## Estatísticas da chave <a href="#key-statistics" id="key-statistics"></a>

Cada chave mostra sua atividade em Configurações e Dashboard. **Ativos** conta ordens abertas e bots rodando. **Volume** é o valor negociado por suas ordens e bots, não o saldo da conta.

**PnL realizado** é o lucro ou prejuízo realizado dos trades da chave e do funding dos bots, após taxas. Exclui PnL não realizado variável de posições abertas. Por exemplo, 20 de lucro fechado, menos 2 de taxas e 1 de funding pago, contribuem 17. Funding recebido soma ao resultado.

Os valores mostram total e últimas 24 horas. Quando a chave negocia em várias moedas, os resultados ficam separados; lucro em uma moeda não é somado silenciosamente ao de outra.

## Chaves e limites <a href="#keys-and-limits" id="keys-and-limits"></a>

A linha de cada chave em **Configurações › MCP & API** mostra as ordens e bots abertos dela, o volume operado e o PnL; abra a linha para ver os limites e pressione **Editar** para mudar o que ela pode fazer ou os limites. As propostas dela esperam na aba **Propostas** da página Negociar ([Propostas](#proposals)).

Para uma chave **Operar**, escolha **Contas** e **Mercados** (**Todos**, **Spot**, **Perps** ou **Personalizado**: uma busca e os mercados que você marca entre os resultados) e depois os limites que quiser. **Todos**, **Spot** e **Perps** incluem mercados listados depois. Contas e mercados restringem onde ela opera; ler e propor não são restritos. Sem contas ou mercados definidos, ela não pode operar.

Todo limite de dinheiro começa desativado e mostra **Sem limite**: ative os que quiser e digite o valor. Os limites são na sua moeda base (**Configurações › Geral › Moeda base**, dólar americano até você escolher outra): uma chave mantém a moeda em que seus limites foram definidos. Um mercado cotado em stablecoin conta um para um com o dólar; um mercado cotado em uma moeda como BTC é avaliado pelo preço dela. Um limite restringe o tamanho do que o agente opera, seu valor, nunca a margem usada: a 5x, uma ordem de 1,000 USD usa cerca de 200 USD de margem.

Escolher outra moeda base converte os limites de cada chave uma vez, pela cotação daquele dia, e eles ficam como valores na nova moeda: um limite de 1,000 USD vira 900 EUR a 0.9, e o que vale é 900 EUR, qualquer que seja a cotação depois. Os limites de 24 horas somam as ordens e bots da chave entre mercados cotados em moedas diferentes, cada um avaliado na moeda dos limites quando a ordem é verificada; nada nas últimas 24 horas é reescrito pela troca. Um bot dimensionado perto do limite pode ficar retido por uma mudança na cotação; **Tentar de novo** o executa quando ele cabe. Acima de um limite, a recusa informa os dois valores na moeda dos limites ("O valor da ordem de 945.00 EUR supera o limite desta chave de 900.00 EUR"). Com BTC ou ETH como base, os limites são valores em moeda e os dólares permitidos mudam com o preço dela.

| Seção      | Limite                        | O que você permite                                                                                                                                                                                 |
| ---------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ordens** | **Máx. por ordem**            | O valor de uma ordem que o agente coloca, inclusive depois de uma mudança. As saídas das próprias operações dele não contam.                                                                       |
|            | **Volume máx. em 24 h**       | As ordens dele nas últimas 24 horas, executadas ou ainda abertas. As saídas das próprias operações e as ordens dos bots dele não contam.                                                           |
| **Bots**   | **Pode iniciar bots**         | Ligado (o padrão): todos os tipos de bots, ou só os tipos que você marcar. Desligado: só ordens.                                                                                                   |
|            | **Máx. por bot**              | O dinheiro de um bot: a entrada e todas as ordens de média de um bot DCA, o investimento total de um bot Grid.                                                                                     |
|            | **Volume máx. em 24 h**       | O dinheiro dos bots que ele iniciou nas últimas 24 horas. Um ciclo DCA conta quando começa; um bot Grid quando é lançado e quando o investimento cresce.                                           |
| **Perps**  | **Máx. por posição**          | O valor da posição dele em um mercado depois da ordem. Aparece quando os mercados dele incluem perpétuos.                                                                                          |
|            | **Máx. de todas as posições** | O valor de todas as posições dele juntas depois da ordem.                                                                                                                                          |
|            | **Margem**                    | **Só isolada** (o padrão) ou **Qualquer**. Só isolada limita a perda de cada posição à própria margem; a margem cruzada pode perder a conta toda.                                                  |
|            | **Maior alavancagem**         | Começa em 5x: a maior alavancagem que ele pode definir ou usar. Para os bots, é verificada no lançamento e quando a chave os muda. Aparece, com Margem, quando os mercados dele incluem perpétuos. |

Uma ordem que diminui uma posição é sempre permitida, digam o que disserem os limites de posição. A mesma chave compartilha os limites em todos os apps e dispositivos que a usam.

Uma chave Operar pode enviar ordens e executar bots nas contas e mercados que você permitir, dentro de seus limites. A Bybit oferece spot, futuros USDT e USDC e futuros inversos; a Bybit EU só spot. Na Binance e Bybit, a chave pode definir a alavancagem de futuros dentro de **Maior alavancagem** e alterar o modo de margem dentro de **Margem** onde a exchange permitir. Altere o modo de margem de uma Bybit Unified Trading Account na Bybit. Operações na Binance, Bybit e Bybit EU pagam a taxa do goodcryptoX com [créditos](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/supported-exchanges/trading-credits.md); novas ordens e bots precisam de créditos como os seus. Em mercados com margem em moeda, a API e as ferramentas MCP retornam tamanhos em contratos, com o valor do contrato ao lado; o painel mostra os mesmos tamanhos em USD e na moeda.

Para o agente deste guia, o Volume máx. em 24 h para ordens é 10,000 USD e 9,800 USD já foram usados. Mais 400 levariam a 10,200, então o goodcryptoX recusa essa ordem. Escolha os limites para o trading que pretende, depois copie a chave e [conecte seu agente ou programa](#connect-any-mcp-app-or-program).

Trate a chave como uma senha: quem a tiver pode usar as permissões dela de onde alcançar a sua instalação.

* **Suspender** impede a chave de operar e cancela as ordens dela no livro que abririam ou aumentariam uma posição. Os bots dela pausam: as ordens de entrada e de média ou as ordens de abertura do Grid são canceladas, e nenhum ciclo novo começa. As saídas e posições existentes ficam, com take profits e stop losses ainda funcionando. A chave ainda pode ler.
* **Retomar** deixa a chave operar de novo e continua os bots dela, restaurando as ordens de abertura ou de média canceladas pela pausa. Ordens avulsas canceladas continuam canceladas; não é preciso chave nem pareamento novos. Confira o mercado e o bot antes de retomar.
* **Revogar** faz a chave parar de funcionar de vez, inclusive para ler, e aplica a mesma pausa e os mesmos cancelamentos. Os bots dela continuam pausados até você pará-los. Crie uma chave nova para dar acesso de novo. Uma chave revogada que nunca fez nada (nenhuma ordem, nenhum bot, nenhuma proposta) é apagada; uma com registro fica em **Revogadas** com o histórico; **Ativos** lista as chaves em uso.

### O que uma chave de trading pode fazer <a href="#what-a-trading-key-can-do" id="what-a-trading-key-can-do"></a>

Ela pode colocar ordens a mercado, limite, stop e trailing, com take profit e stop loss, nas contas e mercados permitidos. Uma mudança em uma das ordens dela precisa caber nos limites com o valor mudado.

Ela pode cancelar ordens que não são de bots nas contas permitidas: as suas, as de outra chave e as colocadas fora do goodcryptoX, além das dela. A chave usa os comandos permitidos nos próprios bots; a ordem sobrando de um bot parado você mesmo pode cancelar.

Ela pode vender moedas que você já tem ou operar contra a sua posição dentro dos limites. Se este agente vende 0.1 ETH contra o seu long de 1 ETH em uma conta onde as posições são combinadas, o seu long passa a 0.9 ETH. Mantenha o trading alheio a isso em outra conta, se quiser evitar.

### O que os limites não restringem <a href="#what-the-limits-do-not-bound" id="what-the-limits-do-not-bound"></a>

Esses limites restringem a exposição, não a perda. Eles não limitam as perdas de posições formadas ao longo de vários dias, não impedem uma operação em má hora nem evitam que uma chave mova ou cancele o próprio stop loss. Várias chaves que compartilham uma conta somam a exposição delas.

Use uma subconta separada com só os fundos que você está disposto a arriscar. Isso separa os fundos disponíveis para o agente do seu outro trading; não torna a estratégia dele segura.

### Os bots dela <a href="#its-bots" id="its-bots"></a>

Um bot é limitado pelos próprios limites, nunca pelos limites de ordens: as ordens de entrada, de média e do grid dele são o plano. **Máx. por bot** é verificado quando o agente lança ou muda um bot, e de novo quando cada ciclo DCA começa. Um lançamento acima dele é recusado e nenhum bot é criado.

O **Volume máx. em 24 h** dos bots conta o dinheiro de cada ciclo DCA quando o ciclo começa, e o investimento de um bot Grid quando é lançado e sempre que cresce. Se este agente lança três bots DCA com entrada de 500 USD e quatro ordens de média de 300 USD cada, cada ciclo é de 1,700 USD. Com um limite de 5,000 USD, os dois primeiros começam; o terceiro é criado e espera, e você recebe uma mensagem do Telegram. Ele começa sozinho quando o primeiro início completar 24 horas. Os take profits e stop losses existentes continuam funcionando nesse meio-tempo.

Uma solicitação de criação sem `leverage` ou `marginMode` usa os da posição aberta ou, se não houver, margem isolada e 5x, como diz a referência da API. Se a exchange recusar a alavancagem ou o modo de margem, a solicitação de criação é recusada e nenhum bot é iniciado.

A chave só pode mudar bots que criou diretamente. Use uma planilha de estratégia (o exemplo no fim de [Propostas](#proposals)) para preparar e revisar um plano completo antes de permitir que ela lance.

Uma chave feita antes destes limites mantém a regra antiga até você salvar os limites dela de novo: cada ordem de bot precisa caber na maior ordem dela, e cada ciclo conta adiantado contra a única cota de 24 horas que ela divide com as ordens.

### Quando uma chave atinge um limite <a href="#when-a-key-meets-a-limit" id="when-a-key-meets-a-limit"></a>

O Dashboard mostra **No limite**, e o Telegram nomeia o agente e o limite atingido. Abra a chave em **Configurações › MCP & API** e confira a atividade e o uso dela. Reduza o pedido, espere liberar cota ou mude você mesmo os limites; o agente não pode aumentá-los. Baixá-los não fecha a exposição existente. Confira **Ordens → Abertas**, **Posições** e **Bots** quando precisar reduzir o que já está rodando.

### Conferindo uma ordem antes <a href="#checking-an-order-first" id="checking-an-order-first"></a>

Peça uma prévia antes de colocar uma ordem. Ela mostra o tamanho, o preço, o valor e os avisos propostos sem enviar nada. Os limites da chave são verificados na colocação. Uma prévia é uma verificação do plano, não a aprovação da operação.

A prévia de um bot DCA inclui, para cada lado, `liquidation.price`: o preço pelo qual a exchange liquidaria a posição à medida que as ordens do bot são executadas. Em Cruzada, é uma estimativa que pressupõe que nada mais muda na conta. `"0"` significa que não há preço de liquidação (a conta cobre totalmente a posição); `liquidation` é `null` quando a exchange não informa um para a posição (margem de portfólio).

A prévia de um bot DCA também traz `margin`: `survive` é o que a conta precisa para o bot chegar ao stop loss, e `toLast` o que ela precisa para executar a última ordem de média, ambos com taxas incluídas e na moeda em que o mercado liquida, como a **Margem aprox.** do formulário os mostra. O tamanho de cada ordem é arredondado para o passo da exchange, então `margin.range`, `position.range` e `stop.range` dão os limites entre os quais o número se move com o preço; o número da página é o que seria enviado agora. Eles ficam ausentes quando os dois limites são iguais. A prévia de um Grid ainda não traz a sua necessidade: um agente lê a do DCA.

A prévia de um bot Grid também traz `maxLoss`, a linha **Perda máx.** do formulário: para Stop abaixo e Stop acima, o máximo que o grid pode perder quando esse stop disparar, com taxas (`loss` em dinheiro, `lossPct` uma porcentagem do investimento (o valor das ordens), como o formulário a mostra; `by` diz se o stop, um stop loss, o drawdown máximo ou uma liquidação o encerra primeiro). `by: none` com um `reason` significa que não há máximo, por exemplo com o seguimento nos dois sentidos. É uma estimativa ao preço atual; veja [Perda máx. em um stop](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/grid-bot/grid-setup.md#max-loss-at-a-stop).

As ordens de uma chave de trading passam com os avisos do formulário; a exchange ainda pode recusá-las. Peça ao agente que explique esses avisos antes de operar. Uma chave Propor deixa essa decisão nas suas mãos.

## Propostas <a href="#proposals" id="proposals"></a>

Uma proposta é uma ordem ou um bot que uma chave **Propor** ou **Operar** preparou para você. Ela espera até você lançar ou descartar; nada opera antes, e só você pode lançá-la.

Ela chega a você pelo Telegram, com um link **Abrir** depois que você pareou um dispositivo, e espera no alto do Dashboard em **Precisa da sua atenção**. Para agir sobre ela:

1. Pressione **Abrir** na mensagem do Telegram ou na linha do Dashboard. A página Negociar abre na aba **Propostas** (que também lista todas as propostas em espera).
2. O formulário da ordem ou do bot é preenchido com o que o agente propôs, com uma nota dizendo quem propôs. Mude o que quiser.
3. Lance com o botão que a nota nomeia, ou pressione **Descartar** (também na linha do Dashboard).

Uma proposta é lançada uma vez. O que você lança é seu: a chave não pode mudar. Uma chave posta em **Ler** descarta as propostas dela em espera, e revogá-la também.

Um programa também pode retirar uma proposta própria enquanto ela espera, com a ferramenta `withdraw_proposal` ou [a API](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/api.md#withdrawing-a-proposal). Ela sai da sua lista e de **Precisa da sua atenção** na hora e nada é enviado a você; o cartão da chave a lista como retirada. Ele não pode retirar a proposta de outra chave, nem uma que você lançou.

<details>

<summary>Exemplo: uma planilha de estratégia virando um bot DCA</summary>

Aqui um agente de IA transforma uma planilha de estratégia, uma descrição dos bots que você quer rodar, em um bot DCA no goodcryptoX.

1. **Escolha como aprovar.** Crie uma chave **Propor** para revisar e lançar cada bot no goodcryptoX. Escolha **Operar** para deixar o agente criar os bots sozinho, com as contas, os mercados e os limites que você permitir. Comece com Propor se quiser ver como ele lê a sua planilha.
2. **Conecte** usando [Conecte qualquer app MCP ou programa](#connect-any-mcp-app-or-program). Para o goodcryptoX em outro computador, use [De outro computador](#from-another-computer) para parear pelo relay; um túnel SSH é uma alternativa.
3. **Dê a ele a planilha e a sua escolha.** Comece com um perfil: “Prepare este perfil de ETH na minha subconta de trading. Mostre as configurações antes de criar.” Diga quais perfis quer; vários perfis no mesmo mercado somam a exposição.
4. **Compare a prévia com a planilha.** Peça a prévia do bot do goodcryptoX. Confira a entrada, cada ordem de média, o investimento total, as saídas e as opções de repetição. Com Propor, [abra a proposta](#proposals) e confira o formulário preenchido antes de **Iniciar**. Com Operar, diga ao agente quando criar. A perda no stop da prévia (`stop.loss`) inclui as taxas: as de cada ordem e a do stop. A perda máxima de um bot DCA é `slMaxLossPct`, uma porcentagem do seu Investimento. Um bot criado antes da 3.2.1 pode conter `slLossPct` em vez disso, uma porcentagem da margem: mostre como `slLossPct ÷` o `leverage` da linha, arredondado para baixo a 0,01 (20 a 10x é 2), e envie `slMaxLossPct` para alterar.
5. **Confira o resultado.** Abra **Bots** e os detalhes do bot. Revise o que a chave fez em **Configurações › MCP & API**.

Aqui está um perfil DCA de ETH. A entrada e as quatro ordens de média são de 359.35 USDC cada uma: cinco ordens somam 1,796.75 USDC para um ciclo. O Take profit fica 1.61% acima do preço médio de entrada. Essa meta não garante lucro depois de todos os custos nem uma execução no preço da meta.

| Configuração da planilha                                                      | O que conferir no goodcryptoX                                                                                         |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Sinal de compra, candles de 15 minutos                                        | **Condição de início: Sinal**; em **Iniciar quando**, avaliação TA Compra em 15m; Compra inclui Compra forte          |
| Long, seguindo o sinal                                                        | **Modo entrada: Direto**                                                                                              |
| Entrada a mercado                                                             | **Tipo entrada: Mercado**                                                                                             |
| 359.35 USDC por ordem                                                         | **Tam. entrada: 359,35**, em USDC                                                                                     |
| Quatro ordens de média iguais                                                 | **Ordens de média: 4**, **1ª ordem de média: Manual**, **Tamanho 1ª média: 359,35**, **Mult. tamanho média: 1**       |
| Primeiro espaço 0,96%; espaço seguinte 1.1712%, multiplicado por 1.22         | **Passo 1ª média: 0,96%**, **Passo preço média: 1,1712%**, **Mult. passo média: 1,22**                                |
| Ativar cada ordem de média quando o preço chegar ao nível planejado anterior. | **Na exchange: Uma a uma**, **Post only** desligado                                                                   |
| Take profit 1.61% da entrada média                                            | **Take profit** ligado em 1.61%, **Tipo de TP: Limite**, **Fixar o TP como % do preço da ordem de entrada** desligado |
| Stop 2.197609% abaixo da última ordem de média planejada                      | **Stop loss** ligado em 2.197609%; **Stop loss como: Da última ordem de média, %**.                                   |
| Um ciclo                                                                      | **Repetir após:** **TP** e **SL** desligados                                                                          |

A vírgula decimal de uma planilha significa o mesmo número: 0,96% vira 0.96%. Compare os preços e valores da prévia com a planilha. Com essas configurações, as ordens de média ficam cerca de 0.960%, 2.120%, 3.519% e 5.200% abaixo da entrada. Escolha a alavancagem e a margem com critério antes de lançar.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-4cbccfddbb1c69f7df536c890fcfea0d2d5ae3f0%2Fstrategy-sheet-form-entry.webp?alt=media" alt="O formulário DCA preenchido com as configurações de entrada e de média da planilha, com a seta em Investment" width="300"><figcaption></figcaption></figure>

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-3b40082342a80336ec091fb0a958283ca3968d15%2Fstrategy-sheet-form-exits.webp?alt=media" alt="As saídas do mesmo formulário e a Lista de ordens, com a seta no Total" width="300"><figcaption></figcaption></figure>

Peça ao agente que sinalize as regras sem suporte. As configurações de indicadores de outra plataforma, um limite de perda modelado, um movimento do stop para breakeven ou um limite de tempo a partir da primeira execução podem não ter configuração equivalente. Ele deve explicar a diferença antes de você operar.

As [permissões](#keys-and-limits) decidem se o agente lê, propõe ou opera; ele não pode sacar fundos nem aumentar a própria cota. Em um lançamento direto com **Operar**, os [limites de bots](#its-bots) da chave cobrem todo o dinheiro do bot: o ciclo de 1,796.75 USDC deste perfil passa de um **Máx. por bot** de 1,000 USD, então o bot não é criado; revise você mesmo o perfil ou o limite. Ainda é possível preparar uma proposta para você revisar e lançar.

</details>

## Perguntas <a href="#questions" id="questions"></a>

### O Claude pode fazer operações por mim? <a href="#can-claude-place-trades-for-me" id="can-claude-place-trades-for-me"></a>

Sim, com uma chave **Operar**: ela lê, coloca e cancela ordens e roda os próprios bots dentro das suas contas, mercados e limites. Com uma chave **Propor**, nada opera sem você.

### O goodcryptoX tem um servidor MCP? <a href="#does-goodcryptox-have-an-mcp-server" id="does-goodcryptox-have-an-mcp-server"></a>

Sim: o servidor MCP do goodcryptoX conecta o Claude Desktop, o Claude Code, o Codex, o Cursor e outros apps MCP à sua própria instalação, com uma chave de **Configurações › MCP & API**. Não operamos nenhum servidor MCP público para você se conectar.

### A minha chave ou o meu trading passam pelos servidores do goodcryptoX? <a href="#does-my-key-or-my-trading-go-through-goodcryptoxs-servers" id="does-my-key-or-my-trading-go-through-goodcryptoxs-servers"></a>

Só a partir de outro dispositivo, pelo nosso relay, que não consegue ler a sua chave de acesso, as requisições nem as respostas. Um [túnel SSH](#use-an-ssh-tunnel-instead) dispensa o relay.

### O agente pode sacar fundos? <a href="#can-the-agent-withdraw-funds" id="can-the-agent-withdraw-funds"></a>

Não: nenhuma chave pode sacar nem transferir fundos, mudar as suas configurações nem criar outra chave.

### Quais apps funcionam: Claude, Codex, Cursor, outros? <a href="#which-apps-work-claude-codex-cursor-others" id="which-apps-work-claude-codex-cursor-others"></a>

O Claude Desktop, o Claude Code, o Codex e o Cursor têm cada um a própria linha em **Configurações › MCP & API**, sem nada para preencher. Qualquer outro app que rode servidores MCP por entrada e saída padrão aceita a mesma entrada.

### Existe uma API? <a href="#is-there-an-api" id="is-there-an-api"></a>

Sim: o seu próprio programa lê e opera pela API do goodcryptoX, com as mesmas chaves, permissões e limites de um agente de IA ([API](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/api.md)).
