https://github.com/giocaizzi/btc-cycles

Chart of bitcoin price over the halving cycles
https://github.com/giocaizzi/btc-cycles

bitcoin python

Last synced: about 1 month ago
JSON representation

Chart of bitcoin price over the halving cycles

• Host: GitHub
• URL: https://github.com/giocaizzi/btc-cycles
• Owner: giocaizzi
• License: mit
• Created: 2024-03-05T23:47:13.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-04-15T05:05:43.000Z (7 months ago)
• Last Synced: 2024-04-16T02:02:43.489Z (7 months ago)
• Topics: bitcoin, python
• Language: Jupyter Notebook
• Homepage:
• Size: 41.3 MB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# btc-cycles

[![Update chart](https://github.com/giocaizzi/btc-cycles/actions/workflows/run.yml/badge.svg)](https://github.com/giocaizzi/btc-cycles/actions/workflows/run.yml)

![PyPI - Version](https://img.shields.io/pypi/v/btc-cycles?color=blue)

![PyPI - Python Version](https://img.shields.io/pypi/pyversions/btc-cycles)

[![Deploy](https://github.com/giocaizzi/btc-cycles/actions/workflows/deployment.yml/badge.svg)](https://github.com/giocaizzi/btc-cycles/actions/workflows/deployment.yml)

______________________________________________________________________

> ❗ This chart is updated everyday at 5 AM UTC.

![Bitcoin](https://github.com/giocaizzi/btc-cycles/blob/main/bitcoin.png)

______________________________________________________________________

## Deprecation warning

> ⚠️ Since v0.3, as _CoinmarketCap v1 API has been deprecated_, **all working sources require an API key** to fetch data. The legacy free *(but broken!)* source `coinmarketcap-free` is however still available, hoping for a workaround is found ([see here](https://github.com/guptarohit/cryptoCMD/issues/86)).

## Install

```bash

pip install btc-cycles

```

## Usage

- **Bitcoin price** data is fetched from a set of available sources, such as:

  - [`coinmarketcap`](https://www.coinmarketcap.com), requires **paid** `api_key`.

  - [`coincompare`](https://www.cryptocompare.com/), requires **free-tier** `api_key`.

  - [`coinmarketcap-free`](https://www.coinmarketcap.com): free *(but broken!)* legacy source, available hoping for a workaround,  ([see here](https://github.com/guptarohit/cryptoCMD/issues/86))

- **Cycles** are computed considering _past halving dates_ and the _expected future halving date_ fetched from [watchguru](https://watcher.guru/bitcoin-halving)

## Documentation

See this [notebook](https://github.com/giocaizzi/btc-cycles/blob/main/bitcoin.ipynb).