---
title: "API Trading"
description: "La opción API Trading: disponibilidad, activación y reglas adicionales que activa en la cuenta"
icon: code
published: true
---

**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 o herramientas de analítica.

{% hint style="warning" %}
**La opción cambia las reglas de toda la cuenta.** Junto con el acceso por API, en la cuenta empiezan a aplicarse el [ajuste de profit de 60 segundos](Participation_Requirements_es.md#api-rules) y la [regla del 30%](Participation_Requirements_es.md#regla-30). Afectan a todas las operaciones de esa cuenta, tanto a las realizadas por API como a las hechas a mano en el terminal.

La opción no se puede desactivar: una vez activada, las reglas se mantienen durante toda la vida del challenge.
{% endhint %}

## 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

{% tabs %}
{% tab title="Con un challenge nuevo" %}
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.
{% endtab %}

{% tab title="En un challenge activo" %}
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.
{% endtab %}
{% endtabs %}

## 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](Participation_Requirements_es.md#api-rules).

{% hint style="info" %}
Ambas reglas cubren todas las operaciones de la cuenta, manuales y programáticas, en cualquier tipo de orden. La opción se llama API Trading, pero su efecto no se limita a la operativa por API.
{% endhint %}

## 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, 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 <a href="#quick-start" id="quick-start"></a>

La clave API se crea en el terminal, en la sección de API de la configuración de la cuenta. 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](https://docs.upscale.trade/es/developers), una parte aparte 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.

{% hint style="warning" %}
Las solicitudes lanzadas desde la referencia se ejecutan en una cuenta real: la orden que envíes se crea de verdad. Pruébalas en una cuenta demo.
{% endhint %}