https://github.com/gcarq/cdpnotify
MakerDAO CDP Collateralization Notification Bot for Telegram
https://github.com/gcarq/cdpnotify
makerdao python telegram-bot
Last synced: 9 months ago
JSON representation
MakerDAO CDP Collateralization Notification Bot for Telegram
- Host: GitHub
- URL: https://github.com/gcarq/cdpnotify
- Owner: gcarq
- License: gpl-3.0
- Created: 2018-05-29T21:42:23.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-06-01T11:10:04.000Z (about 8 years ago)
- Last Synced: 2025-04-11T01:40:29.799Z (about 1 year ago)
- Topics: makerdao, python, telegram-bot
- Language: Python
- Size: 24.4 KB
- Stars: 7
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-makerdao - cdpnotify - CDP Collateralization Notification Bot for Telegram. [Python] (CDP Tools / Self-hosted)
README
# cdpnotify
MakerDAO CDP Collateralization Notification Bot for Telegram.
### Commands
```
/watch []: Add a CDP with the given ID to your watchlist.
The bot will send you a private notification if the collateralization is below the given ratio (default=200%)
/unwatch : Remove CDP from your watchlist
/status: Show your current watchlist
/help: Show this message
```
### Using the already deployed instance
A instance of this bot is already deployed under [@cdpnotifybot](https://t.me/CDPNotifyBot).
NOTE: This instance is hosted by me and it will save your Telegram Id associated with the CDP Ids you are watching (this data will be deleted once you issue `/unwatch`).
Also I cannot guarantee a 24/7 uptime, so dont rely solely on this bot!
### Installation
The following steps are made for Linux/MacOS environment
**1. Clone repo**
```bash
git clone https://github.com/gcarq/cdpnotify.git
cd cdpnotify
```
**2. Create config file**
```bash
cp config.json.example config.json
vi config.json
```
**3. Install dependencies**
```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
```
### Docker
```bash
touch cdps.sqlite
docker build -t cdpnotify .
docker run --rm \
-v /etc/localtime:/etc/localtime:ro \
-v `pwd`/config.json:/cdpnotify/config.json \
-v `pwd`/cdps.sqlite:/cdpnotify/cdps.sqlite \
-it cdpnotify
```
### Software requirements
- [Python 3.6.x](http://docs.python-guide.org/en/latest/starting/installation/)
- [pip](https://pip.pypa.io/en/stable/installing/)
- [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- [virtualenv](https://virtualenv.pypa.io/en/stable/installation/) (Recommended)
- [Docker](https://www.docker.com/products/docker) (Recommended)
##### Please consider making a small donation if you find this bot useful:
`ETH: 0x7f07523856BEf9c0a6153A703dE613D6F19e82e4`