Кубик "Trades Logger"

Кубик опубликован с разрешения автора Sergey Gilyazov из группы ТСЛаб в телеграм.

Кубик предназначен для записи информации по сделкам в файл формата csv. Один и тот же файл может использоваться для записи сделок нескольких агентов. Работает только в режиме агента, записывает данные о сделках закрытых на последнем баре.
Записывает следующие данные: Имя агента; Tag1; Tag2; Направление трейда; Инструмент; Максимальный размер позиции; Сигнал входа; Дата и время входа; Цена входа; Сигнал выхода; Дата и время выхода; Цена выхода; Прибыль(пункты); Прибыль(деньги); Прибыль %; Счет. Принцип работы кубика: на последнем баре кубик проверяет есть ли сделка, которая была открыта на предпоследнем баре, на закрылась на последнем баре, если такая сделка существует, то она помещается в список для записи, после чего вызывается метод записи в файл. Для записи всех сделок можно использовать как разные файлы, так и один и тот же. В случае если используется один и тот же файл, то при попытке записи в файл если он будет занят в этот момент записью информации с другого агента, вся информация по сделкам записывается в кеш платформы ТСЛаб после чего при следующей попытке записи в файл будет записана в него в полном объеме, таким образом, обеспечивается сохранность необходимой информации о сделках. В дальнейшем файл можно использовать для анализа в любых поддерживающих данный формат программах анализа данных.

Важные примечания:
-- использование в сигналах входа/выхода, имени агента и т.д. символа | может привести к неверной записи данных
-- прибыль в пунктах и процентах рассчитывается тслаб. Прибыль в деньгах рассчитывается как Прибыль в пунктах / шаг цены * стоимость шага цены

Настройки кубика:

• FilePath. Путь к файлу необходимо указывать через двойной знак "\\", например, С:\\TSLabStats\trades.csv
• UseAgentTradeName. Использовать торговое имя агента вместо вводимого в параметрах кубика. При установке данной опции при записи данных в файл вместо указанно в кубике имени будет всегда использоваться торговое имя агента из ТСЛаб
• TradeName. Имя торгового агента. Используется если не включена опция UseAgentTradeName. Данная опция позволяет задать имя для записи в файл, которое отличается от имени торгового агента в ТСЛаб
• Tag1. Метка. Произвольная метка (дополнительный столбец в файле сделок) для группирования агентов для удобства фильтрации сделок. Например "трендовые" и "контртрендовые"
• Tag2. Метка. Произвольная метка (дополнительный столбец в файле сделок) для группирования агентов для удобства фильтрации сделок. Например "спот" и "фьючи"
• MessageToLog. Выводить в лог ТСлаб сообщение аналогичное записываемому в файл для дальнейшей пересылки через менеджер оповещений, либо для целей индикации о произведенной записи в формах логах платформы ТСЛаб. Сообщение будет указано как в основном логе платформы, так и в логе агента, сделка которого записана в файл
• MessageType. Тип сообщения, выводимого в лог: информационное, Warning и т.д.
• MessageTag. Дополнительное пользовательское сообщение, выводимое в лог

Общая информация по доп.кубикам:
================================
написание индикаторов для ТСЛаб: https://docs.tslab.pro/pages/viewpage.action?pageId=20185834
потоковые и не потоковые индикаторы: https://docs.tslab.pro/pages/viewpage.action?pageId=38961514
папка Handlers и создание индикаторов на API: https://docs.tslab.pro/pages/viewpage.action?pageId=20185716