| --- |
| title: Market Analyzing Platform |
| emoji: 💻 |
| colorFrom: red |
| colorTo: blue |
| sdk: docker |
| pinned: false |
| license: apache-2.0 |
| short_description: Market Analyzing Platform - Notifications, Tracking, etc |
| --- |
| |
| ## POC Overview |
| This POC implements a market-wide risk radar using: |
| - Universe loader for tickers (unofficial lists supported) |
| - Price ingestion via `yfinance` |
| - Price Delta Calculator (drop by default) |
| - Adaptive thresholds, event detection, and alerting |
| - In-memory pub/sub topics |
| - Process pool for price loading |
|
|
| ## Topics |
| Defined in `configs/topics.yaml`: |
| - `market.universe.snapshot` |
| - `market.universe.updated` |
| - `market.prices.snapshot` |
| - `market.price.delta` |
| - `risk.event.detected` |
| - `risk.envelope.updated` |
| - `data.gap.detected` |
| - `system.alert.ready` |
|
|
| ## Run |
| ```bash |
| uv sync |
| uv run python -m src.core.main |
| ``` |
|
|
| ## App Entrypoint |
| ```bash |
| uv run python app.py |
| ``` |
|
|
| ## Notes |
| - `yfinance` is an unofficial data source and can break or rate-limit. |
| - Process pool parallelizes price fetching to speed up ingestion. |
| - Universe loader pulls: |
| - US equities from `rreichel3/US-Stock-Symbols` (unofficial) |
| - EU equities from Wikipedia index constituents (FTSE 100, DAX, CAC 40) |
| - Crypto from Binance `exchangeInfo` |
| - Commodities from a curated Yahoo Finance futures list |
| - Universe schema lives in `src/core/schemas.py` |
| - Topic taxonomy is loaded from `configs/topics.yaml` |
|
|
| ## Telegram Bot |
| Set environment variables: |
| ```bash |
| export TELEGRAM_BOT_TOKEN=... |
| export TELEGRAM_CHAT_ID=... |
| ``` |
|
|
| ## Detailed Architecture Doc |
| - `docs/CURRENT_VERSION.md` |
| ``` |
| |
