> 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/grid-bot/grid-setup.md).

# Grid: configuração

Todas as configurações do formulário Grid, com o gráfico mostrando os seus níveis conforme você avança.

Você configura o bot Grid do goodcryptoX na página Negociar, no formulário ao lado do gráfico: início, modo, intervalo, níveis, tamanhos, Seguir e stops. Ele pode começar na hora, em um preço ou com um sinal de RSI, MACD, bandas de Bollinger, uma variação do preço ou a avaliação TA.

Em **Negociar**, escolha a conta e o par, selecione **Bots** e depois **Grid**. Desça pelo formulário e confira o gráfico conforme avança.

**Só este bot opera este par** vem marcado em um bot novo, a menos que já haja uma posição aberta nesse perpétuo. Deixe marcado se mais ninguém vai operar este par nesta conta, nem você nem outro bot. Quando há outro bot no par, a caixa fica desmarcada e uma linha curta abaixo dela mostra o nome desse bot (com "e outros" quando são vários); se esse bot estiver com ela marcada, iniciar este a desmarca nos dois. Isso não impede operações em outro lugar; [Gerenciando um Grid](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/grid-bot/running-a-grid.md#when-the-bot-needs-you) explica o que fazer se a posição precisar de revisão. Se já houver ordens no par que não são de um bot (suas ou colocadas na exchange), uma segunda linha mostra quantas são (“2 ordens já em aberto”); é só um aviso, e a notificação do bot identifica essas ordens quando ele começa a operar.

## Condição de início <a href="#entry-condition" id="entry-condition"></a>

**Manual** inicia o grid quando você o lança. Escolha quando quiser que o grid comece a operar no mercado atual.

**Preço** espera por um preço na moeda de cotação. Se o mercado está em 100 e você digita 95, o grid espera 95 antes de colocar ordens. Use para começar em um intervalo abaixo ou acima do mercado atual sem acompanhar você mesmo.

**Sinal** espera pelas condições de **Iniciar quando**. Escolha RSI, MACD, bandas de Bollinger, variação do preço ou avaliação TA; **+ Adicionar condição** combina as condições. Todas as condições precisam concordar em todos os intervalos selecionados: escolher 5m e 15m significa que as duas precisam concordar. Escolha estados do mesmo lado.

#### Iniciar com um sinal <a href="#start-on-a-signal" id="start-on-a-signal"></a>

<details>

<summary>Avaliação TA</summary>

A avaliação TA combina 26 indicadores em uma única avaliação para cada intervalo de candle. Escolha **Compra forte**, **Comprar**, **Vender** ou **Venda forte**. Comprar inclui Compra forte; Vender inclui Venda forte. Marque os intervalos que quiser, como 5m e 15m. A seleção inteira precisa concordar ao mesmo tempo: cada intervalo marcado, não apenas um qualquer. O DCA pode entrar enquanto o candle ainda está se formando; o Grid espera o fechamento do candle.

</details>

<details>

<summary>RSI</summary>

O RSI mede a força das altas recentes contra as quedas ao longo de 14 candles. **Sobrevendido** significa RSI em 30 ou abaixo no fechamento do candle; **Sobrecomprado**, em 70 ou acima. Escolha o estado e marque os intervalos de candle que quiser. Cada intervalo marcado precisa atendê-lo.

</details>

<details>

<summary>MACD</summary>

O MACD compara médias móveis rápida e lenta para mostrar o momentum, com configurações fixas de 12, 26 e 9. **Cruzamento de alta** significa que o MACD cruza acima da sua linha de sinal; **Cruzamento de baixa**, que cruza abaixo dela. O cruzamento precisa estar no último candle fechado de cada intervalo que você marcar.

</details>

<details>

<summary>Bandas de Bollinger</summary>

As bandas de Bollinger ficam dois desvios-padrão acima e abaixo da média de 20 candles e mostram quanto o preço está distante dessa média. Escolha **Preço ≤ banda inferior** para um fechamento na banda inferior ou abaixo dela, ou **Preço ≥ banda superior** para um fechamento na banda superior ou acima dela. Cada intervalo de candle que você marcar precisa atender à condição escolhida.

</details>

<details>

<summary>Variação do preço</summary>

Escolha **Caiu** ou **Subiu**, uma porcentagem positiva e uma duração inteira em minutos, horas ou dias. **Caiu 10% em 7 dias** significa dentro de uma semana ou de qualquer trecho mais curto: o preço está pelo menos 10% abaixo do maior preço desde o início da espera, olhando no máximo sete dias para trás. Por exemplo, um movimento de 100 para 112 e depois para 100,8 conta: o preço caiu 10% desde 112. **Subiu** mede uma alta a partir do menor preço na mesma janela. Movimentos anteriores não contam. Cada ciclo de DCA começa uma nova espera; escolha a duração de acordo com o movimento que você quer operar.

</details>

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-8a0b678f1de65c458749900fcdbea9a600eb99d3%2Fgrid-setup-1-entry.webp?alt=media" alt="O formulário do Grid com Signal escolhido, com a seta em Signal" width="430"><figcaption></figcaption></figure>

## Modo grid <a href="#grid-mode" id="grid-mode"></a>

Em perpétuos, escolha **Neutro**, **Long** ou **Short** pela sua visão de mercado. O Neutro começa zerado. Long e Short podem abrir uma posição inicial; também podem começar parcialmente executados ou zerados. Confira o [Modo grid](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/grid-bot.md#grid-mode) antes de escolher.

Depois de selecionar um sinal, confira o **Modo grid**. Qualquer modo pode esperar por qualquer um dos lados do sinal. O spot tem um único modo e também pode esperar por qualquer um dos lados.

## Topo do grid e Fundo do grid <a href="#grid-top-and-grid-bottom" id="grid-top-and-grid-bottom"></a>

**Topo do grid** e **Fundo do grid** definem o seu intervalo. Defina preços na moeda de cotação, ou porcentagens a partir do preço inicial. Em 100, um intervalo de +2% e −2% dá 98–102. Essas são as configurações percentuais iniciais; escolha o intervalo para o mercado que quer operar.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-a576eec87cadf28ad8d87dde3d433994cfb2113e%2Fgrid-setup-2-range-levels.webp?alt=media" alt="O formulário do Grid, com a seta em Grid top e Levels e Between levels abaixo" width="430"><figcaption></figcaption></figure>

Por exemplo, uma entrada por Preço de 95 com um intervalo de ±2% dá 93,10–96,90. Use preços se quiser que os limites fiquem em níveis específicos do gráfico, seja qual for o mercado inicial.

Com Manual, as porcentagens usam o preço de lançamento. Com Preço, usam o seu preço de entrada. Com Sinal, usam o preço de quando o sinal inicia o grid. Preços digitados diretamente ficam como foram digitados.

Olhe no gráfico o intervalo em que o preço vem operando. Você pode digitar os limites ou arrastá-los no gráfico. Não precisa capturar todos os movimentos possíveis. Um intervalo largo espalha o mesmo investimento mais longe; um intervalo estreito pode ficar para trás rápido. Confira os níveis em todo o intervalo antes de continuar.

## Níveis e Entre níveis <a href="#levels-and-between-levels" id="levels-and-between-levels"></a>

**Níveis** é o número de preços no seu intervalo, de 2 a 100. Digite um número ou use **− / +**. Com Investimento fixo, mais níveis significam ordens menores e intervalos mais apertados; menos níveis, ordens maiores e intervalos mais largos.

**Entre níveis** escolhe o intervalo. Na moeda de cotação, os preços têm passos iguais: cinco níveis de 80 a 100 são 80, 85, 90, 95, 100. Em %, têm intervalos percentuais iguais: 10% dá 100, 110, 121.

Escolha % para intervalos percentuais constantes, ou a moeda de cotação para intervalos de preço fixos. Confira o **PnL por nível** depois das taxas. Um espaçamento apertado pode deixar muito pouco lucro por operação concluída; o resultado final depende das execuções reais.

## Margem, Investimento e Tamanho por nível <a href="#margin-investment-and-level-size" id="margin-investment-and-level-size"></a>

**Margem**, em perpétuos, mostra o modo de margem e a alavancagem da exchange para a moeda e os altera onde houver suporte. Se você nunca definiu a alavancagem de uma moeda, vale o padrão da exchange, que pode ser Cruzada com a alavancagem máxima: confira antes de iniciar. A alteração vai para a exchange assim que você a escolhe, como no formulário de ordens; se a exchange recusar, o motivo aparece abaixo da linha e ela volta à configuração da exchange. Se a exchange ainda tiver outra alavancagem ao iniciar, o bot usa essa e informa qual depois que você pressiona «Iniciar». Confira [Margem e liquidação](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/grid-bot.md#margin-and-liquidation) antes de lançar. Com % da conta, DCA e Grid calculam o tamanho das ordens com a alavancagem que escolhes, incluindo com margem de portefólio. Com margem de portefólio, uma alteração de alavancagem recusada aparece como aviso; o bot pode continuar a enviar ordens.

**Investimento** é o total das ordens planejadas na moeda de cotação. Mudá-lo muda o Tamanho por nível. Escolha **% da conta** para usar uma parte do valor da conta, inclusive o PnL não realizado. Essa parte mira a Margem aprox. em perpétuos, o máximo de que a sua conta precisa para o grid chegar ao stop, e o total das ordens no spot.

**Tamanho por nível** define o valor em moeda de cotação ou a quantidade em moeda de cada abertura. Com 100 USDC por nível, o preço 100 compra 1 moeda e o preço 80 compra 1,25. O dimensionamento em moeda mantém igual a quantidade planejada. Digitar o Tamanho por nível devolve o Investimento à moeda de cotação.

**Lucro na moeda**, no spot, mantém o lucro na moeda vendendo menos. Um lucro de 0,001 BTC fica como BTC. Escolha quando quiser acumular a moeda.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-d31d5becee93d30e0a7a9d153d9a70a1366aa564%2Fgrid-setup-3b-spot-sizing.webp?alt=media" alt="O formulário do Grid no spot, com a seta em Profit in the coin" width="430"><figcaption></figcaption></figure>

**Reinvestir** aumenta as aberturas futuras com o lucro; perdas as deixam menores. Aberturas no livro mantêm os tamanhos até serem executadas. Com % da conta, fica ligado: o valor da conta já inclui o resultado. Confira a prévia depois de mudar o dimensionamento. Uma ordem de fechamento mantém a quantidade da abertura dela, a menos que o Lucro na moeda a reduza. Confira a quantidade de moeda além do valor em moeda de cotação antes de escolher a unidade. Escolha dimensionamento em moeda de cotação se quiser que cada abertura planejada gaste o mesmo valor, ou em moeda se a quantidade importa mais para você.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-3d1fb7575938210f50bc9b440ae1fedb52639533%2Fgrid-setup-3-sizing.webp?alt=media" alt="O formulário do Grid, com a seta em Investment" width="430"><figcaption></figcaption></figure>

## Saídas trailing e Seguir <a href="#trailing-exits-and-follow" id="trailing-exits-and-follow"></a>

**Saídas trailing** substitui cada meta de fechamento Limite por um trail, desligado por padrão. A **Distância do trailing** define a reversão que o fecha a mercado. Um trail de venda que começa em 100, sobe para 110 e reverte 1% dispara em 108,90, antes das taxas de execução e do slippage. Deixe folga para o trail: uma distância tão grande quanto o menor PnL por nível depois das taxas pode devolver o ganho esperado.

**Seguir para cima** e **Seguir para baixo** movem o intervalo quando o preço sai dele. Long e spot seguem para cima por padrão, Short segue para baixo, Neutro nenhum. O número de níveis permanece o mesmo.

**Subir até** limita o seguimento acima do Topo do grid; **Descer até** o limita abaixo do Fundo do grid. Escolha um preço ou porcentagem: topo 100 com Subir até 10% dá 110. O limite fica nesse preço enquanto o grid se move. Vazio significa sem limite; desligar Seguir mantém o intervalo atual. Em um limite, a operação continua no último intervalo. Por exemplo, chegar a Subir até 110 não fecha a posição nem cancela o grid. Use um stop se quiser que um preço encerre a estratégia.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-710359997a4b94f3788ee90ff05c6eafd8c89d22%2Fgrid-setup-4-trailing-follow.webp?alt=media" alt="O formulário do Grid com Saídas trailing e as duas chaves de Seguir ligadas, com a seta em Trailing exits" width="430"><figcaption></figcaption></figure>

> Seguir contra a direção do seu grid pode fechar um nível com prejuízo; no Neutro, qualquer direção pode fazer isso. Confira a perda estimada e os fundos necessários, principalmente com dimensionamento em moeda a preços mais altos.

## Quando parar <a href="#when-to-stop" id="when-to-stop"></a>

**Parar acima** e **Parar abaixo** param a uma porcentagem além do Topo ou do Fundo do grid. Com Seguir, a distância é além de Subir até ou Descer até: Subir até 150 mais Parar acima 5% dá 157,50. Esse stop fica fixo enquanto o grid segue. Uma direção seguindo sem limite não tem stop de preço; defina antes o limite de Seguir dela. Confira o preço do stop no gráfico. Defina o stop no ponto em que quer que o plano de trading termine, e confira que a liquidação não viria antes.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-6408c298c6e385202d52c00701e1c0d08dcfada4%2Fgrid-setup-5-stops.webp?alt=media" alt="O formulário do Grid, com a seta em Stop above" width="430"><figcaption></figcaption></figure>

**Fechar posição ao parar** decide se um stop de preço, o seu Parar ou um erro também fecham a posição a mercado. Desmarcado, a posição restante fica com você.

**Take profit** para e fecha quando o PnL total alcança a sua meta. Inclui a posição aberta: +120 realizados e −30 não realizados são +90 no total, então uma meta de 100 não foi atingida.

**Stop loss** para e fecha quando o PnL total alcança o seu limite de perda. Por exemplo, +20 realizados e −70 não realizados alcançam uma perda de 50. Use com o risco da posição aberta em mente, não só os lucros das operações concluídas.

**Drawdown máximo** para e fecha depois de uma queda a partir do pico do PnL total desde que você o definiu. Um pico de 300 seguido de 250 é um drawdown de 50. Use o drawdown quando quiser que a saída acompanhe o resultado conforme ele melhora, em vez de ficar em um valor de perda fixo.

**Parar na posição neutra** faz o Take profit esperar ao mesmo tempo pela meta e por uma posição zerada do bot. Sem meta, Long, Short e spot param no primeiro momento zerado com PnL total diferente de zero; o Neutro precisa de uma meta. Outras posições da conta e moedas guardadas como lucro não impedem uma posição zerada do bot.

> O Stop loss e o Drawdown máximo fecham na hora quando disparam, seja qual for a escolha do Neutro. Taxas de fechamento a mercado e mudanças de preço podem levar o resultado final além do seu limite.

### Perda máx. em um stop <a href="#max-loss-at-a-stop" id="max-loss-at-a-stop"></a>

Abaixo do campo de cada stop o formulário mostra **Perda máx.**: o máximo que o grid pode perder quando esse stop disparar, com taxas, como parte do seu Investimento e em dinheiro. É o pior caso: o preço vai direto do início ao stop e todas as ordens no caminho são executadas. Qualquer repique no caminho fecha uma operação com lucro, então na prática costuma perder menos. Um grid Neutro mostra um valor abaixo de cada stop; o Stop acima de um grid Long e o Stop abaixo de um grid Short não mostram nenhum.

* Com **Seguir**, o valor conta os níveis que o grid vende com perda ao seguir em direção ao stop, ou o máximo que pode perder depois de seguir no sentido oposto até onde o limite deixa.
* **Perda máx.: sem limite** significa que não há máximo: com o seguimento nos dois sentidos, com um seguimento oposto ao stop sem limite, ou quando uma operação perde depois das taxas. A dica diz por quê; um **Stop loss** o limita.
* Quando um **Stop loss** ou o **Drawdown máximo** encerra o grid antes, a linha diz isso. Com **Fechar posição ao parar** desmarcado ela diz **Perda no stop**, e a posição continua aberta.
* Um grid que começa por sinal com uma faixa fixa é calculado a partir do pior início: o topo da faixa para Stop abaixo, o fundo para Stop acima.
* Ainda não aparece valor: com Reinvestir ligado; com o investimento em % da conta; em um grid Neutro com um seguimento ligado e seu limite definido, abaixo do stop do qual esse seguimento se afasta (e abaixo do Stop acima de um grid Long com seguimento para baixo, do Stop abaixo de um grid Short com seguimento para cima); com um limite de seguimento a mais de 1.000 níveis; em um grid em execução.

> A perda máx. é uma estimativa, não um limite garantido. Gaps podem aumentar a perda, o funding não é contado e em perpétuos a liquidação pode vir antes: então a linha mostra a perda maior.

## Avise-me <a href="#notify-me" id="notify-me"></a>

Escolha **Cada ordem**, **Cada mudança de PnL**, **Intervalo, seguir, tamanho** e **Início, parada, alterações**. Cada ordem começa desligada; as outras três, ligadas. Use Cada mudança de PnL se quiser os resultados dos round trips concluídos sem uma mensagem para cada execução de abertura.

Ações que você mesmo faz não enviam mensagem quando o resultado já está ali. Eventos posteriores e mudanças automáticas enviam. Erros e problemas que precisam da sua decisão chegam independentemente das chaves. Você pode mudar as chaves enquanto o grid roda. Configure o [Telegram](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/telegram-alerts.md) para receber os alertas lá.

## Confira os fundos e lance <a href="#check-the-funds-and-launch" id="check-the-funds-and-launch"></a>

**Posição** é a exposição máxima possível que o grid pode formar. Em perpétuos, confira junto com a **Margem aprox.** e a **Liquidação est.**, inclusive o [aviso de margem](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/grid-bot.md#margin-and-liquidation).

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-dadd058c1f93ace2b8b82107a368b28b2526849b%2Fgrid-setup-6-launch.webp?alt=media" alt="O formulário do Grid com o aviso de liquidação, com a seta em Launch" width="300"><figcaption></figcaption></figure>

No spot, **Fundos necessários** mostra moedas e moeda de cotação, com a compra inicial. **You hold** e **Usar** deixam moedas livres substituírem parte dessa compra. As taxas iniciais estão incluídas. Confira as duas moedas 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-8d74743fa9c74238bd903bb47bf38f455ac2796d%2Fgrid-setup-7-spot-funds.webp?alt=media" alt="O formulário do Grid no spot, com a seta em Use them" width="430"><figcaption></figcaption></figure>

Níveis abaixo do mínimo da exchange são colocados mesmo assim, e a exchange pode recusá-los: um nível recusado entra nas ordens com falha do bot, e **Repetir falhas** o envia de novo. Aumente o Investimento ou use menos níveis, se precisar; o aviso ainda oferece **Iniciar mesmo assim**.

Adicione um **Nome bot** e uma **Nota**, confira o resumo sob **Iniciar** e lance. **Iniciar** pede confirmação mais uma vez e mostra esse resumo; pressione **Iniciar** no diálogo para iniciar o bot, ou **Voltar** para deixar o formulário como está. **Não perguntar de novo** pula a pergunta, e a opção **Iniciar um bot** em Configurações a reativa. Manual começa agora; Preço e Sinal esperam. Abra o bot para [acompanhá-lo e mudar configurações](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/grid-bot/running-a-grid.md).

## Contratos com margem em moeda e modo hedge <a href="#coin-margined-contracts-and-hedge-mode" id="coin-margined-contracts-and-hedge-mode"></a>

Em contratos inversos com margem em moeda, o Tamanho por nível é em USD por padrão, ou na moeda de liquidação. Um Tamanho por nível em USD é arredondado para baixo ao valor do contrato quando você sai do campo; na moeda, o bot calcula cada nível pelo próprio preço e arredonda para baixo ao passo negociável do mercado. Os preços são em USD; Investimento, margem, PnL e os valores em Take profit, Stop loss e Drawdown máximo são na moeda de liquidação.

Em uma conta no modo hedge, um grid Long opera a posição Long e um grid Short a posição Short. Um grid Neutro pode manter as duas. Cada ordem de fechamento usa o mesmo lado de posição da sua abertura, e Fechar posição ao parar fecha as duas.

Se a carteira de API ou a chave de API da conta expira em menos de 24 horas, o formulário mostra “A carteira de API expira em menos de 24 horas. Substitua-a nas Configurações” ou “A chave de API expira em menos de 24 horas. Substitua-a nas Configurações”. **Iniciar mesmo assim** cria o bot; suas aberturas automáticas continuam esperando. Com exatamente 24 horas restantes, essa confirmação não é pedida.

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

### De quanto dinheiro um bot Grid precisa? <a href="#how-much-money-does-a-grid-bot-need" id="how-much-money-does-a-grid-bot-need"></a>

Do seu **Investimento**, o total das ordens planejadas, ou de uma parte da conta com **% da conta**. Em perpétuos, confira a **Margem aprox.**; no spot, **Fundos necessários** mostra moedas e moeda de cotação com a compra inicial.

### O grid pode seguir o preço? <a href="#can-the-grid-follow-the-price" id="can-the-grid-follow-the-price"></a>

Sim: **Seguir para cima** e **Seguir para baixo** movem o intervalo quando o preço sai dele, até um limite que você escolher. Seguir contra a direção do grid pode fechar um nível com prejuízo.

### Quando um bot Grid para? <a href="#when-does-a-grid-bot-stop" id="when-does-a-grid-bot-stop"></a>

Em um preço com **Parar acima** e **Parar abaixo**, além do intervalo, ou pelo PnL total com **Take profit**, **Stop loss** e **Drawdown máximo**. Com **Fechar posição ao parar**, um stop de preço também fecha a posição a mercado.
