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
