Skip to main content
← Voltar à Documentação
🚀Primeiros Passos

Conectando Sua Carteira

Conecte Polymarket & Kalshi para ver posições reais e operar

O Predite lê suas posições ativas, saldos e P&L diretamente das suas contas de trading — e, no plano certo, pode enviar ordens por você. Nada disso funciona até você conectar uma carteira. Esta página explica exatamente o que é uma conexão, como configurar uma tanto para o Polymarket quanto para o Kalshi, os três tipos de assinatura do Polymarket, o que é um funder address e como mantemos suas chaves seguras.

O que "conectar uma carteira" realmente faz

Existem duas coisas distintas que você pode conceder ao Predite, e vale a pena ser preciso sobre a diferença, porque elas têm perfis de segurança bem diferentes:

  • •Conexão somente leitura — O Predite pode ver suas posições, ordens abertas, fills e saldos. Ele não pode movimentar fundos nem executar trades. Isso é suficiente para alimentar o painel Portfolio, seu Trade Journal, o acompanhamento de P&L com dinheiro real e para permitir que o EV Scanner sinalize oportunidades em mercados que você já possui.
  • •Conexão de trading — O Predite pode assinar e enviar ordens em seu nome. É isso que alimenta o Live Trading, as TWAP Orders, o Copy Trading e o Bot automatizado. Uma conexão de trading exige sua private key (ou uma credencial de API, no Kalshi) para que o app possa assinar transações.

Você decide qual delas quer para cada carteira. Uma conexão somente leitura nunca pede uma private key. Você pode começar somente leitura e migrar para trading depois, ou voltar para somente leitura a qualquer momento desconectando e reconectando.

> Restrições por plano: Conexões somente leitura e o acompanhamento de portfólio com dinheiro real estão disponíveis em todos os planos (Starter $29, Pro $59, Bot $99). O Live Trading manual e as TWAP Orders exigem Pro ou Bot. A execução totalmente automatizada — o Bot rodando estratégias e o Copy Trading com auto-fill — exige o plano Bot $99/mês. Se você conectar uma carteira de trading no Starter, ainda terá todos os dados em somente leitura; os botões de execução simplesmente permanecem desativados até você fazer o upgrade.

Onde encontrar

Tudo fica em Settings → Trading API. A partir de qualquer tela:

  1. Abra Settings na barra lateral esquerda (ou no ícone de engrenagem, canto superior direito).
  2. Selecione a aba Trading API.
  3. Você verá dois cards: Polymarket e Kalshi, cada um exibindo um selo de status — Not connected, Read-only ou Trading enabled.

Cada card se expande no seu próprio fluxo de conexão. Você pode conectar uma venue, ambas ou nenhuma. Os recursos do Predite degradam de forma elegante: conecte apenas o Kalshi e as ferramentas específicas do Polymarket simplesmente não exibirão dados.

Conectando o Polymarket

O Polymarket roda na Polygon e liquida através do seu CLOB (Central Limit Order Book). Como as contas do Polymarket vêm em alguns formatos, esta é a mais elaborada das duas conexões. Você vai fornecer três coisas: uma private key, um signature type e — para dois dos três tipos — um funder address.

Passo a passo

  1. Em Settings → Trading API, clique em Connect no card do Polymarket.
  2. Escolha Read-only ou Trading. - Para Read-only, cole apenas seu public wallet address (o endereço 0x…). Clique em Verify e pronto — pule para a nota de verificação abaixo. - Para Trading, continue com os passos a seguir.
  3. Selecione seu signature type (veja a próxima seção — esta é a causa mais comum de erros de conexão).
  4. Cole sua private key. Esta é a chave da conta que assina as ordens do CLOB. É uma string hexadecimal de 64 caracteres, com ou sem o prefixo 0x.
  5. Informe seu funder address se o seu signature type exigir um (tipos 1 e 2 — explicados abaixo). Para um EOA (tipo 0), deixe este campo em branco.
  6. Clique em Test connection. O Predite deriva o signer address a partir da sua chave, consulta o CLOB pelo seu saldo e quaisquer posições abertas, e mostra um resumo de confirmação: o signer que ele derivou, o funder a partir do qual ele vai operar e seu saldo atual em USDC.
  7. Confirme que o resumo corresponde ao que você espera e clique em Save & encrypt. Sua chave é criptografada antes mesmo de tocar nosso banco de dados (detalhes na seção de segurança).

Os três signature types

