← Back to News
bybit-predict 4.1.1

bybit-predict 4.1.1

bybit-predict · PyPI Skip to main content Switch to mobile version Warning Some features may not work without

JavaScript. Please try enabling it if you encounter problems. Search PyPI Search Help Docs Sponsors Log in Register Menu

Help Docs Sponsors Log in Register Search PyPI Search bybit-predict 4.1.1 Rule-based cryptocurrency market signal

analysis using Bybit V5 market data. pip install bybit-predict==4.1.1 Copy PIP instructions Description Download files

Release history Bybit-Predict Rule-based cryptocurrency market analysis, signal generation, and Discord integration

powered by public Bybit V5 market data. Current release: v4.1.0. This release adds reproducible historical backtesting

to v4's modern package architecture without discarding the repository, issues, merged contributions, or Git history. The

latest legacy release was v3.1. 繁體中文 What Bybit-Predict is — and is not Bybit-Predict analyzes OHLCV candles

from Bybit and produces informational market signals and reference levels. The current legacy-rule-based-v4 strategy

uses candle shapes, volume power, percentiles, IQR, and Fibonacci-inspired levels. It does not use a machine-learning

model and it is not a trading bot. It never places orders, asks for Bybit API credentials, or promises a market outcome.

Risk notice: Cryptocurrency markets are volatile. Results are informational only, are not financial advice, and must not

be treated as a recommendation or guarantee to trade. Highlights One Bybit V5 K-line request retrieves up to 1,000

candles; the default analysis uses 180 instead of sending 180 individual requests. Typed, UTC-normalized Candle and

immutable PredictionResult models. Stateless legacy strategy: concurrent analyses cannot mix their data. CLI for local

use and an optional non-blocking Discord slash command. Active symbols validated using Bybit instrument metadata, not a

hard-coded coin list. Tests, Ruff, Pyright, GitHub Actions CI, and Dependabot. Deterministic historical backtesting with

saved CSV inputs, explicit assumptions, performance metrics, and two simple baselines. Requirements Python 3.11 or later

Internet access to Bybit public market endpoints No Bybit account, API key, or API secret is needed for public market

analysis. The optional Discord interface needs only a Discord bot token. Install From PyPI Install the CLI and its

standard Bybit V5 dependency with: python -m pip install bybit-predict Install the optional Discord interface when you

need it: python -m pip install "bybit-predict[discord]" For an isolated command-line installation, use pipx: pipx

install bybit-predict From source git clone https://github.com/KageRyo/Bybit-Predict.git cd Bybit-Predict python -m venv

.venv source .venv/bin/activate # Windows: .venv\\Scripts\\activate python -m pip install --upgrade pip python -m pip

install . For contributors, install development and optional Discord dependencies: python -m pip install -e ".[dev]" CLI

Analyze the default 180 four-hour candles: bybit-predict analyze BTCUSDT Choose another supported Bybit interval and

candle count: bybit-predict analyze ETHUSDT --interval 60 --limit 240 Example output: Symbol: BTCUSDT Strategy:

legacy-rule-based-v4 (rule-based, not ML) Timeframe: 240 Candles: 180 Trend: Bullish Signal strength: 68.00% Reference

levels: 0% ... 23.6% ... The CLI returns a non-zero status for invalid symbols, invalid parameters, or market-data

failures. You can also run python -m bybit_predict analyze BTCUSDT. Backtest a historical range v4.1.0 adds a

reproducible backtest command. It signals from a trailing closed-candle window, executes non-neutral signals at the next

candle open, and exits at that candle close. The command prints its assumptions with metrics and baselines; it does not

make a trading claim. bybit-predict backtest BTCUSDT \ --interval 240 \ --start 2024-01-01 \ --end 2025-01-01 \

--strategy legacy \ --window 180 \ --save-data data/btcusdt-2024-4h.csv Re-run against the saved, normalized CSV without

downloading data again: bybit-predict backtest BTCUSDT \ --interval 240 \ --start 2024-01-01 \ --end 2025-01-01 \

--strategy legacy \ --window 180 \ --data data/btcusdt-2024-4h.csv --start is inclusive, --end is exclusive, and

date-only values mean midnight UTC. See backtesting and evaluation for metric definitions, baseline semantics,

reproducibility requirements, and important limitations. Discord slash commands Install the Discord optional dependency,

create a Discord application/bot, and invite it with the bot and applications.commands scopes. python -m pip install

".[discord]" cp .env.example .env Set environment variables securely (for example by sourcing .env locally or using your

deployment secret manager): export DISCORD_BOT_TOKEN="your-token" # Optional: immediately sync commands to one

development guild. export DISCORD_GUILD_ID="your-development-guild-id" Then start the interface: bybit-predict discord

Use the slash command in Discord: /predict symbol:BTCUSDT interval:240 candles:180 The command defers external market

work to a thread, so a slow Bybit request does not block Discord's event loop. Responses include the strategy, trend,

signal strength, candle period, and neutral reference levels rather than trading instructions. Never commit .env, bot

