Cómo usar las referencias y guías de cTrader Algo

cTrader viene equipado con un conjunto completo de materiales complementarios que incluyen documentación extensa (parte de la cual está leyendo actualmente) y videos educativos. En este artículo, explicamos cómo puede utilizar eficazmente este tesoro de información. La API de algoritmos tiene muchos miembros, y saber cómo obtener rápidamente información sobre lo que necesita es esencial.

Acceder a la documentación y guías

Puede encontrar fácilmente materiales educativos directamente en cTrader Windows. Para hacerlo, abra la aplicación Algo y seleccione cualquier algoritmo. En la columna a la derecha de la ventana del editor de código, debería ver la documentación de la API completamente integrada dentro de la plataforma.

De hecho, es muy probable que esté leyendo este artículo dentro de cTrader.

Alternativamente, puede visitar el Centro de Ayuda de cTrader y abrir la sección que cubre las operaciones algorítmicas. En ella, debería ver la misma interfaz y estructura que vería en cTrader Windows regular. Por último, pero no menos importante, puede visitar nuestro canal de YouTube donde puede ver guías en video que cubren los algoritmos de cTrader. Tenga en cuenta que todas estas guías también están disponibles como videos incrustados en el Centro de Ayuda y en la documentación integrada de la API.

Navegar por la documentación

La documentación contiene varias secciones esenciales.

Conceptos básicos de C# y .NET. Esta breve introducción a los principios básicos de C# y .NET es perfecta para cualquiera que busque comenzar a crear algoritmos personalizados.

cBots e Indicadores. Estas guías cubren el proceso de creación de cBots e indicadores desde cero y proporcionan varios fragmentos de código que puede reutilizar libremente al crear sus propios algoritmos.

Características de la API. La documentación en esta sección detalla cómo puede trabajar con varias características importantes de la API de Algo, especialmente el acceso a la red y el almacenamiento local. Las guías de Operaciones avanzadas de cBot y Operaciones avanzadas de indicadores contienen fragmentos de código para tipos complejos de algoritmos de cTrader, como indicadores anidados.

Referencias. Las referencias de la API contienen descripciones de cada miembro de la API, lo que significa que puede leer información sobre lo que puede obtener o establecer a través de ciertas propiedades, los posibles valores de varios enum y lo que devuelven ciertos métodos. La misma información se proporciona en la ventana del editor de código cuando pasa el cursor sobre un miembro específico de la API.

Usar fragmentos de código

Los fragmentos de código extensos son una de las características clave de esta documentación. Independientemente del tipo de algoritmos que desee crear, existe una alta probabilidad de que la documentación contenga código que pueda reutilizar libremente. Para demostrarlo, podemos crear un cBot simple que se ejecute casi en su totalidad con código tomado de la documentación con algunas pequeñas modificaciones.

Para hacerlo, primero crearemos un nuevo cBot. Esto se hace haciendo clic en el botón Nuevo cBot o, si no puede verlo, abriendo el menú desplegable en la parte superior de la lista de algoritmos y seleccionando la misma opción.

Crearemos un cBot simple que opere con múltiples símbolos. Queremos operar con noticias, por lo que tiene sentido tener un algoritmo que opere con todos los símbolos relacionados con esa noticia.

Para hacerlo, abriremos la documentación integrada de la API de Algo y escribiremos "múltiples símbolos" en su barra de búsqueda. Como muestran los resultados de la búsqueda, hay una subsección que discute la operación con otros símbolos en la guía de Operaciones avanzadas con cBots. Si hacemos clic en este resultado específico, seremos llevados inmediatamente al fragmento de código relevante, así como a alguna información complementaria. Podemos copiar y pegar inmediatamente el fragmento en nuestro cBot.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

  [Robot()]
  public class Sample_cBot : Robot
  {
    protected override void OnStart()
    {
        var symbol = Symbols.GetSymbol("GBPUSD");

        if (symbol is not null)
        {
            _ = ExecuteMarketOrder(TradeType.Sell, symbol.Name, symbol.VolumeInUnitsMin);
        }
    }
  }

La información sobre el fragmento de código nos dice que podemos usar la colección Symbols para encontrar los símbolos que queremos. Supongamos que el Tesoro de EE. UU. está dando otro discurso sobre el ciclo de tasas de interés y queremos abrir posiciones de venta al inicio para varios índices basados en EE. UU. (pero no para el símbolo al que está adjunto nuestro cBot).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

[Robot()]
  public class Sample_cBot : Robot
  {
    protected override void OnStart()
    {
        var symbolOne = Symbols.GetSymbol("US 500");

        var symbolTwo = Symbols.GetSymbol("US 30");

        var symbolThree = Symbols.GetSymbol("US TECH 100");

        if (symbolOne is not null && symbolTwo is not null && symbolThree is not null)
        {
            ExecuteMarketOrder(TradeType.Sell, symbolOne.Name, symbolOne.VolumeInUnitsMin);
            ExecuteMarketOrder(TradeType.Sell, symbolTwo.Name, symbolTwo.VolumeInUnitsMin);
            ExecuteMarketOrder(TradeType.Sell, symbolThree.Name, symbolThree.VolumeInUnitsMin);
        }
    }
  }

Al inicio, nuestro cBot ejecutará las operaciones requeridas. Consultar la documentación de la API nos ha permitido ahorrar mucho tiempo al reutilizar código existente y solo modificarlo ligeramente para adaptarlo a nuestras necesidades.

Resumen

cTrader le permite acceder a la documentación de la API en varios lugares diferentes, especialmente dentro de la plataforma misma. Es una forma increíblemente conveniente de potenciar sus algoritmos, ya que simplemente puede reutilizar fragmentos de código de la documentación después de introducir las modificaciones necesarias. También recomendamos encarecidamente suscribirse a nuestro canal de YouTube para que se actualice cada vez que lanzamos un nuevo video educativo.