wos-rfq

The client of the Wolverine tick-quote add-on. The add-on stores private::RealFutureQuote at granularity 0, one row per tick, under the DATED contract code. This package is pure Python and works from any host with Python 3.9 or newer — and inside the Wolverine ring images, on the image's own binding.

pip install wos-rfq          # also installs wos-py (the native pycaitlyn binding) >= 0.0.8
wos-rfq --help

Endpoints

The add-on has no login. The client talks to two endpoints:

• The storage master, raw TCP — the binary protocol, the default and fast route for reads. Pass --master HOST:PORT, or set WOS_RFQ_MASTER.
• The add-on's web. Pass --web http://HOST:PORT, or set WOS_RFQ_WEB. It carries the upload API and a JSON read API (/rfq/api/structs, /ticks, /bars, /main) for inspection and debugging. Reads use it only when asked: --via web (--via master is the default; --via auto = web when it answers). JSON is much slower than the binary route; no binding is needed for it.

Commands

The same features are available from Python as wos_rfq.master, wos_rfq.reads, wos_rfq.ticks, wos_rfq.convert and wos_rfq.web (ReadWeb is the JSON read client).

Bindings

The storage-master route needs a pycaitlyn binding; it is imported at the first connect, not at import wos_rfq:

• the wos-py wheel (>= 0.0.8) — the declared dependency, for every pip user;
• a ring image's own binding — the SWIG build the ring's workers import. wos_rfq detects it by its surface and does the raw ring frames, the delete body and the error body in pure Python.

wos_rfq.binding() says which one is in use. Without either, import wos_rfq and the JSON read route still work; a storage-master call stops with one line naming what is missing (exit 1 from the command).

Inside a ring image install with --no-deps:

pip install --no-deps wos-rfq

The image already has its binding; installing the wos-py dependency there would put a second pycaitlyn in the venv and, for any process that does not put the image's directory first, shadow the one the ring's workers depend on. The ring images built by the regular pipeline ship this package that way.