Libra

Small CLI that pulls the latest CoinMarketCap listings, prints any coins added in the last 24 hours, and orders the top listings by watchlist count.

Requirements

• Python 3.10+
• uv (recommended) or any Python virtual environment tool

Setup

1. Copy the example config and add your CoinMarketCap key:

   cp env-example.toml env.toml
   # edit env.toml and set [api].cmc_key

2. Install dependencies with uv:

   uv sync

   If you prefer pip, install from pyproject.toml instead.

Getting a CoinMarketCap API key

• Sign up at https://pro.coinmarketcap.com and open the Developer Dashboard.
• Create a free key (use the “Basic” tier) and copy the value shown in the “API Key” panel.
• Place it in env.toml as cmc_key.

Usage

Run via uv:

uv run monitor.py
# or
uv run libra-monitor

The script logs new listings since yesterday and prints watchlist counts sorted from highest to lowest. CoinMarketCap pages occasionally change; if watchlist scraping fails, rerun later or reduce the max_items parameter in monitor.py.

Notes

• Network calls hit both the CoinMarketCap API and public currency pages; expect brief throttling pauses during watchlist scraping.
• Dependencies are kept minimal to match the small scope of the project.