Skip to content

Latest commit

 

History

History
103 lines (85 loc) · 3.58 KB

README.md

File metadata and controls

103 lines (85 loc) · 3.58 KB
Raw

qsh-rs

Парсер для QScalp History формата 4 версии.

Поддерживаемые потоки: OrderLog, Deals, Quotes, AuxInfo.

Описание

qsh файл состоит из бинарных потоков исторических рыночных данных, сжатых DEFLATE алгоритмом.

Потоки различаются структурой/состоянием в зависимости от типа рыночных данных, представленных в потоке, а набор примитивов, используемый для кодирования данных, одинаков для всех типов потоков

pub trait QshRead: Read + Sized {
   ...
   fn uleb(&mut self) -> Result<u64, QshError>;
   fn leb(&mut self) -> Result<i64, QshError>;
   fn growing(&mut self) -> Result<i64, QshError>;
   fn string(&mut self) -> Result<String, QshError>;
}

этот интерфейс реализован для всех типов, удовлетворяющих std::io::BufRead.

Чтение qsh файла начинается с декомпрессии, функция qsh_rs::inflate создаёт буферизированный reader-декодер, использующий flate2 для декомпрессии

let reader = qsh_rs::inflate(file_path)?;

В начале файла расположен заголовок, описывающий имеющиеся потоки и дополнительную информацию

qsh_rs::header(&mut reader)?
Header {
    recording_time: 637200251900000000,
    version: 4,
    stream: ORDERLOG,
    instrument: "Plaza2:Si-3.20::1252209:1",
    recorder: "QshWriter.6870",
    comment: "Zerich QSH Service",
}

Далее идут инкрементальные данные потока — reader нужно преобразовать в итератор соответствующего типа

use qsh_rs::{AuxInfoReader, DealReader, OrderLogReader, QuotesReader}

reader.into_iter<OrderLogReader>(); // impl Iterator<Item = OrderLog>
reader.into_iter<QuotesReader>();	// impl Iterator<Item = Quotes>
reader.into_iter<DealReader>();		// impl Iterator<Item = Deal>
reader.into_iter<AuxInfoReader>();	// impl Iterator<Item = AuxInfo>

Rust api

[dependencies]
qsh-rs = { git = "https://github.com/2dav/qsh-rs" }
use qsh_rs::{inflate, header, QshRead};
use qsh_rs::{AuxInfoReader, DealReader, OrderLogReader, QuotesReader};

Примеры

examples/l3book.rs сборка стакана из L3(OrderLog) потока

cargo run --release --example l3book

examples/l2book.rs стакан из L2(Quotes) потока

cargo run --release --example l2book

Python api

сборка стакана из ордерлога и загрузка в numpy

import pyqsh

file = "../../data/zerich/Si-3.20.2020-03-17.OrdLog.qsh"
depth = 5

lob = pyqsh.lob(file, depth)

print(type(lob)) # <class 'numpy.ndarray'>
print(lob.shape) # (9758380, 21)

timestamp = lob[:,0]
mid_price = (lob[:,1] + lob[:,3]) * 0.5

L3toL2

Конвертер L3(orderlog) событий в l2(quotes) события

cd tools/l3tol2
cargo build --release
target/release/l3tol2 --help