La API de Propr.xyz: automatiza tu challenge con un bot

La mayoría de las prop firms tratan la automatización como contrabando: bots prohibidos, copy trading prohibido, acceso a la API reservado a "socios institucionales" que nunca conocerás. Propr.xyz tomó el camino contrario — entrega una API REST pública, SDKs oficiales en Python y JavaScript, un sandbox para probar y un rulebook que permite bots explícitamente. Bubbles, mi propio bot, corre sobre esta misma API todos los días. Aquí va todo lo que importa de ella, lo que tu bot puede hacer realmente, y la decisión honesta entre construir el tuyo o conectar algo que ya funciona.

La respuesta corta

Sí, Propr.xyz tiene una API real, pública y documentada. Generas una clave en tu dashboard (empieza por pk_live_), la envías en el header X-API-Key, y puedes leer tu cuenta, gestionar posiciones y colocar órdenes en cuentas de evaluación y financiadas, con hasta 1.200 peticiones por minuto. La documentación vive en propr.xyz/developers y GitHub, y Propr promete una integración en menos de dos minutos — lo que coincide con mi experiencia: la autenticación es un header, sin baile de firmas, sin ceremonia OAuth.

Qué te da la API en concreto

La API está organizada como la querría quien construye bots: health checks sin autenticación (/health, /health/services), un endpoint de perfil /users/me y rutas autenticadas que cubren challenges, trading y ajustes de la cuenta. Los datos para apuntar en un post-it:

• Base URL: api.propr.xyz/v1, REST, JSON de entrada y salida.
• Auth: una clave de API por usuario, enviada como X-API-Key, con alcance completo de la cuenta (órdenes, posiciones, trades).
• Rate limit: 1.200 peticiones/minuto — de sobra para un bot DCA, un grid o un motor de copy trading sin malabares de batching.
• SDKs: paquetes oficiales de Python y JavaScript, mantenidos en el repositorio público de docs de Propr en GitHub.
• Entornos: Producción (trades reales en los mercados reales de Hyperliquid) y Beta — un sandbox que la propia Propr te dice que uses para probar tu bot primero.

Dos decisiones de diseño revelan que Propr va en serio. Primero, el entorno Beta: las firms que apenas toleran bots no te construyen un sandbox. Segundo, los builder codes — un header opcional X-Builder-ID que identifica tu bot o integración ante Propr, para que las herramientas legítimas reciban atribución, soporte y estabilidad de API en lugar de ser tratadas como tráfico sospechoso. La web de Propr le pone cifra al resultado: más de 1.000 agentes de IA ya operan en la plataforma.

Conseguir tu clave de API, paso a paso

1. Crea tu cuenta en Propr.xyz (con mi enlace recibes 5% de cashback en USDC sobre la cuota del challenge) — el login con Google funciona, y el KYC solo se exige más tarde, antes de pasar a funded.
2. Abre Settings en el dashboard y genera tu clave. Empieza por pk_live_.
3. Guárdala en una variable de entorno. No la subas nunca a un repositorio público — la clave tiene acceso completo de trading a tu cuenta, y solo tienes una (regenérala desde Settings si se filtra).

Si aún no tienes cuenta en Propr y quieres el recorrido completo — elección de challenge, cuotas, países restringidos — la guía de registro lo cubre todo.

¿Automatizar un challenge está siquiera permitido?

Explícitamente, sí. El rulebook oficial de Propr (v1.0.2, abril de 2026) permite bots, EAs y copy trading en ambos formatos de challenge y en las cuentas financiadas. No es una zona gris que explotas hasta que una revisión de payout te pille — es el posicionamiento de la firm. La página de inicio anuncia literalmente trading "agent friendly" y un "Prop Firm OS" pensado para devs. Para un trader sistemático eso cambia el cálculo de riesgo por completo: en la mayoría de las firms, el mayor riesgo no-mercado es una reinterpretación retroactiva de las reglas; en Propr, la automatización es el caso de uso previsto.

Las reglas que tu bot sigue teniendo que respetar

La API te dejará reventar tu cuenta sin protestar — los límites son trabajo tuyo. Lo que sea que ejecutes tiene que vivir dentro de los mismos límites que un trader humano:

• 1-Step: objetivo del 10%, pérdida diaria fija del 3%, drawdown máximo estático del 6%.
• 2-Step: objetivos del 5% y luego 10%, pérdida diaria fija del 5%, drawdown trailing del 8% que sigue tu pico de equity (se detiene en el saldo inicial y nunca vuelve a bajar — puedes quedar eliminado incluso estando en positivo).
• Topes de apalancamiento: 5x en BTC/ETH, 2x en el resto de criptos, 4x en acciones y materias primas — aplicados automáticamente.

Desgrané cada límite con ejemplos numéricos en la guía de las reglas de Propr explicadas. Para un bot, la traducción práctica es: codifica la pérdida diaria y el drawdown como hard stops antes de escribir una sola línea de lógica de entrada. Un muro fijo se programa trivialmente; el suelo trailing del 2-Step exige rastrear estado. Esa asimetría es exactamente la razón por la que recomiendo automatizar el formato 1-Step — el razonamiento completo está en Propr 1-Step vs 2-Step.

Construir tu propio bot — o conectar uno que ya existe

Si programas, la evaluación honesta: un bot DCA o grid mínimo sobre el SDK de Python es un proyecto de fin de semana. Health check, lectura de la cuenta, órdenes programadas, dos números de riesgo que hacer cumplir. El sandbox Beta te permite equivocarte barato antes de equivocarte caro. Añade un builder code y eres ciudadano de primera clase de la plataforma. Animo de verdad a cualquier dev que lea esto a probarlo — es lo más divertido que se puede hacer con una cuenta de prop firm.

Si no programas — o no quieres mantener infraestructura, gestionar reconexiones y vigilar un VPS — ese es el hueco que cierra Bubbles. Es un bot de Telegram que ejecuta una estrategia DCA disciplinada en tu propia cuenta de Propr a través de esta misma API oficial, con tu pérdida diaria y tu drawdown aplicados automáticamente como límites estrictos. O, vía el Radar, replica los trades de un Pilot profesional verificado. La configuración lleva unos tres minutos y la estrategia nunca hace revenge trading a las 2 de la madrugada — seamos honestos, esa es la funcionalidad que aprueba challenges.

El punto non-custodial (léelo antes de confiar en cualquier bot)

Algo que el diseño de la API hace bien: el acceso al trading no es acceso al dinero. Tu clave pk_live_ coloca órdenes, lee posiciones y gestiona trades — pero los payouts siguen ligados a tu cuenta de Propr verificada por KYC y llegan a tu propia wallet en USDC. Ningún bot conectado por clave de API, Bubbles incluido, puede retirar tu dinero. Esa es la definición de automatización non-custodial, y es lo primero que debes verificar de cualquier herramienta antes de conectarla a una cuenta financiada. Si un servicio te pide las claves de tu wallet o la custodia de tus fondos en lugar de una clave de API estilo exchange, huye.

Dónde encaja esto en el cuadro general

Una API abierta, payouts en USDC on-chain y datos de pagos publicados: eso es lo que separa a la nueva generación de prop firms on-chain de las tiendas de CFD de toda la vida — comparo la categoría completa en el pilar de las mejores prop firms descentralizadas. Propr es hoy la expresión más sólida de ese modelo: 5 tamaños de cuenta (5K a 100K), 80% de profit split, payouts USDC en menos de 24 h (~5 h de media), sin límite de tiempo, y una API que trata a tu bot como cliente en lugar de amenaza. El tope funded es de 200.000 $ sumando cuentas — margen de sobra para que una estrategia sistemática componga en serio.

FAQ — la API de Propr.xyz

⚠️ El trading conlleva riesgo. Las especificaciones de la API (endpoints, rate limits, formato de claves) provienen de la documentación oficial para desarrolladores de Propr y las reglas del rulebook oficial (v1.0.2, abril de 2026); ambas pueden cambiar — comprueba siempre propr.xyz/developers y propr.xyz/rules antes de construir. Este artículo es informativo, contiene enlaces de afiliado y no constituye asesoramiento de inversión. Opera solo con lo que puedas permitirte perder.