O Polymarket suporta três arquiteturas de conta, e o CLOB precisa saber qual você está usando para construir a assinatura da ordem corretamente. Escolha a errada e as ordens serão rejeitadas com um erro de incompatibilidade de assinatura, mesmo que sua chave seja válida.

  • •Tipo 0 — EOA (Externally Owned Account). Uma carteira simples — a private key controla diretamente os fundos e assina as ordens. O signer *é* o funder, então nenhum funder address é necessário. Use este se você abasteceu o Polymarket a partir de uma carteira de autocustódia como a MetaMask e nunca passou pelo onboarding web do Polymarket.
  • •Tipo 1 — Carteira de e-mail / Magic. Este é o tipo mais comum para quem se cadastrou no polymarket.com com um endereço de e-mail. O Polymarket provisiona uma carteira Magic para você, e seus fundos ficam em um contrato proxy associado. A private key assina, mas os fundos ficam em um funder address separado. Você precisa fornecer esse funder address — é o endereço de depósito que o Polymarket exibe na sua conta, não o signer address.
  • •Tipo 2 — Carteira de navegador / proxy Gnosis Safe. Você conectou uma carteira de navegador externa (por exemplo, MetaMask) através da interface do Polymarket, e o Polymarket implantou um proxy Gnosis Safe que, na prática, detém suas posições. A chave da sua carteira de navegador assina, mas o Safe é o funder. Forneça o Safe address como funder.

Uma forma rápida de decidir: se você faz login no Polymarket com um e-mail, você quase certamente é tipo 1. Se você faz login conectando uma carteira de navegador, você é tipo 2. Se você nunca usou o site do Polymarket e abasteceu uma carteira pura por conta própria, você é tipo 0.

O que é um funder address

O funder address é simplesmente *o endereço que detém o USDC e os tokens de posição* — a conta que de fato é debitada quando você compra e creditada quando você vende. No tipo 0, o signer e o funder são o mesmo endereço, então não há nada a informar. Nos tipos 1 e 2, o Polymarket separa o *signer* (a chave que autoriza uma ordem) do *funder* (o contrato que detém e movimenta o dinheiro). O CLOB associa as ordens ao funder, então, se você omiti-lo ou colar o signer address por engano, a exchange reportará saldo zero ou rejeitará a ordem.

Você pode encontrar seu funder address no Polymarket em seu perfil → endereço de depósito, ou copiando o endereço exibido na sua página de portfólio do Polymarket. Ele será diferente do endereço derivado da sua private key — isso é esperado e correto para os tipos 1 e 2.

Pegadinhas comuns do Polymarket

  • •"O saldo mostra $0, mas eu tenho fundos." Quase sempre é o funder address ou o signature type errado. Reveja se você é tipo 1 (Magic/e-mail) ou tipo 2 (Safe/navegador) e confirme que o funder é o endereço de depósito, não o signer.
  • •"Assinatura rejeitada na ordem." Signature type errado. A chave está correta; o tipo é que está incompatível. Desconecte e reconecte com o tipo certo.
  • •Allowances. Para uma conexão de trading, o funder precisa ter aprovado os gastos de USDC e de conditional tokens no CLOB. Se você já operou no site do Polymarket alguma vez, isso já está configurado. Se a conta é totalmente nova e nunca enviou uma ordem, faça primeiro uma pequena ordem no polymarket.com para configurar as allowances e depois conecte aqui.
  • •Use uma carteira de trading dedicada para o Bot. Se você planeja rodar estratégias automatizadas, considere abastecer uma carteira separada apenas com o seu bankroll de trading em vez de conectar uma chave que controla todo o seu patrimônio em cripto. Menor raio de impacto, P&L mais limpo.

Conectando o Kalshi

O Kalshi é uma exchange regulamentada dos EUA e não usa carteiras cripto nem private keys no sentido da Polygon. Em vez disso, você conecta com uma Kalshi API key.

  1. No Kalshi, vá em Account → API Keys e gere uma chave. O Kalshi fornece um Key ID e uma private key (uma chave RSA usada para assinar requisições à API). Faça o download ou copie ambos — o Kalshi só mostra a private key uma vez.
  2. No Predite, clique em Connect no card do Kalshi em Settings → Trading API.
  3. Escolha Read-only ou Trading. (O modelo de API key do Kalshi faz com que a mesma credencial possa fazer ambos; escolha Read-only se quiser que o Predite ignore a permissão de trading e nunca envie ordens.)
  4. Cole seu Key ID e sua private key.
  5. Clique em Test connection. O Predite autentica, busca seu saldo e posições abertas e mostra um resumo.
  6. Clique em Save & encrypt.

