The official Python implementation of the ColinTalksCrypto Bitcoin Bull Run Index (CBBI).

The CBBI is a Bitcoin index that utilizes advanced, real-time analysis of 10 metrics to help us understand what stage of the Bitcoin bull run and bear market cycles we are in. The CBBI is time-independent and price-independent. It simply indicates whether it believes we are approaching the top/bottom of a Bitcoin cycle.

If you want to learn more, check out this video.

Bookmark it to receive latest CBBI updates.

• CBBI.info

$ docker run --rm --pull=always zaczero/cbbi --help

$ docker run --rm --pull=always zaczero/cbbi

Recommended Python version: 3.10

Pipenv: Python Dev Workflow for Humans

NOTE: The pipenv commands shall be executed within the project directory.

$ pipenv install

$ pipenv run python main.py --help

$ pipenv run python main.py

$ pipenv shell

$> python main.py --help

$> python main.py

The current CBBI version (March 2022) includes the following metrics:

This project supports .env files which provide a convenient way of setting environment variables.

Defines a requests-supported proxy string used during Google Trends metric calculation. If unset or empty, a direct connection will be made. It can be used to resolve the Google returned a response with code 429 issue.

• GOOGLE_PROXY=https://host:port
• GOOGLE_PROXY=https://user:pass@host:port

Defines an API key to be used during GlassNode fallback requests. If unset or empty, a cache fallback will be used instead (via CBBI.info).

• GLASSNODE_API_KEY=REPLACE_ME

Define both variables to receive Telegram notifications about metric errors that occur during the execution.

• TELEGRAM_TOKEN=REPLACE_ME
• TELEGRAM_CHAT_ID=123456

• Email: kamil@monicz.pl
• LinkedIn: linkedin.com/in/kamil-monicz