Сервер истории

Для разработчиков механических торговых систем в группе компаний «АЛОР» создан сервер истории, который предоставляет возможность по протоколу HTTP получить историю сделок на основных торговых площадках России. Сервер легко интегрируется с аналитическими системами и МТС.

1. URL сервера — http://history.alor.ru/.

2. Сервер может принимать следующие параметры методом GET:

   • board — торговая площадка, историю на которой нужно получить; возможные значения — MICEX (ФБ ММВБ, Основной рынок), FORTS (Срочный рынок FORTS), FUTURES (Срочный рынок MICEX);
   • ticker — тикер (SECCODE) инструмента на указанной площадке;
   • period — период свечи в минутах; возможные значения — 1, 5, 10, 15, 20, 30, 60, 1440;
   • from — дата в формате Y-m-d или дата и время в формате Y-m-d H:i:s, с которого включительно нужно получить историю; если указана только дата, то считается, что указано время 00:00:00;
   • to — дата в формате Y-m-d или дата и время в формате Y-m-d H:i:s, до которого включительно нужно получить историю; если указана только дата, то считается, что указано время 00:00:00;
   • bars — максимальное количество свеч, которое нужно получить (не менее 1 и не более 1000).

   При получении параметров сервер производит проверку их корректности. В случае обнаружения первой ошибки во входных данных, в теле HTTP-ответа возвращается текст, поясняющий ошибку, и обработка запроса на этом заканчивается.

   В запросе обязаны присутствовать параметры ticker и period, а также хотя бы один из параметров from, to или bars (комбинация from, to или bars при этом может быть произвольной), в противном случае возвращается ошибка Absent parameter. Пустые параметры запроса игнорируются (считаются отсутствующими).

   Если какой-либо параметр не соответствует требованиям, возвращается ошибка Wrong <parameter>, где <parameter> — название параметра.

3. Если входные данные корректны, сервер возвращает список свеч, удовлетворяющих запросу, отсортированные по дате и времени свечи по убыванию. Если указан параметр bars, то возвращается указанной в нем число свеч, в противном случае возвращается не более 1000 свеч. Если указан параметр from и не указан параметр to, то возвращаются свечи, «поджатые» ко времени начала указанного в запросе периода (from), во всех остальных случаях — ко времени окончания указанного в запросе периода (если указан параметр to — ко времени to, если не указан — к текущему серверному времени).

   Возвращаемый тип контента — text/plain. Возвращаются следующие поля свеч: DATE, OPEN, HIGH, LOW, CLOSE, VOLUME. Формат поля DATE — Y-m-d H:i:s, разделителем для остальных полей является точка (.).

   Поля записи разделены табуляцией (\t), записи разделены символом новой строки (\n). После последней записи также присутствует символ новой строки (\n).

   Если свеч, удовлетворяющих запросу, нет, то сервер возвращает пустой HTTP-ответ.

4. На сервере хранятся «N-минутки» (период 1, 5, 10, 15, 20, 30, 60 минут) за последний год, «дневки» (период 1440 минут) — за всю историю торгов.

Форма для тестирования сервиса

Для того чтобы лучше понять, как работает сервер истории, мы предлагаем Вам воспользоваться формой для тестирования сервиса и самим все посмотреть.