tokens, API keys, or downloaded data. They are ignored by default. Configuration Variable Required Purpose

DISCORD_BOT_TOKEN Discord only Discord bot authentication token. DISCORD_GUILD_ID No Development guild for immediate

command syncing. BYBIT_TESTNET No true opts into Bybit testnet public data; default is false. The market-data client

intentionally exposes no Bybit credential settings: public K-line and instrument endpoints do not require

authentication. Architecture Bybit V5 public API │ BybitV5MarketClient ──→ normalized UTC Candles │ ├──

PredictionService ──→ LegacyRuleBasedStrategy ──→ PredictionResult │ │ │ │

├──────── CLI └── future strategies │ └──────── Discord slash command │

└── BacktestEngine ─────→ LegacyRuleBasedStrategy ──→ BacktestResult │

├──────── historical CLI └──────── saved CSV input/output market/ owns Bybit V5

requests, retry boundaries, pagination, and response normalization. strategies/ contains pure, deterministic signal

calculations and has no dependency on Bybit or Discord. services/ composes market data with a strategy. interfaces/

converts user input/output only. Strategy and evaluation LegacyRuleBasedStrategy is deliberately retained as the

project’s historical core. It classifies candle bodies and wicks, compares significant bullish and bearish volume, and

derives optional reference prices from IQR and percentile calculations. It is explicitly named so later strategies can

be compared fairly. v4 intentionally fixes v3's zero/six-candle volume window, timezone handling, and bearish Fibonacci

label ordering; the exact compatibility baseline and retained semantics are documented in legacy strategy migration

