Skip to main content

Wickra Screener — parallel multi-symbol screening over 495 streaming indicators

CI codecov PyPI License: MIT OR Apache-2.0

Wickra Screener — Python


▶ Live demo: all 514 indicators over real Binance market data, computed live in your browser — live.wickra.org · zero backend, powered by wickra-wasm.

Scan thousands of symbols in parallel against data-driven conditions over 495 O(1) streaming indicators — for Python. pip install wickra-screener — prebuilt wheels for Linux, macOS and Windows, nothing to compile.

Python bindings for wickra-screener, the data-driven multi-symbol scan core. Build a Screener from a spec JSON, drive it with command JSONs, and read back scan reports — the same command protocol every language binding speaks.

Install

pip install wickra-screener

Pre-built wheels ship for Linux, macOS and Windows — there is nothing to compile and no C library to track down.

Building from this repository (contributors)

maturin develop --release
pytest -q

Quick start

import json
from wickra_screener import Screener

spec = json.dumps({
    "universe": ["AAA", "BBB"],
    "condition": {
        "type": "cmp",
        "left": {"kind": "price", "field": "close"},
        "op": "gt",
        "right": {"kind": "const", "value": 10.0},
    },
})

screener = Screener(spec)

def candle(close):
    return {"time": 1, "open": close, "high": close,
            "low": close, "close": close, "volume": 1.0}

response = screener.command(json.dumps({
    "cmd": "scan",
    "data": {"AAA": [candle(5.0)], "BBB": [candle(15.0)]},
}))

report = json.loads(response)
print([m["symbol"] for m in report["matches"]])  # ['BBB']

API

Method Description
Screener(spec_json) Build a screener from a spec JSON (raises ValueError if invalid).
screener.command(cmd_json) -> str Apply a command JSON, return the response JSON. Commands: set_spec, feed, feed_batch, evaluate, scan, reset, version.
Screener.version() -> str The library version.

Benchmark

Every binding forwards to the same data-driven Rust core, so what this one adds is the call overhead of PyO3, not a different result. The core's throughput is measured by the repository's benchmark suite and the nightly bench.yml run; the numbers, the machine and how to reproduce them are in the repository BENCHMARKS.md.

Documentation

The full guide, the spec reference and the API documentation live in the main repository and the documentation site:

