🦅 Greedy Eye

Personal investment intelligence platform. Aggregate data from multiple sources, track your portfolio, and make informed financial decisions.

---

What It Does

Think of it as a personal Bloomberg Terminal on a budget — aggregate financial data from exchanges, brokers, and price feeds into one place. Track all your investments (crypto, stocks, bonds) and get insights to make better decisions.

Built as a learning project to demonstrate production-ready Go architecture for financial applications.

---

Core Capabilities

Data Aggregation

• Pull data from exchanges (Binance), price feeds (CoinGecko), and brokerages
• Unified view of crypto, stocks, bonds, and derivatives
• Historical price tracking and performance analytics

Portfolio Intelligence

• Multi-account position tracking across platforms
• P&L calculations and cost basis tracking
• Asset allocation analysis

Extensible Architecture

• Modular gRPC services for different data sources
• Easy to add new adapters for exchanges or price feeds
• REST API via gRPC-Gateway for external integrations

---

Technology Stack

Backend:

• Go 1.23+ with gRPC and Protocol Buffers
• PostgreSQL with Ent ORM
• gRPC-Gateway for HTTP API

Infrastructure:

• Docker & Docker Compose
• Atlas migrations
• Structured logging (Zap, Sentry)

Integrations:

• CoinGecko, Binance APIs
• Telegram Bot (optional interface)
• OpenAPI 3.0 spec

---

Quick Start

Prerequisites

• Go 1.23+
• Docker and Docker Compose

Run Locally

# Clone and start
git clone https://github.com/foxcool/greedy-eye.git
cd greedy-eye
docker-compose up -d postgres
make dev

# Servers:
# HTTP API: http://localhost:8080
# gRPC:     localhost:50051

Health Check

curl http://localhost:8080/health

Run Tests

make test                    # All tests
make test-integration        # Integration tests only

---

Project Structure

greedy-eye/
├── api/                    # Protocol Buffer definitions
├── cmd/eye/               # Main application
├── internal/
│   ├── services/          # Business logic (asset, portfolio, price)
│   ├── adapters/          # External API clients (Binance, CoinGecko)
│   └── api/               # Generated gRPC/HTTP code
├── docs/                  # Architecture documentation
└── deploy/                # Docker configs

---

Documentation

• Architecture Guide — System design, C4 diagrams, service structure
• Development Guide — Setup, workflow, roadmap
• OpenAPI Spec — HTTP API reference

---

Development Status

Phase 1-3: ✅ Complete — Foundation, services, API gateway Phase 4: 🔄 In Progress — Core business logic implementation Phase 5: 📋 Planned — Production hardening

Current implementation:

• ✅ gRPC service architecture with 7+ services
• ✅ Database layer with Ent ORM
• ✅ External API adapters (CoinGecko, Binance)
• ✅ Integration test coverage
• 🔄 Portfolio analytics and insights

---

Key Features

Multi-Source Data

• Aggregate price data from exchanges and feeds
• Support for crypto, stocks, bonds, derivatives
• Extensible adapter pattern for new sources

Portfolio Tracking

• Multi-account position aggregation
• Performance analytics and P&L
• Historical tracking

Architecture

• Modular monolith (microservice-ready)
• Clean separation: services, adapters, domain
• Comprehensive testing

---

Development

make dev          # Start with live reload
make test         # Run tests
make buf-gen      # Generate protobuf code
make lint         # Run linter

See Development Guide for details.

---

License

MIT License

---

Docs: Architecture • Development • API