API Trading en Upscale: cómo conectar un bot a tu challenge
Upscale ya ofrece API Trading, una opción que da acceso programático a tu challenge. Con ella puedes conectar a tu cuenta un bot de trading, tu propio script o un motor algorítmico que ya utilices. La opción está disponible en cuentas con un nominal de $10,000 o más, y también en cuentas demo. A continuación explicamos cómo conectar la API, cómo es la primera ejecución del código, qué reglas se aplican a una cuenta con la opción y a quién le resulta realmente útil.
Qué es API Trading en Upscale
Una API (Application Programming Interface) permite gestionar una cuenta mediante peticiones enviadas desde código, sin pasar por la interfaz del terminal. Un programa envía una petición como «abre una posición» o «muestra las posiciones actuales», y el servidor de Upscale la ejecuta y devuelve una respuesta. Todo lo que un trader hace a mano en el terminal, el algoritmo lo hace por sí solo, siguiendo reglas definidas y sin intervención humana. Este enfoque se conoce como trading algorítmico.
Un algoritmo de trading puede basarse en cualquier cosa: indicadores de análisis técnico, un parser de noticias, un calendario económico o una combinación de estas fuentes. Pero toda estrategia termina en la misma acción: una orden. Para operar por API, un programa necesita en esencia dos cosas: enviar órdenes y vigilar el estado de la cuenta, sobre todo el drawdown. Lo demás, como consultar el historial o cerrar posiciones en bloque, son detalles de implementación.
Para qué sirve la opción
El primer escenario es un bot de trading con tu propia estrategia. El trader formaliza las reglas de entrada y salida, y el script vigila el mercado y abre operaciones cuando se cumplen las condiciones. Un algoritmo no se cansa ni se distrae, y puede seguir trabajando mientras el trader duerme.
El segundo escenario es para quien ya tiene un motor algorítmico. Upscale se conecta a él como un venue de ejecución más: la lógica de la estrategia se mantiene y solo cambia el destino de las órdenes.
El tercer escenario es el control del riesgo y la analítica. A través de la API puedes obtener en tiempo real datos de la cuenta, las posiciones y las órdenes, y construir tu propia telemetría de trading. También puedes configurar el cierre automático de posiciones cuando la cuenta se acerque a su límite de drawdown. Esto es importante porque en Upscale los límites se calculan incluyendo el PnL no realizado: una posición abierta en pérdidas reduce el balance de inmediato, no en el momento del cierre. Este control reduce el riesgo, pero no garantiza el resultado: ante un movimiento brusco del precio, la posición puede cerrarse en un nivel peor del previsto.
Dónde está disponible la opción
API Trading se puede añadir a challenges con un nominal de $10,000 o superior. No está disponible en cuentas de $1,000 y $5,000.
Hay dos formas de obtener la opción. La primera es elegirla al tramitar el pedido del challenge: en ese caso, la cuenta se crea con la API ya habilitada. La segunda es añadirla a un challenge que ya está en marcha. Para ello, la cuenta debe estar activa, tener un nominal de $10,000 o más y no haber pasado todavía a la fase fondeada, y la opción no debe haberse activado antes en ella. Si alguna condición no se cumple, la plataforma indica el motivo.
Si la opción se activó antes del paso a la fase fondeada, la API sigue funcionando en la cuenta fondeada. No se puede añadir a un challenge que ya ha llegado a la fase fondeada.
Las cuentas Turbo, que se abren directamente en la fase fondeada, son un caso aparte. La opción también está disponible en ellas, pero no para todos los nominales. Las variantes vigentes se muestran al tramitar la cuenta.
API Trading también está disponible en cuentas demo, así que lo mejor es empezar por ahí. En demo puedes probar tu código, los límites de peticiones y el comportamiento de las reglas sin arriesgar nada.
Cómo conectar la API paso a paso
En una cuenta demo, la opción se activa al crear el challenge. Pulsa «Probar en demo» y activa el interruptor «API Trading». La plataforma mostrará un aviso sobre las reglas adicionales. Confirma la conexión y pulsa «Empezar a operar». En tu lista de cuentas aparecerá una cuenta demo marcada con la API habilitada.
Para un challenge real, el proceso es el mismo que se describe arriba: la opción se elige al tramitar el pedido o se añade a una cuenta activa.
Para que tu código acceda a la cuenta, necesitas una clave API. Abre los ajustes de tu cuenta y ve a la sección de ajustes de API. Por defecto no hay ninguna clave. Pulsa «Crear», asigna un nombre a la clave y, si lo necesitas, una fecha de caducidad, y confirma.
La clave se muestra una sola vez. Cópiala y guárdala de inmediato en un lugar seguro, por ejemplo en un gestor de contraseñas. Es una medida de seguridad estándar: si la clave pudiera volver a consultarse, cualquier persona con acceso a tu dispositivo podría copiarla y operar en tu nombre. Si pierdes la clave o queda comprometida, crea una nueva. Los principios generales de protección del acceso por API se recogen en las recomendaciones de OWASP API Security.
Primera ejecución: un ejemplo de la documentación
La documentación de la API de Upscale describe en detalle la autenticación, los límites de peticiones, los valores admitidos de los parámetros y los códigos de error. También recoge los endpoints para operar: datos de cuentas, posiciones, órdenes y estado actual de los mercados.
Lo más cómodo es empezar por la sección Quickstart. Incluye dos ejemplos de código listos para usar, uno en Python y otro en JavaScript, y ambos ejecutan el mismo escenario:
- obtienen la lista de tus cuentas para determinar con cuál trabajar;
- obtienen la lista de mercados y localizan BTC;
- abren una orden de mercado en largo de $100 con apalancamiento 5×;
- consultan la posición para confirmar que realmente se ha abierto;
- cierran la posición.
Para ejecutar el código del Quickstart, cópialo en un editor, indica tu clave API y lanza el script. La posición se abrirá y se cerrará sin una sola acción en el terminal. El objetivo de este código no es ganar dinero, sino comprobar que la clave, el código y la cuenta funcionan juntos, así que conviene ejecutarlo en una cuenta demo.
A continuación, vale la pena estudiar la sección de la documentación sobre la creación de órdenes. En ella se describen los tipos de orden disponibles y la función de cada parámetro: qué apalancamiento indicar, cómo especificar la cuenta y el mercado, cuándo se necesita el ID de la posición y en qué casos es obligatorio el precio de activación.
Un asistente de IA en lugar de escribir el código a mano
No hace falta escribir el script desde cero. Si tu estrategia se puede describir con palabras, por ejemplo «en un rebote desde un soporte, colocar una orden límite con tal stop», puedes pasársela a un asistente de IA junto con la documentación de la API de Upscale y pedirle que escriba el bot. La primera versión funcional está lista en pocos minutos. El script se ejecuta en local: tu ordenador aloja el algoritmo y envía las peticiones al servidor de Upscale. No necesitas un servidor aparte.
Con este enfoque, conviene respetar tres reglas.
No compartas tu clave API en el chat con la IA. Guarda la clave en una variable de entorno o en un archivo de configuración local que el código lea al arrancar. Es la práctica habitual para mantener los secretos fuera del código.
Revisa la lógica del código generado. La IA puede pasar por alto las comisiones, el funding o las reglas de la cuenta, y entonces el resultado real será distinto del previsto. Ejecuta siempre las primeras versiones en una cuenta demo.
La automatización no corrige una estrategia. Un bot hace exactamente lo que se le ha programado, solo que más rápido y sin pausas. Si la idea pierde dinero a largo plazo, el algoritmo simplemente llevará antes la cuenta a su límite de drawdown.
Un ejemplo típico es promediar a la baja. Cuando el precio va en contra de la operación, el bot compra más del activo para bajar el precio medio de entrada y salir en positivo con un pequeño rebote. Muchos «robots de trading» que se ofrecen a principiantes se basan en esta lógica. Si el mercado se da la vuelta, el esquema parece funcionar. Pero si el movimiento continúa, cada promediado aumenta la posición y, con ella, la pérdida.
Tomemos una cuenta Básica de $10,000 con un límite de drawdown diario del 5% ($500) y un drawdown máximo del 10% ($1,000). El bot abre un largo de $2,000 y duplica la posición tras cada caída del precio del 2%. Después de cuatro caídas así, la posición ha crecido hasta $16,000 y la pérdida ronda los $600, de modo que el límite diario ya se ha superado. Aunque la caída se reparta en varios días, tras el quinto paso la posición llega a $32,000 y la pérdida total, de unos $1,240, supera el drawdown máximo. La pérdida de una posición abierta cuenta para el drawdown de inmediato, así que la cuenta se cerrará antes de cualquier rebote.
Reglas que se aplican a una cuenta con la opción API
El acceso por API trae restricciones adicionales en la cuenta. La plataforma avisa de ellas antes de la conexión y, una vez activada, la opción no se puede desactivar: las reglas se mantienen hasta el final del challenge.
Límite de frecuencia de peticiones. Si un programa envía peticiones con más frecuencia de la que permite el servidor, este devuelve un error y la petición no se ejecuta. Es un mecanismo estándar de protección de APIs, similar a la respuesta HTTP 429. Los límites exactos figuran en la documentación de la API, y conviene incorporarlos a la lógica del bot desde el principio.
Ajuste de profit de 60 segundos. Cada vez que se abre o se aumenta una posición, empieza una ventana de 60 segundos. Si dentro de esa ventana la posición se cierra total o parcialmente en positivo, ese profit no se contabiliza. Las pérdidas, las comisiones y el funding sí se cuentan íntegramente. Cada nuevo aumento de la posición reinicia la ventana. Por ejemplo, una posición se abre a las 12:00:00 y se cierra con un profit de $180 a las 12:00:40. Solo han pasado 40 segundos, así que el resultado contabilizado es cero. Si esa misma posición se hubiera cerrado a las 12:01:10, el profit de $180 se habría contado íntegro.
Regla del 30%. El día más rentable no debe suponer el 30% o más del profit total. En las fases del challenge es condición para pasar a la siguiente fase; en la fase fondeada, condición para poder recibir el payout. Por ejemplo, con un profit diario de +$200, +$300, +$1,500, +$300 y +$200, el resultado total es de $2,500 y el mejor día supone el 60%. Para que su peso baje al 30%, el profit total tiene que crecer hasta $5,000.
Ambas reglas se aplican a toda la cuenta, no solo a las operaciones realizadas por API. Si tu algoritmo deja de funcionar y decides seguir operando a mano en el terminal, las restricciones se mantienen: hay que mantener las operaciones más de 60 segundos y repartir el profit de forma uniforme. Las condiciones completas de la opción y la mecánica de ambas reglas se describen en la documentación, en la página API Trading.
Así se ve en la interfaz. En la tarjeta de la cuenta aparece un icono de API 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 a un cierre se le aplicó el ajuste de 60 segundos, el historial de la posición muestra el resultado como 0 USD. Al pasar el cursor en escritorio o tocar en móvil aparece una explicación con el importe original del profit.
A quién no le hace falta la opción
API Trading es una herramienta para quien ya tiene claro para qué necesita la automatización. La opción no hace que operar sea más fácil por sí sola ni convierte un script cualquiera en un sistema rentable.
Si operas manualmente y no piensas conectar herramientas programáticas, no tiene sentido activar la opción. No usarás el acceso por API, pero las reglas adicionales se aplicarán igualmente a tu cuenta. Si la automatización te interesa pero aún no tienes experiencia, empieza por una cuenta demo: allí los errores en el código no cuestan nada.
Conclusiones clave
API Trading lleva la operativa programática a Upscale: a un challenge con un nominal de $10,000 o más se puede conectar un bot, un script propio o un motor algorítmico existente. En los challenges, la opción se activa antes del paso a la fase fondeada y sigue funcionando en la cuenta fondeada. También está disponible para parte de los nominales de las cuentas Turbo y en cuentas demo, que es donde conviene probar primero el código y la estrategia.
Para empezar, basta con activar la opción y crear una clave API en los ajustes. La clave se muestra una sola vez y queda solo en manos del trader. El Quickstart de la documentación comprueba toda la conexión en un par de minutos abriendo y cerrando una posición. No hace falta escribir el código desde cero: un asistente de IA puede crear un bot a partir de una descripción de la estrategia en lenguaje natural, pero la clave nunca debe compartirse en el chat, y la lógica y el cálculo de comisiones hay que revisarlos personalmente.
Lo principal que hay que tener en cuenta antes de activar la opción es que el ajuste de profit de 60 segundos y la regla del 30% pasan a aplicarse a toda la cuenta, incluidas las operaciones manuales, y no se pueden desactivar. La opción resulta útil para quien opera de forma algorítmica y mantiene las posiciones más de un minuto. Quien opera solo de forma manual no la necesita.
Empieza ahora: 👉 Upscale.trade | Bot de Telegram
Síguenos: 📺 YouTube | 𝕏 Twitter
Comunidad: 💬 Chat de Telegram | 🎮 Discord
Preguntas frecuentes
¿Qué es API Trading en Upscale?
Es una opción adicional del challenge que abre el acceso programático a la cuenta. Con ella puedes conectar a la cuenta un bot de trading, tu propio script o herramientas de analítica, y las órdenes y los datos de las posiciones se transmiten mediante peticiones desde el código, sin usar la interfaz del terminal.
¿En qué cuentas está disponible la opción?
La opción está disponible en challenges con un nominal de $10,000 o más. No está disponible en cuentas de $1,000 y $5,000. En las cuentas Turbo no se ofrece para todos los nominales: las variantes vigentes se muestran al tramitar la cuenta. La API también se puede activar en una cuenta demo.
¿Puedo añadir la API a una cuenta en la fase fondeada?
La opción no se puede añadir a un challenge que ya ha pasado a la fase fondeada. Se puede elegir al tramitar el pedido del challenge o añadir a una cuenta activa antes de ese paso. Si la opción se activó antes, la API sigue funcionando en la cuenta fondeada. Las cuentas Turbo se abren directamente en la fase fondeada, y la opción está disponible para parte de sus nominales.
¿Dónde consigo una clave API?
La clave se crea en los ajustes de tu cuenta, en la sección de ajustes de API. Hay que asignarle un nombre y, si hace falta, una fecha de caducidad. La clave se muestra una sola vez, así que guárdala de inmediato en un lugar seguro. Si la pierdes, crea una nueva.
¿Qué reglas se aplican a una cuenta con la opción API?
Se aplican el límite de frecuencia de peticiones, el ajuste de profit de 60 segundos y la regla del 30%. El profit de una operación cerrada en positivo menos de 60 segundos después de abrir o aumentar la posición no se contabiliza, mientras que las pérdidas y las comisiones se cuentan íntegramente. El día más rentable no debe suponer el 30% o más del profit total: en las fases del challenge es condición para pasar a la siguiente fase, y en la fase fondeada, condición para el payout.
¿Estas reglas se aplican también a las operaciones manuales?
Sí. Las reglas se aplican a toda la cuenta, independientemente de cómo se haya abierto la operación: por API o manualmente en el terminal. La opción no se puede desactivar después de activarla: las reglas se mantienen hasta el final del challenge.
¿Hay que saber programar para operar por API?
Tener nociones básicas de programación facilita mucho el trabajo, pero no hace falta escribir el script desde cero. La documentación incluye ejemplos listos para usar en Python y JavaScript, y un asistente de IA puede escribir un bot a partir de una descripción de la estrategia en lenguaje natural. El código generado debe probarse en una cuenta demo, y la clave API debe guardarse en una variable de entorno y nunca compartirse en el chat.
¿Me conviene la opción si opero manualmente?
No. Si no piensas conectar herramientas programáticas, no usarás el acceso por API, pero las reglas adicionales se aplicarán igualmente a tu cuenta.
