eugene-intelligence / README.md
Matthew-Anyiam
v1.1 - clean health ratios
7e206bb
|
Raw History Blame Contribute Delete
2.37 kB
---
title: Eugene Intelligence
emoji: 🏛️
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.44.1
python_version: "3.11"
app_file: app.py
pinned: false
---
# Eugene Intelligence
**Financial context for AI.**
The data layer for agents that need to get finance right.
---
## Data Products
### Fundamentals
- SEC XBRL financials (balance sheet, income, cash flow)
- Financial ratios (ROE, ROA, margins, leverage)
- 5-year trends with source tracing
- Altman Z-Score and credit metrics
### Market Data
- Stock prices (20+ years historical, OHLCV)
- Real-time quotes
- 52-week range, moving averages, beta
- Total return calculations
### Earnings
- EPS actuals vs estimates
- Beat/miss history and rates
- Revenue trends
- Next earnings dates
- Post-earnings price moves
- Earnings call transcripts (8-K extraction)
### Ownership
- Insider transactions (SEC Form 4)
- Buy/sell signals with transaction details
- 13F institutional holdings
- Whale tracking (Berkshire, BlackRock, Vanguard, etc.)
### Corporate Actions
- Dividend history and yields
- Stock splits
- M&A activity (8-K parsing)
### Filings
- 10-K, 10-Q, 8-K access
- Bulk downloads
- Real-time filing alerts
- Full-text search
---
## AI Agents
### Equity Research Agent
- Comprehensive financial data aggregation
- Peer comparison
- Risk scoring
- Source-traced metrics
### Credit Agent
- Debt maturity analysis
- Interest coverage trends
- Covenant monitoring
- Refinancing risk assessment
- Distress signal detection
### Earnings Agent
- Earnings calendar
- Post-earnings move analysis
- Guidance extraction
### Health Monitor
- Financial ratio analysis
- Trend detection
- Cross-company comparison
---
## Delivery
| Method | Description |
|--------|-------------|
| **MCP Server** | 15+ tools for Claude Desktop |
| **Python API** | Direct function calls |
| **Gradio App** | Interactive web interface |
---
## Data Quality
- **Source-traced**: Every number links to SEC filing
- **Validated**: Magnitude checks, sign checks, outlier detection
- **Confidence scores**: Data quality ratings on each metric
---
## What We Provide
Verified, structured financial data — not investment advice.
---
## Links
- **GitHub**: [github.com/Matthew-Anyiam/eugene-data-labs](https://github.com/Matthew-Anyiam/eugene-data-labs)
- **Contact**: matthew@eugeneintelligence.com
# v1.1