A API da Propr.xyz: automatize seu challenge com um bot

A maioria das prop firms trata automação como contrabando: bots proibidos, copy trading proibido, acesso à API reservado a "parceiros institucionais" que você nunca vai conhecer. A Propr.xyz foi na direção oposta — entrega uma API REST pública, SDKs oficiais em Python e JavaScript, um sandbox para testes e um rulebook que permite bots explicitamente. O Bubbles, meu próprio bot, roda nessa exata API todos os dias. Aqui está tudo o que importa nela, o que seu bot realmente pode fazer, e a decisão honesta entre construir o seu e plugar algo que já funciona.

A resposta curta

Sim, a Propr.xyz tem uma API real, pública e documentada. Você gera uma chave no dashboard (ela começa com pk_live_), envia no header X-API-Key, e pode ler sua conta, gerenciar posições e colocar ordens em contas de avaliação e financiadas, com até 1.200 requisições por minuto. A documentação está em propr.xyz/developers e no GitHub, e a Propr promete integração em menos de dois minutos — o que bate com a minha experiência: a autenticação é um header, sem dança de assinaturas, sem cerimônia OAuth.

O que a API realmente oferece

A API é organizada do jeito que um construtor de bots gostaria: health checks sem autenticação (/health, /health/services), um endpoint de perfil /users/me e rotas autenticadas cobrindo challenges, trading e configurações da conta. Os fatos para anotar num post-it:

• Base URL: api.propr.xyz/v1, REST, JSON na entrada e na saída.
• Auth: uma chave de API por usuário, enviada como X-API-Key, com escopo completo da conta (ordens, posições, trades).
• Rate limit: 1.200 requisições/minuto — de sobra para um bot DCA, um grid ou um motor de copy trading sem malabarismo de batching.
• SDKs: pacotes oficiais Python e JavaScript, mantidos no repositório público de docs da Propr no GitHub.
• Ambientes: Produção (trades reais nos mercados reais da Hyperliquid) e Beta — um sandbox que a própria Propr manda você usar para testar o bot primeiro.

Duas escolhas de design mostram que a Propr leva isso a sério. Primeiro, o ambiente Beta: firms que apenas toleram bots não constroem um sandbox para você. Segundo, os builder codes — um header opcional X-Builder-ID que identifica seu bot ou integração junto à Propr, para que ferramentas legítimas recebam atribuição, suporte e estabilidade de API em vez de serem tratadas como tráfego suspeito. O site da Propr coloca um número no resultado: mais de 1.000 agentes de IA já operam na plataforma.

Obtendo sua chave de API, passo a passo

1. Crie sua conta na Propr.xyz (pelo meu link você recebe 5% de cashback em USDC na taxa do challenge) — login com Google funciona, e o KYC só é exigido depois, antes de virar funded.
2. Abra Settings no dashboard e gere sua chave. Ela começa com pk_live_.
3. Guarde-a numa variável de ambiente. Nunca commite, nunca cole num repositório público — a chave tem acesso completo de trading à sua conta, e você só tem uma (regenere em Settings se vazar).

Se você ainda não tem conta na Propr e quer o passo a passo completo — escolha de challenge, taxas, países restritos — o guia de inscrição cobre tudo.

Automatizar um challenge é mesmo permitido?

Explicitamente, sim. O rulebook oficial da Propr (v1.0.2, abril de 2026) permite bots, EAs e copy trading nos dois formatos de challenge e nas contas financiadas. Não é uma zona cinzenta que você explora até uma revisão de payout te pegar — é o posicionamento da firm. A página inicial literalmente anuncia trading "agent friendly" e um "Prop Firm OS" feito para devs. Para um trader sistemático, isso muda completamente o cálculo de risco: na maioria das firms, o maior risco fora do mercado é uma reinterpretação retroativa das regras; na Propr, a automação é o caso de uso pretendido.

As regras que seu bot ainda precisa respeitar