notes. The v4.1.0 backtesting work (#25) defines a fixed trailing analysis window, next-open entry, same-candle-close

exit, and neutral-as-cash behavior before calculating directional accuracy, win rate, average return, maximum drawdown,

and a zero-risk-rate Sharpe ratio. It compares the result with buy-and-hold and a 10/20 SMA directional baseline. See

backtesting and evaluation for the exact rules and limitations. Until published results are independently interpreted in

context, this project makes no claim that its signals predict future prices. Development and quality checks ruff check .

ruff format --check . pyright pytest Pull requests run these checks on Python 3.11, 3.12, and 3.13. See CONTRIBUTING.md

for local setup and the required feature/<issue>-<description> branch convention. Publishing Pushing a final

release tag builds an sdist and universal wheel, validates them, publishes through PyPI Trusted Publishing, then creates

a GitHub Release with the same artifacts. See PyPI publishing for the maintainer-only setup and release procedure. No

long-lived PyPI API token is stored in this repository or its GitHub Actions secrets. Roadmap v4.0.0: package

architecture, public Bybit V5 client, stateless legacy strategy, CLI, Discord slash command, configuration, quality

gates, and documentation. v4.1.0: reproducible backtesting and evaluation (#25). v4.1.1: PyPI distribution, Trusted

Publishing, and package-release automation (#37). Later: additional strategies may implement the same strategy contract;

ML is a future option, not an implied feature. Contributing and history The repository name, issues, forks, stars,

merged pull requests, and Git history are intentionally preserved. Thanks to prior contributors, including RRAaru. New

contributors are welcome—start with good first issues or read CONTRIBUTING.md. License and copyright Bybit-Predict is

licensed under the GNU General Public License v2.0 or later. Copyright © 2022–2026 CodeRyo Studio, Chien-Hsun Chang,

and contributors. CodeRyo Studio is the project maintainer. See NOTICE for the complete attribution notice. Project

links Data verified by PyPI on Aug 9, 2026 Data provided by the project maintainers, verified at the time the release

was uploaded to PyPI. Changelog Documentation Homepage Issues Repository Key dates PyPI data Data sourced directly from

PyPI's database. Released: Aug 9, 2026 Newer release available (4.1.2) 1 maintainer PyPI data Data sourced directly from

PyPI's database. KageRyo Credits Author: CodeRyo Studio, Chien-Hsun Chang GitHub Statistics Data verified by PyPI

on  Aug 9, 2026 The GitHub source repository was provided by the project maintainers and verified by PyPI at the

time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently

verified. Repository Stars: Forks: Open issues: Open PRs: License expression GPL-2.0-or-later View SPDX License List

Requires Python >=3.11 Provides Extra dev discord Tags bybit cryptocurrency discord market-analysis signals

Classifiers Development Status 4 - Beta Intended Audience Developers License OSI Approved :: GNU General Public License

v2 (GPLv2) Programming Language Python :: 3 Python :: 3.11 Python :: 3.12 Python :: 3.13 Report project as malware

Download files Download the file for your platform. If you're not sure which to choose, learn more about installing

packages. Source Distribution bybit_predict-4.1.1.tar.gz (47.6 kB view details) Uploaded Aug 9, 2026 Source Built

Distribution Filter files by name, interpreter, ABI, and platform. If you're not sure about the file name format, learn

more about wheel file names. The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript

to be able to filter the list of wheel files. Copy a direct link to the current filters Copy File name Interpreter

Interpreter py3 ABI ABI none Platform Platform any bybit_predict-4.1.1-py3-none-any.whl (39.8 kB view details) Uploaded

Aug 9, 2026 Python 3 File details Details for the file bybit_predict-4.1.1.tar.gz. File metadata Download URL:

bybit_predict-4.1.1.tar.gz Upload date: Aug 9, 2026 Size: 47.6 kB Tags: Source Uploaded using Trusted Publishing? Yes

Uploaded via: twine/7.0.0 CPython/3.13.14 File hashes Hashes for bybit_predict-4.1.1.tar.gz Algorithm Hash digest SHA256

5324a0738ce23529b38f0af4bee7208a6a12402dceeb0d4f1abb54c714555367 Copy MD5 6b93e70ba119bba1f2d09e63f180c8d9 Copy

BLAKE2b-256 41a499ef6980017ff8a042c631a5d7482150fae45ec224b7abcdf0416d11948c Copy See more details on using hashes here.

Provenance The following attestation bundles were made for bybit_predict-4.1.1.tar.gz: Publisher: release.yml on

KageRyo/Bybit-Predict Attestations: Values shown here reflect the state when the release was signed and may no longer be

current. Statement: Statement type: https://in-toto.io/Statement/v1 Predicate type:

https://docs.pypi.org/attestations/publish/v1 Subject name: bybit_predict-4.1.1.tar.gz Subject digest:

5324a0738ce23529b38f0af4bee7208a6a12402dceeb0d4f1abb54c714555367 Sigstore transparency entry: 2390201804 Sigstore

integration time: Aug 9, 2026 Source repository: Permalink:

KageRyo/Bybit-Predict@d26caa1ab7c14f0f489b6d6b4b79e4881b27c692 Branch / Tag: refs/tags/v4.1.1 Owner:

https://github.com/KageRyo Access: public Publication detail: Token Issuer: https://token.actions.githubusercontent.com

Runner Environment: github-hosted Publication workflow: release.yml@d26caa1ab7c14f0f489b6d6b4b79e4881b27c692 Trigger

Event: push File details Details for the file bybit_predict-4.1.1-py3-none-any.whl. File metadata Download URL:

bybit_predict-4.1.1-py3-none-any.whl Upload date: Aug 9, 2026 Size: 39.8 kB Tags: Python 3 Uploaded using Trusted

Publishing? Yes Uploaded via: twine/7.0.0 CPython/3.13.14 File hashes Hashes for bybit_predict-4.1.1-py3-none-any.whl

Algorithm Hash digest SHA256 4e5d9947c44178c3783ef2e6b932232bfbe40192b3117c522d375692170b6e7f Copy MD5

d320d60c3ef17602b128675f68576e1c Copy BLAKE2b-256 f59358b5a2ff91e0045a4d22f1940e641874de9bc854fb770a98f724dba5b911 Copy

See more details on using hashes here. Provenance The following attestation bundles were made for

bybit_predict-4.1.1-py3-none-any.whl: Publisher: release.yml on KageRyo/Bybit-Predict Attestations: Values shown here

reflect the state when the release was signed and may no longer be current. Statement: Statement type:

https://in-toto.io/Statement/v1 Predicate type: https://docs.pypi.org/attestations/publish/v1 Subject name:

bybit_predict-4.1.1-py3-none-any.whl Subject digest: 4e5d9947c44178c3783ef2e6b932232bfbe40192b3117c522d375692170b6e7f

Sigstore transparency entry: 2390202012 Sigstore integration time: Aug 9, 2026 Source repository: Permalink:

KageRyo/Bybit-Predict@d26caa1ab7c14f0f489b6d6b4b79e4881b27c692 Branch / Tag: refs/tags/v4.1.1 Owner:

https://github.com/KageRyo Access: public Publication detail: Token Issuer: https://token.actions.githubusercontent.com

Runner Environment: github-hosted Publication workflow: release.yml@d26caa1ab7c14f0f489b6d6b4b79e4881b27c692 Trigger

Event: push Release history Release notifications | RSS feed 4.1.2 Aug 9, 2026 This release 4.1.1 Aug 9, 2026 Help

Installing packages Uploading packages User guide Project name retention FAQs About PyPI PyPI Blog Infrastructure

dashboard Statistics Logos & trademarks Our sponsors Contributing to PyPI Bugs and feedback Contribute on GitHub

Translate PyPI Sponsor PyPI Development credits Using PyPI Terms of Service Report security issue Code of conduct

Privacy Notice Acceptable Use Policy Status: all systems operational Developed and maintained by the Python community,

for the Python community. Donate today! "PyPI", "Python Package Index", and the blocks logos are registered trademarks

of the Python Software Foundation. © 2026 Python Software Foundation Site map Deployed from bd8ccde Switch to desktop

version English español français 日本語 português (Brasil) українська Ελληνικά Deutsch 中文

(简体) 中文 (繁體) русский עברית Esperanto 한국어 Supported by AWS Cloud computing and Security

Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry

Error logging StatusPage Status page

Source: pypi.org