| """ |
| Data Access Layer for Crypto Data |
| Extends DatabaseManager with methods to access collected cryptocurrency data |
| """ |
|
|
| from datetime import datetime, timedelta |
| from typing import Optional, List, Dict, Any |
| from sqlalchemy import desc, func, and_ |
| from sqlalchemy.orm import Session |
|
|
| from database.models import ( |
| MarketPrice, |
| NewsArticle, |
| WhaleTransaction, |
| SentimentMetric, |
| GasPrice, |
| BlockchainStat |
| ) |
| from utils.logger import setup_logger |
|
|
| logger = setup_logger("data_access") |
|
|
|
|
| class DataAccessMixin: |
| """ |
| Mixin class to add data access methods to DatabaseManager |
| Provides methods to query collected cryptocurrency data |
| """ |
|
|
| |
| |
| |
| |
| def cache_market_data(self, data: dict, source: str = "fallback") -> bool: |
| """ |
| Cache market data to database |
| |
| Args: |
| data: Dictionary containing market data |
| source: Source of the data (e.g., 'coingecko', 'binance', 'fallback') |
| |
| Returns: |
| bool: True if successful, False otherwise |
| """ |
| try: |
| |
| if isinstance(data, list): |
| |
| for item in data: |
| self.save_market_price( |
| symbol=item.get('symbol', 'UNKNOWN'), |
| price_usd=float(item.get('price', 0)), |
| market_cap=item.get('market_cap'), |
| volume_24h=item.get('volume_24h'), |
| price_change_24h=item.get('change_24h'), |
| source=source |
| ) |
| elif isinstance(data, dict): |
| |
| symbol = data.get('symbol', data.get('coin', 'BTC')) |
| price = data.get('price', data.get('price_usd', 0)) |
| self.save_market_price( |
| symbol=symbol, |
| price_usd=float(price), |
| source=source |
| ) |
| |
| return True |
| |
| except Exception as e: |
| logger.error(f"❌ Error caching market data: {e}") |
| return False |
| |
| def get_cached_market_data(self, max_age_seconds: int = 300) -> Optional[Dict]: |
| """ |
| Retrieve cached market data if not expired |
| |
| Args: |
| max_age_seconds: Maximum age of cache in seconds (default 5 minutes) |
| |
| Returns: |
| Cached data or None if expired/not found |
| """ |
| try: |
| cutoff_time = datetime.now() - timedelta(seconds=max_age_seconds) |
| |
| with self.get_session() as session: |
| |
| prices = session.query(MarketPrice).filter( |
| MarketPrice.timestamp >= cutoff_time |
| ).order_by(MarketPrice.timestamp.desc()).limit(200).all() |
| |
| if prices: |
| return { |
| 'data': [ |
| { |
| 'symbol': p.symbol, |
| 'price': p.price_usd, |
| 'source': p.source, |
| 'timestamp': p.timestamp.isoformat() |
| } |
| for p in prices |
| ], |
| 'cached_at': prices[0].timestamp.isoformat(), |
| 'source': 'database_cache' |
| } |
| |
| return None |
| |
| except Exception as e: |
| logger.error(f"❌ Error retrieving cached data: {e}") |
| return None |
|
|
| |
| |
| |
|
|
| def save_market_price( |
| self, |
| symbol: str, |
| price_usd: float, |
| market_cap: Optional[float] = None, |
| volume_24h: Optional[float] = None, |
| price_change_24h: Optional[float] = None, |
| source: str = "unknown", |
| timestamp: Optional[datetime] = None |
| ) -> Optional[MarketPrice]: |
| """ |
| Save market price data |
| |
| Args: |
| symbol: Cryptocurrency symbol (e.g., BTC, ETH) |
| price_usd: Price in USD |
| market_cap: Market capitalization |
| volume_24h: 24-hour trading volume |
| price_change_24h: 24-hour price change percentage |
| source: Data source name |
| timestamp: Data timestamp (defaults to now) |
| |
| Returns: |
| MarketPrice object if successful, None otherwise |
| """ |
| try: |
| with self.get_session() as session: |
| price = MarketPrice( |
| symbol=symbol.upper(), |
| price_usd=price_usd, |
| market_cap=market_cap, |
| volume_24h=volume_24h, |
| price_change_24h=price_change_24h, |
| source=source, |
| timestamp=timestamp or datetime.utcnow() |
| ) |
| session.add(price) |
| session.flush() |
| logger.debug(f"Saved price for {symbol}: ${price_usd}") |
| return price |
| |
| except Exception as e: |
| logger.error(f"Error saving market price for {symbol}: {e}", exc_info=True) |
| return None |
|
|
| def get_latest_prices(self, limit: int = 100) -> List[MarketPrice]: |
| """Get latest prices for all cryptocurrencies""" |
| try: |
| with self.get_session() as session: |
| |
| subquery = ( |
| session.query( |
| MarketPrice.symbol, |
| func.max(MarketPrice.timestamp).label('max_timestamp') |
| ) |
| .group_by(MarketPrice.symbol) |
| .subquery() |
| ) |
| |
| prices = ( |
| session.query(MarketPrice) |
| .join( |
| subquery, |
| and_( |
| MarketPrice.symbol == subquery.c.symbol, |
| MarketPrice.timestamp == subquery.c.max_timestamp |
| ) |
| ) |
| .order_by(desc(MarketPrice.market_cap)) |
| .limit(limit) |
| .all() |
| ) |
| |
| return prices |
| |
| except Exception as e: |
| logger.error(f"Error getting latest prices: {e}", exc_info=True) |
| return [] |
|
|
| def get_latest_price_by_symbol(self, symbol: str) -> Optional[MarketPrice]: |
| """Get latest price for a specific cryptocurrency""" |
| try: |
| with self.get_session() as session: |
| price = ( |
| session.query(MarketPrice) |
| .filter(MarketPrice.symbol == symbol.upper()) |
| .order_by(desc(MarketPrice.timestamp)) |
| .first() |
| ) |
| return price |
| |
| except Exception as e: |
| logger.error(f"Error getting price for {symbol}: {e}", exc_info=True) |
| return None |
|
|
| def get_price_history(self, symbol: str, hours: int = 24) -> List[MarketPrice]: |
| """Get price history for a cryptocurrency""" |
| try: |
| with self.get_session() as session: |
| cutoff = datetime.utcnow() - timedelta(hours=hours) |
| |
| history = ( |
| session.query(MarketPrice) |
| .filter( |
| MarketPrice.symbol == symbol.upper(), |
| MarketPrice.timestamp >= cutoff |
| ) |
| .order_by(MarketPrice.timestamp) |
| .all() |
| ) |
| |
| return history |
| |
| except Exception as e: |
| logger.error(f"Error getting price history for {symbol}: {e}", exc_info=True) |
| return [] |
|
|
| |
| |
| |
|
|
| def save_news_article( |
| self, |
| title: str, |
| source: str, |
| published_at: datetime, |
| content: Optional[str] = None, |
| url: Optional[str] = None, |
| sentiment: Optional[str] = None, |
| tags: Optional[str] = None |
| ) -> Optional[NewsArticle]: |
| """Save news article""" |
| try: |
| with self.get_session() as session: |
| article = NewsArticle( |
| title=title, |
| content=content, |
| source=source, |
| url=url, |
| published_at=published_at, |
| sentiment=sentiment, |
| tags=tags |
| ) |
| session.add(article) |
| session.flush() |
| logger.debug(f"Saved news article: {title[:50]}...") |
| return article |
| |
| except Exception as e: |
| logger.error(f"Error saving news article: {e}", exc_info=True) |
| return None |
|
|
| def get_latest_news( |
| self, |
| limit: int = 50, |
| source: Optional[str] = None, |
| sentiment: Optional[str] = None |
| ) -> List[NewsArticle]: |
| """Get latest news articles""" |
| try: |
| with self.get_session() as session: |
| query = session.query(NewsArticle) |
| |
| if source: |
| query = query.filter(NewsArticle.source == source) |
| |
| if sentiment: |
| query = query.filter(NewsArticle.sentiment == sentiment) |
| |
| articles = ( |
| query |
| .order_by(desc(NewsArticle.published_at)) |
| .limit(limit) |
| .all() |
| ) |
| |
| return articles |
| |
| except Exception as e: |
| logger.error(f"Error getting latest news: {e}", exc_info=True) |
| return [] |
|
|
| def get_news_by_id(self, news_id: int) -> Optional[NewsArticle]: |
| """Get a specific news article by ID""" |
| try: |
| with self.get_session() as session: |
| article = session.query(NewsArticle).filter(NewsArticle.id == news_id).first() |
| return article |
| |
| except Exception as e: |
| logger.error(f"Error getting news {news_id}: {e}", exc_info=True) |
| return None |
|
|
| def search_news(self, query: str, limit: int = 50) -> List[NewsArticle]: |
| """Search news articles by keyword""" |
| try: |
| with self.get_session() as session: |
| articles = ( |
| session.query(NewsArticle) |
| .filter( |
| NewsArticle.title.contains(query) | |
| NewsArticle.content.contains(query) |
| ) |
| .order_by(desc(NewsArticle.published_at)) |
| .limit(limit) |
| .all() |
| ) |
| |
| return articles |
| |
| except Exception as e: |
| logger.error(f"Error searching news: {e}", exc_info=True) |
| return [] |
|
|
| |
| |
| |
|
|
| def save_sentiment_metric( |
| self, |
| metric_name: str, |
| value: float, |
| classification: str, |
| source: str, |
| timestamp: Optional[datetime] = None |
| ) -> Optional[SentimentMetric]: |
| """Save sentiment metric""" |
| try: |
| with self.get_session() as session: |
| metric = SentimentMetric( |
| metric_name=metric_name, |
| value=value, |
| classification=classification, |
| source=source, |
| timestamp=timestamp or datetime.utcnow() |
| ) |
| session.add(metric) |
| session.flush() |
| logger.debug(f"Saved sentiment: {metric_name} = {value} ({classification})") |
| return metric |
| |
| except Exception as e: |
| logger.error(f"Error saving sentiment metric: {e}", exc_info=True) |
| return None |
|
|
| def get_latest_sentiment(self) -> Optional[SentimentMetric]: |
| """Get latest sentiment metric""" |
| try: |
| with self.get_session() as session: |
| metric = ( |
| session.query(SentimentMetric) |
| .order_by(desc(SentimentMetric.timestamp)) |
| .first() |
| ) |
| return metric |
| |
| except Exception as e: |
| logger.error(f"Error getting latest sentiment: {e}", exc_info=True) |
| return None |
|
|
| def get_sentiment_history(self, hours: int = 168) -> List[SentimentMetric]: |
| """Get sentiment history""" |
| try: |
| with self.get_session() as session: |
| cutoff = datetime.utcnow() - timedelta(hours=hours) |
| |
| history = ( |
| session.query(SentimentMetric) |
| .filter(SentimentMetric.timestamp >= cutoff) |
| .order_by(SentimentMetric.timestamp) |
| .all() |
| ) |
| |
| return history |
| |
| except Exception as e: |
| logger.error(f"Error getting sentiment history: {e}", exc_info=True) |
| return [] |
|
|
| |
| |
| |
|
|
| def save_whale_transaction( |
| self, |
| blockchain: str, |
| transaction_hash: str, |
| from_address: str, |
| to_address: str, |
| amount: float, |
| amount_usd: float, |
| source: str, |
| timestamp: Optional[datetime] = None |
| ) -> Optional[WhaleTransaction]: |
| """Save whale transaction""" |
| try: |
| with self.get_session() as session: |
| |
| existing = ( |
| session.query(WhaleTransaction) |
| .filter(WhaleTransaction.transaction_hash == transaction_hash) |
| .first() |
| ) |
| |
| if existing: |
| logger.debug(f"Transaction {transaction_hash} already exists") |
| return existing |
| |
| transaction = WhaleTransaction( |
| blockchain=blockchain, |
| transaction_hash=transaction_hash, |
| from_address=from_address, |
| to_address=to_address, |
| amount=amount, |
| amount_usd=amount_usd, |
| source=source, |
| timestamp=timestamp or datetime.utcnow() |
| ) |
| session.add(transaction) |
| session.flush() |
| logger.debug(f"Saved whale transaction: {amount_usd} USD on {blockchain}") |
| return transaction |
| |
| except Exception as e: |
| logger.error(f"Error saving whale transaction: {e}", exc_info=True) |
| return None |
|
|
| def get_whale_transactions( |
| self, |
| limit: int = 50, |
| blockchain: Optional[str] = None, |
| min_amount_usd: Optional[float] = None |
| ) -> List[WhaleTransaction]: |
| """Get recent whale transactions""" |
| try: |
| with self.get_session() as session: |
| query = session.query(WhaleTransaction) |
| |
| if blockchain: |
| query = query.filter(WhaleTransaction.blockchain == blockchain) |
| |
| if min_amount_usd: |
| query = query.filter(WhaleTransaction.amount_usd >= min_amount_usd) |
| |
| transactions = ( |
| query |
| .order_by(desc(WhaleTransaction.timestamp)) |
| .limit(limit) |
| .all() |
| ) |
| |
| return transactions |
| |
| except Exception as e: |
| logger.error(f"Error getting whale transactions: {e}", exc_info=True) |
| return [] |
|
|
| def get_whale_stats(self, hours: int = 24) -> Dict[str, Any]: |
| """Get whale activity statistics""" |
| try: |
| with self.get_session() as session: |
| cutoff = datetime.utcnow() - timedelta(hours=hours) |
| |
| transactions = ( |
| session.query(WhaleTransaction) |
| .filter(WhaleTransaction.timestamp >= cutoff) |
| .all() |
| ) |
| |
| if not transactions: |
| return { |
| 'total_transactions': 0, |
| 'total_volume_usd': 0, |
| 'avg_transaction_usd': 0, |
| 'largest_transaction_usd': 0, |
| 'by_blockchain': {} |
| } |
| |
| total_volume = sum(tx.amount_usd for tx in transactions) |
| avg_transaction = total_volume / len(transactions) |
| largest = max(tx.amount_usd for tx in transactions) |
| |
| |
| by_blockchain = {} |
| for tx in transactions: |
| if tx.blockchain not in by_blockchain: |
| by_blockchain[tx.blockchain] = { |
| 'count': 0, |
| 'volume_usd': 0 |
| } |
| by_blockchain[tx.blockchain]['count'] += 1 |
| by_blockchain[tx.blockchain]['volume_usd'] += tx.amount_usd |
| |
| return { |
| 'total_transactions': len(transactions), |
| 'total_volume_usd': total_volume, |
| 'avg_transaction_usd': avg_transaction, |
| 'largest_transaction_usd': largest, |
| 'by_blockchain': by_blockchain |
| } |
| |
| except Exception as e: |
| logger.error(f"Error getting whale stats: {e}", exc_info=True) |
| return {} |
|
|
| |
| |
| |
|
|
| def save_gas_price( |
| self, |
| blockchain: str, |
| gas_price_gwei: float, |
| source: str, |
| fast_gas_price: Optional[float] = None, |
| standard_gas_price: Optional[float] = None, |
| slow_gas_price: Optional[float] = None, |
| timestamp: Optional[datetime] = None |
| ) -> Optional[GasPrice]: |
| """Save gas price data""" |
| try: |
| with self.get_session() as session: |
| gas_price = GasPrice( |
| blockchain=blockchain, |
| gas_price_gwei=gas_price_gwei, |
| fast_gas_price=fast_gas_price, |
| standard_gas_price=standard_gas_price, |
| slow_gas_price=slow_gas_price, |
| source=source, |
| timestamp=timestamp or datetime.utcnow() |
| ) |
| session.add(gas_price) |
| session.flush() |
| logger.debug(f"Saved gas price for {blockchain}: {gas_price_gwei} Gwei") |
| return gas_price |
| |
| except Exception as e: |
| logger.error(f"Error saving gas price: {e}", exc_info=True) |
| return None |
|
|
| def get_latest_gas_prices(self) -> Dict[str, Any]: |
| """Get latest gas prices for all blockchains""" |
| try: |
| with self.get_session() as session: |
| |
| subquery = ( |
| session.query( |
| GasPrice.blockchain, |
| func.max(GasPrice.timestamp).label('max_timestamp') |
| ) |
| .group_by(GasPrice.blockchain) |
| .subquery() |
| ) |
| |
| gas_prices = ( |
| session.query(GasPrice) |
| .join( |
| subquery, |
| and_( |
| GasPrice.blockchain == subquery.c.blockchain, |
| GasPrice.timestamp == subquery.c.max_timestamp |
| ) |
| ) |
| .all() |
| ) |
| |
| result = {} |
| for gp in gas_prices: |
| result[gp.blockchain] = { |
| 'gas_price_gwei': gp.gas_price_gwei, |
| 'fast': gp.fast_gas_price, |
| 'standard': gp.standard_gas_price, |
| 'slow': gp.slow_gas_price, |
| 'timestamp': gp.timestamp.isoformat() |
| } |
| |
| return result |
| |
| except Exception as e: |
| logger.error(f"Error getting gas prices: {e}", exc_info=True) |
| return {} |
|
|
| |
| |
| |
|
|
| def save_blockchain_stat( |
| self, |
| blockchain: str, |
| source: str, |
| latest_block: Optional[int] = None, |
| total_transactions: Optional[int] = None, |
| network_hashrate: Optional[float] = None, |
| difficulty: Optional[float] = None, |
| timestamp: Optional[datetime] = None |
| ) -> Optional[BlockchainStat]: |
| """Save blockchain statistics""" |
| try: |
| with self.get_session() as session: |
| stat = BlockchainStat( |
| blockchain=blockchain, |
| latest_block=latest_block, |
| total_transactions=total_transactions, |
| network_hashrate=network_hashrate, |
| difficulty=difficulty, |
| source=source, |
| timestamp=timestamp or datetime.utcnow() |
| ) |
| session.add(stat) |
| session.flush() |
| logger.debug(f"Saved blockchain stat for {blockchain}") |
| return stat |
| |
| except Exception as e: |
| logger.error(f"Error saving blockchain stat: {e}", exc_info=True) |
| return None |
|
|
| def get_blockchain_stats(self) -> Dict[str, Any]: |
| """Get latest blockchain statistics""" |
| try: |
| with self.get_session() as session: |
| |
| subquery = ( |
| session.query( |
| BlockchainStat.blockchain, |
| func.max(BlockchainStat.timestamp).label('max_timestamp') |
| ) |
| .group_by(BlockchainStat.blockchain) |
| .subquery() |
| ) |
| |
| stats = ( |
| session.query(BlockchainStat) |
| .join( |
| subquery, |
| and_( |
| BlockchainStat.blockchain == subquery.c.blockchain, |
| BlockchainStat.timestamp == subquery.c.max_timestamp |
| ) |
| ) |
| .all() |
| ) |
| |
| result = {} |
| for stat in stats: |
| result[stat.blockchain] = { |
| 'latest_block': stat.latest_block, |
| 'total_transactions': stat.total_transactions, |
| 'network_hashrate': stat.network_hashrate, |
| 'difficulty': stat.difficulty, |
| 'timestamp': stat.timestamp.isoformat() |
| } |
| |
| return result |
| |
| except Exception as e: |
| logger.error(f"Error getting blockchain stats: {e}", exc_info=True) |
| return {} |
|
|
|
|