API Trading es una opción adicional que habilita la operativa programática en un challenge concreto: conectar un bot de trading, tus propios scripts, herramientas de analítica o un agente de IA.
Disponibilidad
| Parámetro | Valor |
|---|---|
| Nominal mínimo de la cuenta | $10,000; en cuentas de $1,000 y $5,000 la opción no está disponible |
| Precio | por el momento la opción es gratuita |
| Fase del challenge | se puede activar mientras la cuenta no haya pasado a la fase fondeada |
| Cuenta demo | la opción se activa al crear el challenge |
Un descuento sobre el challenge no se aplica al precio de las opciones: las opciones de pago se cobran siempre íntegras.
Cuándo se puede activar
La opción se elige al tramitar el pedido. Tras el pago, el challenge queda marcado como API-enabled y las reglas adicionales empiezan a aplicarse.
La opción puede añadirse a un challenge que ya está en marcha si se cumple todo lo siguiente:
- el challenge está activo;
- el challenge no está en la fase fondeada;
- el nominal de la cuenta es de $10,000 o más;
- la opción no se ha activado ya en esa cuenta.
Si alguna condición no se cumple, la plataforma indica el motivo por el que no está disponible.
Qué incluye la opción
| Regla | Qué significa |
|---|---|
| Límite de frecuencia de peticiones | al superarlo, el servidor devuelve un error y la petición no se ejecuta |
| Ajuste de profit de 60 segundos | Un cierre en positivo realizado menos de 60 segundos después de abrir o aumentar la posición no se contabiliza |
| Regla del 30% | El día más rentable no debe suponer el 30% o más del profit total: es condición para superar cada fase y para poder recibir el payout |
La mecánica de ambas reglas se describe en la página Reglas del challenge y del trading.
Cómo se ve en la interfaz
En la tarjeta de la cuenta aparece un icono de API entre las opciones conectadas y un bloque «Día de máximo profit» con el valor actual de la regla del 30%, igual que en las cuentas Turbo.
Si se aplicó el ajuste de 60 segundos a un cierre o a un cierre parcial, en el historial de la posición el resultado contabilizado aparece como 0 USD. Al pasar el cursor en escritorio o tocar en móvil se muestra una explicación con el motivo y el profit original. Los totales de la posición y de la cuenta usan únicamente el valor ajustado.
A quién le conviene
La opción está pensada para quien opera de forma algorítmica: conectando un bot o un agente de IA, automatizando entradas y salidas o recogiendo telemetría de su operativa con herramientas propias.
Si operas manualmente y no piensas conectar herramientas programáticas, no hay motivo para activarla: no usarás el acceso por API, pero las restricciones en la cuenta seguirán ahí.
Inicio rápido
La clave API se crea en el terminal: configuración de la cuenta → API y MCP → pestaña de claves API. A través de la API solo están disponibles las cuentas con la opción API Trading activada. La opción se puede activar en la misma página, con el botón para configurar cuentas.
La clave es solo para el titular de la cuenta: no la publiques ni la entregues a otros traders. Compartirla supone una infracción de las reglas.
Todo lo necesario para el trading por API está reunido en la sección Developers, una sección independiente de la documentación pensada para desarrolladores.
| Qué hay allí | Para qué sirve |
|---|---|
| Inicio rápido | abrir y cerrar una posición en cinco solicitudes, con scripts listos para ejecutar en JavaScript y Python |
| Autenticación | cómo obtener la clave API y enviarla en las solicitudes |
| Convenciones | formato de los números, unidades de los campos y tratamiento de las solicitudes repetidas |
| Límites de solicitudes | el tope de frecuencia con el que se puede llamar a la API |
| Errores | códigos de respuesta y qué significan |
| Operaciones | referencia de las solicitudes, agrupadas en «Cuentas», «Configuración» y «Trading» |
Cada solicitud de la referencia se puede ejecutar desde su propia página: en el bloque API Playground se introducen la clave y los parámetros, y el botón de envío devuelve una respuesta real de la plataforma. Ahí mismo está el código listo de la solicitud para cURL, JavaScript y Python.
Conexión de un agente de IA mediante MCP
Puedes conectar a tus cuentas un agente de IA: ChatGPT, Claude, Claude Code o Cursor. El agente funciona mediante MCP: muestra los datos de la cuenta y las posiciones abiertas, y puede colocar órdenes cuando se lo pidas.
El agente solo tiene acceso a las cuentas con la opción API Trading activada, y en ellas se aplican todas las reglas de la opción descritas más arriba. Si no tienes ninguna cuenta así, la plataforma te propone activar la opción o probar el agente en una cuenta demo.
Dirección del servidor: https://mcp.upscale.trade
- Abre la configuración de API y MCP, ve a la pestaña MCP, pulsa «Conectar» y elige tu agente: cada uno tiene instrucciones paso a paso.
- Añade la dirección del servidor en los ajustes del agente.
- El agente abre en el navegador una página de confirmación. Pulsa «Permitir acceso» y vuelve al agente.
Ejemplo para Claude Code:
claude mcp add --transport http upscale https://mcp.upscale.trade
Añade la dirección del servidor y tu clave API a la configuración del agente. En este caso no se muestra la página de confirmación.
{ "mcpServers": { "upscale": { "url": "https://mcp.upscale.trade", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }Las conexiones hechas por dirección del servidor aparecen en la pestaña MCP con la fecha de conexión y la del último uso. El botón «Desconectar» retira de inmediato al agente el acceso a tus cuentas. Las conexiones hechas por clave API no aparecen en esta lista: para desconectar un agente así, elimina la clave.
Puedes crear hasta 10 claves API por cuenta. Cada agente conectado por dirección del servidor también computa en este límite.