Skip to content

Página de referência sobre este tema: Análise Propr.xyz →

Guia · API da Propr.xyz

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

10 jun 2026 11 min de leituraPor Roya — Roya Trading
API da Propr.xyz para trading automatizado — API REST, SDKs Python e JS, bots permitidos numa prop firm cripto

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. 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).

Link de afiliado. Ganhamos uma comissão; ela nunca muda o que você paga — é ela que financia seu cashback.

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 publicado da Propr, lido em 10 de setembro de 2026, permite bots, EAs e copy trading nos quatro 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 limites de risco 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 de 3%, drawdown máximo estático de 6%.
  • 2-Step: targets de 5% e depois 10%, perda diária 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).
  • A perda diária não é fixa: é 3% (1-Step) / 5% (2-Step) do saldo de início do dia, com snapshot às 00:00 UTC e recalculado todo dia; o gatilho é medido na equity, incluindo o P&L flutuante. Seu bot precisa reler o piso do dia em vez de guardar o número da véspera.
  • Limites de alavancagem: 5x em BTC/ETH (quadro lateral e changelog; a tabela §12 da mesma página diz 10x — não reconciliado na nossa leitura de 12 de setembro de 2026), 2x nas outras criptos, 4x em ações, 8x em ouro, prata, CL e Brent, 25x em FX — 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 os melhores bots de trading via API fecham. Um bot de Telegram pode rodar 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 limites de risco rígidos. Ou, via um radar de copy trading, replicar os trades de um Pilot profissional verificado. A configuração leva poucos 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, seja ele qual for, 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 e, se a sua prioridade é automação, a melhor prop firm para bots & API. A Propr é hoje a expressão mais forte desse modelo: 6 tamanhos de conta (5K a 200K), 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$ 300K somando as contas — espaço de sobra para uma estratégia sistemática compor a sério.

FAQ — a API da Propr.xyz

A Propr.xyz tem uma API pública?+

Sim. A Propr expõe uma API REST em api.propr.xyz/v1 além de SDKs oficiais em Python e JavaScript, com documentação em propr.xyz/developers e no GitHub. A autenticação usa uma chave de API enviada no header X-API-Key, e o limite é de 1.200 requisições por minuto.

Bots de trading são permitidos na Propr.xyz?+

Sim, explicitamente. O rulebook oficial da Propr permite trading automatizado (bots/EAs) e copy trading nos challenges 1-Step e 2-Step e nas contas financiadas. A Propr se apresenta como 'agent friendly' — mais de 1.000 agentes de IA já operam na plataforma.

Como obter uma chave de API da Propr.xyz?+

Crie uma conta em app.propr.xyz, vá em Settings e gere uma chave — ela começa com pk_live_. Você tem uma chave por usuário (regenere se vazar) e ela carrega acesso completo à conta: ordens, posições e trades. Guarde-a numa variável de ambiente, nunca no código.

Posso testar um bot sem arriscar meu challenge?+

Sim. A Propr oferece um ambiente Beta ao lado da Produção, justamente para você testar seu bot antes de apontá-lo para uma avaliação paga, onde os trades executam nos mercados reais da Hyperliquid. Rode sempre o sandbox primeiro e verifique o endpoint /health antes de operar.

Um bot conectado via API tem acesso aos meus fundos ou payouts?+

Não. A chave de API coloca ordens, lê posições e gerencia trades na sua conta Propr — os saques continuam ligados à sua conta verificada por KYC e à sua carteira. É isso que torna um bot conectado via API non-custodial: ele opera pela sua chave, mas nunca pode tocar nos seus USDC.

Preciso saber programar para automatizar um challenge da Propr?+

Não. Se você programa, os SDKs tornam um bot custom um projeto de fim de semana. Se não, um bot semi-automático já pronto roda uma estratégia DCA com limites de risco rígidos — ou copia um Pilot profissional via radar — na sua própria conta Propr pela API oficial, configurado pelo Telegram em poucos minutos.

Automação sem escrever uma linha de código.

Rode um bot DCA com limites de risco rígidos na sua própria conta Propr pela API oficial — non-custodial, configurado pelo Telegram em poucos minutos.

Receber 5% de cashback USDC

Ainda sem conta na Propr? Crie sua conta na Propr.xyz com 5% de cashback em USDC na taxa do challenge.

Link de afiliado. Ganhamos uma comissão; ela nunca muda o que você paga — é ela que financia seu cashback.

⚠️ 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 publicado, lido em 10 de setembro 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.

Newsletter

Entre para os VIP

Os melhores bônus de prop firm, alertas de airdrop e novas análises — direto no seu e-mail. Sem spam.

Usamos seu e-mail apenas para updates VIP. Cancele quando quiser.