Notas sobre o Kalshi:

  • •Certifique-se de que a API key tem as permissões que você pretende. Uma chave somente leitura no Kalshi simplesmente não consegue operar, mesmo que você depois mude o toggle no Predite.
  • •O Kalshi impõe seus próprios rate limits. O Predite agrupa e limita as requisições automaticamente, mas, se você rodar o Bot de forma agressiva em muitos mercados, ocasionalmente poderá ver breves atrasos na atualização de dados — isso é o limite do Kalshi, não um bug do Predite.

Como protegemos sua chave

Esta é a parte mais importante, então vamos ser específicos.

  • •Criptografia em repouso. Sua private key (ou chave RSA do Kalshi) é criptografada com AES-256-GCM antes de ser gravada no banco de dados. O AES-256-GCM é uma cifra autenticada: ele criptografa os dados e detecta qualquer adulteração. Cada chave é criptografada com um vetor de inicialização exclusivo, e a chave de criptografia fica em um cofre de segredos gerenciado, nunca no mesmo lugar que o ciphertext.
  • •Descriptografada apenas em memória, apenas para assinar. Quando você faz um trade (ou o Bot faz), a chave é descriptografada em memória pelo instante necessário para assinar aquela única transação e, em seguida, é descartada. Ela nunca é gravada de volta no disco em texto plano.
  • •Nunca registramos chaves. As private keys são excluídas de todos os logs, relatórios de erro, crash dumps e eventos de analytics. Se algo falha, nossos logs registram o *evento* ("falha ao assinar ordem para a carteira terminada em …a3f1"), mas nunca o segredo em si. Também removemos as chaves de qualquer sessão de suporte — nossa equipe não consegue ver sua chave, mesmo que você peça.
  • •Em trânsito. Todas as conexões acontecem por TLS. Sua chave é criptografada no envio e nunca é transmitida a terceiros além da própria exchange em que você está operando.
  • •Você permanece no controle. O Predite só assina as ordens específicas que você autoriza (trading manual) ou que correspondem à estratégia/guardrails que você configurou (Bot, Copy Trading). Ele não pode sacar fundos para um endereço externo — as APIs de trading que usamos têm escopo restrito a enviar e cancelar ordens, não a fazer transferências.

Se você preferir não armazenar nenhuma chave de assinatura, use uma conexão somente leitura. Você perderá os recursos de execução, mas manterá todo o analytics de portfólio, o journaling e os alertas de EV. Para o modelo de ameaças completo e nossos compromissos de tratamento de dados, consulte a página de Security.

Desconectando uma carteira

Você pode revogar o acesso a qualquer momento:

  1. Vá em Settings → Trading API.
  2. No card correspondente, clique em Disconnect.
  3. Confirme. Nós excluímos permanentemente o ciphertext armazenado da sua chave dos nossos sistemas. Os endereços públicos somente leitura também são removidos.

Desconectar desativa imediatamente qualquer recurso que dependa daquela carteira — o Bot pausa, o Copy Trading para de espelhar e os botões de execução ao vivo ficam acinzentados. Suas entradas históricas no Trade Journal e os registros de P&L são mantidos (são seus dados, não sua chave), então desconectar não apaga seu histórico de desempenho.

Para segurança máxima depois de desconectar uma carteira de *trading* em que você não confia mais, rotacione o segredo subjacente na origem: gere uma nova Kalshi API key ou, no caso do Polymarket, mova os fundos para uma nova carteira. Excluí-la do Predite remove a nossa cópia, mas só você pode invalidar a chave em si.

Verificando se funcionou

Após conectar, vá até a página Portfolio. Em poucos segundos você deverá ver suas posições ativas, o cost basis e o P&L não realizado puxados diretamente da exchange. Se o card de Trading API mostrar Trading enabled e o Portfolio estiver preenchido, você está totalmente configurado. A partir daí:

  • •O EV Scanner e o modelo de AI Probability podem comparar suas posições com o fair value.
  • •O Live Trading e as TWAP Orders são desbloqueados (Pro/Bot) para execução manual com a carteira conectada.
  • •O Bot e o Copy Trading podem rodar automaticamente (plano Bot), dentro dos guardrails que você definir.

Se as posições não aparecerem, revisite as verificações de signature type e funder address acima — isso resolve a grande maioria dos problemas de conexão do Polymarket.

Docs Relacionados

← Toda a Documentação