История рынка для выбранных биржи и инструмента
GET/md/v2/history
Запрос может быть выполнен без авторизации. При отправке анонимного запроса вернутся данные, бывшие актуальными 15 минут назад.
Для этой операции есть альтернатива в виде WebSocket-подписки.
Запрос возвращает исторические данные о состоянии рынка для выбранных биржи и финансового инструмента
Request
Query Parameters
MOEX
— Московская биржаSPBX
— СПБ Биржа15
— 15 секунд60
— 60 секунд или 1 минута3600
— 3600 секунд или 1 часD
— сутки (соответствует значению 86400)W
— неделя (соответствует значению 604800)M
— месяц (соответствует значению 2592000)Y
— год (соответствует значению 31536000)Simple
— оригинальный формат данных. Поддерживает устаревшие параметры для обеспечения обратной совместимостиSlim
— облегчённый формат данных для быстрой передачи сообщений. Не поддерживает устаревшие параметрыHeavy
— полный формат данных, развивающийся и дополняющийся новыми полями. Не поддерживает устаревшие параметры
Тикер (Код финансового инструмента)
Possible values: [MOEX
, SPBX
]
Биржа:
Длительность таймфрейма. В качестве значения можно указать точное количество секунд или код таймфрейма:
Начало отрезка времени (UTC) в формате Unix Time Seconds
Конец отрезка времени (UTC) в формате Unix Time Seconds
Последние n записей, которые сервер должен вернуть в ответ на запрос.
Игнорируется, если в указанном временном диапазоне (from
→ to
) нет данных или их количество меньше запрошенного.
Флаг для поиска данных по устаревшим или экспирированным инструментам. При использовании требуется точное совпадение тикера
Possible values: [Simple
, Slim
, Heavy
]
Формат возвращаемого сервером JSON-объекта:
От формата объекта также зависит минимальное значение параметра frequency
для WebSocket-подписок.
Responses
- 200
- 400
- 404
Запрос успешно обработан
- application/json
- Schema
- Example (from schema)
- Пример Simple
- Пример Slim
- Пример Heavy
Schema
- response_History_Simple
- response_History_Slim
- response_History_Heavy
Array [
]
Array [
]
Array [
]
oneOf
Исторические сведения о нескольких периодах времени в формате Simple
history
object[]
Периоды и их исторические данные
Время (UTC) (Unix time seconds)
Цена при закрытии
Цена при открытии
Максимальная цена
Минимальная цена
Объём
Время (UTC) начала следующей свечи
Время (UTC) начала предыдущей свечи
Исторические сведения о нескольких периодах времени в формате Slim
history
object[]
Периоды и их исторические данные
Время (UTC) (Unix time seconds)
Цена при закрытии
Цена при открытии
Максимальная цена
Минимальная цена
Объём
Время (UTC) начала следующей свечи
Время (UTC) начала предыдущей свечи
Исторические сведения о нескольких периодах времени в формате Heavy
history
object[]
Периоды и их исторические данные
Время (UTC) (Unix time seconds)
Цена при закрытии
Цена при открытии
Максимальная цена
Минимальная цена
Объём
Время (UTC) начала следующей свечи
Время (UTC) начала предыдущей свечи
{}
Пример ответа в формате Simple
{
"history": [
{
"time": 1701068400,
"close": 287.79,
"open": 287.41,
"high": 287.9,
"low": 287,
"volume": 174466
}
],
"next": 1701069000,
"prev": 1701068100
}
Пример ответа в формате Slim
{
"h": [
{
"t": 1701068400,
"c": 287.79,
"o": 287.41,
"h": 287.9,
"l": 287,
"v": 174466
}
],
"next": 1701069000,
"prev": 1701068100
}
Пример ответа в формате Heavy
{
"history": [
{
"time": 1701068400,
"close": 287.79,
"open": 287.41,
"high": 287.9,
"low": 287,
"volume": 174466
}
],
"next": 1701069000,
"prev": 1701068100
}
Не удалось выполнить запрос. Проверьте синтаксис запроса и корректность заданных значений
Не удалось найти ресурс с указанными параметрами. Проверьте корректность заданных значений