A API vai deixar você estourar sua conta sem reclamar — os guardrails são trabalho seu. O que quer que você rode precisa viver dentro dos mesmos limites de um trader humano:

• 1-Step: target de 10%, perda diária fixa de 3%, drawdown máximo estático de 6%.
• 2-Step: targets de 5% e depois 10%, perda diária fixa de 5%, drawdown trailing de 8% que segue seu pico de equity (para no saldo inicial e nunca desce de volta — você pode ser reprovado mesmo estando positivo).
• Limites de alavancagem: 5x em BTC/ETH, 2x nas outras criptos, 4x em ações e commodities — aplicados automaticamente.

Destrinchei cada limite com exemplos numéricos no guia das regras da Propr explicadas. Para um bot, a tradução prática é: codifique a perda diária e o drawdown como hard stops antes de escrever uma linha de lógica de entrada. Uma parede fixa é trivial de codificar; o piso trailing do 2-Step exige rastrear estado. Essa assimetria é exatamente o motivo pelo qual recomendo automatizar o formato 1-Step — o raciocínio completo está em Propr 1-Step vs 2-Step.

Construir seu próprio bot — ou plugar um que já existe

Se você programa, a avaliação honesta: um bot DCA ou grid mínimo no SDK Python é projeto de fim de semana. Health check, leitura da conta, ordens agendadas, dois números de risco para fazer valer. O sandbox Beta permite errar barato antes de errar caro. Adicione um builder code e você é cidadão de primeira classe da plataforma. Encorajo sinceramente qualquer dev lendo isto a tentar — é a coisa mais divertida que dá para fazer com uma conta de prop firm.

Se você não programa — ou não quer manter infraestrutura, lidar com reconexões e vigiar um VPS — esse é o vão que o Bubbles fecha. É um bot de Telegram que roda uma estratégia DCA disciplinada na sua própria conta Propr por essa mesma API oficial, com sua perda diária e seu drawdown aplicados automaticamente como guardrails rígidos. Ou, via Radar, replica os trades de um Pilot profissional verificado. A configuração leva uns três minutos e a estratégia nunca faz revenge trading às 2h da manhã — sejamos honestos, é essa a funcionalidade que passa challenges.

O ponto non-custodial (leia antes de confiar em qualquer bot)

Uma coisa que o design da API acerta: acesso de trading não é acesso ao dinheiro. Sua chave pk_live_ coloca ordens, lê posições e gerencia trades — mas os payouts continuam ligados à sua conta Propr verificada por KYC e caem na sua própria carteira em USDC. Nenhum bot conectado por chave de API, Bubbles incluído, pode sacar seu dinheiro. Essa é a definição de automação non-custodial, e é a primeira coisa a verificar em qualquer ferramenta antes de conectá-la a uma conta financiada. Se um serviço pedir as chaves da sua carteira ou a custódia dos fundos em vez de uma chave de API estilo exchange, fuja.

Onde isso se encaixa no quadro geral

Uma API aberta, payouts em USDC on-chain e dados de pagamento publicados: é isso que separa a nova geração de prop firms on-chain das lojas de CFD tradicionais — comparo a categoria inteira no pilar das melhores prop firms descentralizadas. A Propr é hoje a expressão mais forte desse modelo: 5 tamanhos de conta (5K a 100K), 80% de profit split, payouts USDC em até 24h (~5h em média), sem limite de tempo, e uma API que trata seu bot como cliente em vez de ameaça. O teto funded é de US$ 200K somando as contas — espaço de sobra para uma estratégia sistemática compor a sério.

FAQ — a API da Propr.xyz

⚠️ Trading envolve risco. As especificações da API (endpoints, rate limits, formato das chaves) vêm da documentação oficial para desenvolvedores da Propr e as regras do rulebook oficial (v1.0.2, abril de 2026); ambos podem mudar — verifique sempre propr.xyz/developers e propr.xyz/rules antes de construir. Este artigo é informativo, contém links de afiliado e não é recomendação de investimento. Opere apenas o que você pode perder.