Wickra Screener ships native bindings for Python, Node.js, WASM and Rust, plus a C ABI hub that any C-capable language (C, C++, C#, Go, Java, R) links against — all forwarding to the same data-driven, unsafe-forbidden Rust core.

Security

Found a security issue? Please don't open a public issue. Report it privately via the repository's Security tab ("Report a vulnerability") or email support@wickra.org with a subject line starting [wickra security]. Full policy: https://github.com/wickra-lib/wickra-screener/blob/main/SECURITY.md.

Disclaimer

Wickra Screener is analysis software: it computes indicator values and evaluates conditions over historical and live market data. It is provided "as is", without warranty of any kind, and is not financial advice — it places no orders. Trading carries risk of loss; review the code and use at your own discretion.

License

Licensed under either of Apache-2.0 or MIT at your option.

Metadata

Release files for wickra-screener 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wickra-screener 0.3.1
File Size Uploaded Provenance Actions
wickra_screener-0.3.1.tar.gz 101.0 kB Without provenance Details for wickra_screener-0.3.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for wickra-screener 0.3.1
File Actions
wickra_screener-0.3.1-cp39-abi3-win_arm64.whl CPython 3.9 abi3 Windows ARM64 Details for wickra_screener-0.3.1-cp39-abi3-win_arm64.whl
wickra_screener-0.3.1-cp39-abi3-win_amd64.whl CPython 3.9 abi3 Windows x86-64 Details for wickra_screener-0.3.1-cp39-abi3-win_amd64.whl
wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_x86_64.whl CPython 3.9 abi3 Linux musl 1.2+ x86-64 Details for wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_x86_64.whl
wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_aarch64.whl CPython 3.9 abi3 Linux musl 1.2+ ARM64 Details for wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_aarch64.whl
wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.9 abi3 Linux glibc 2.17+ x86-64 Details for wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.9 abi3 Linux glibc 2.17+ ARM64 Details for wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
wickra_screener-0.3.1-cp39-abi3-macosx_11_0_arm64.whl CPython 3.9 abi3 macOS 11.0+ ARM64 Details for wickra_screener-0.3.1-cp39-abi3-macosx_11_0_arm64.whl
wickra_screener-0.3.1-cp39-abi3-macosx_10_12_x86_64.whl CPython 3.9 abi3 macOS 10.12+ x86-64 Details for wickra_screener-0.3.1-cp39-abi3-macosx_10_12_x86_64.whl

Total release size: 6.5 MB

Release files / wickra_screener-0.3.1.tar.gz

Download URL wickra_screener-0.3.1.tar.gz
Size 101.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4beed8d5b7756ee3e7b27c41c90d171a5d630970df3bdaf214946fe24da7a0fc
BLAKE2b-256 checksum
How to use checksums
b6f2c5e7ab9d5d4959d668ee88e37a577c08ee239545ea4faba9c31c061b7597
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-win_arm64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-win_arm64.whl
Size 631.8 kB
Tags CPython 3.9 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
87a119b95cd8c2422ae18cd729add04b8cfcd33aff297833c8baf024408b2e85
BLAKE2b-256 checksum
How to use checksums
8bd278644616014222fc4a375f15f6e25e400e41a979ccf3810c1c75a808e0b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-win_amd64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-win_amd64.whl
Size 715.7 kB
Tags CPython 3.9 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
23ce259a2a3d1053f9beede9d3a61d2e0dcef4ceeddfba8691a470554570e2a5
BLAKE2b-256 checksum
How to use checksums
07c2a837018e999f9f18474811684c0aef51b024926f57f2c5f3bec8010a3c5e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_x86_64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_x86_64.whl
Size 1.1 MB
Tags CPython 3.9 Linux musl 1.2+ x86-64 abi3
SHA-256 checksum
How to use checksums
3213095a009b65fc22ea936d8d611fa9bc5f6467d1f6effab3a74b6d8ff636a8
BLAKE2b-256 checksum
How to use checksums
96b1ab14764d41f76143c9bb706f64b885da29d983190c911b02aad4b2c9a714
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_aarch64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-musllinux_1_2_aarch64.whl
Size 939.3 kB
Tags CPython 3.9 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum
How to use checksums
87ecf062e24d9e2ae7accf6a4e6785e4782ac17979cd5ae1b2e904cda79224ad
BLAKE2b-256 checksum
How to use checksums
51b006d2ed0db4f9c8451803fe79ef2ebdc2cbe516107349b17421b8e89ce67c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 847.0 kB
Tags CPython 3.9 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
41713726e64b3eed0b9fce00bf4a43e1d4a29f751e498596800249a0d0f3b43f
BLAKE2b-256 checksum
How to use checksums
62990617b850305bb6352c0738680a2ce5a40ed611f55cf8750819863d1d603b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 760.6 kB
Tags CPython 3.9 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
a41b386aefbaffaf5188f2f02f0942edb311caa56b224f5c456ca8bc10b7b769
BLAKE2b-256 checksum
How to use checksums
5b5bc953c827d256141dbd6fc5520fd4e6d36a03f3e122b10c381ffc49858310
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-macosx_11_0_arm64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-macosx_11_0_arm64.whl
Size 688.5 kB
Tags CPython 3.9 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
8727d14446e88bed4976f645e2df46306031774f25e1b428ef544bc70e306d75
BLAKE2b-256 checksum
How to use checksums
07d9b91acf28d10e7f604278bef74a0920aed8c62d52a3fa5b5fa4c2deb9b684
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Release files / wickra_screener-0.3.1-cp39-abi3-macosx_10_12_x86_64.whl

Download URL wickra_screener-0.3.1-cp39-abi3-macosx_10_12_x86_64.whl
Size 797.1 kB
Tags CPython 3.9 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
bb8c510dc8d88ccf42d636c4871d67789b4dcfdde95152b95b2cce71031b7c0e
BLAKE2b-256 checksum
How to use checksums
9369abcf231b934a18a405f39e1015032b2e856f1064c1e517d31bd108266923
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.15.0

Security for wickra-screener 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page