From f3ac90bb83788335cbc30b9e038875d4c735724d Mon Sep 17 00:00:00 2001
From: "yves.gugger" <yves.gugger@gentwo.com>
Date: Mon, 8 Dec 2025 13:40:01 +0100
Subject: [PATCH] docs: Add Smart Pounce Auctions & transparent valuation to
 README

---
 README.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a8dd71b..c38165d 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,8 @@ A professional full-stack application for monitoring domain name availability wi
 ### Core Functionality
 - **Domain Availability Monitoring** — Track any domain and get notified when it becomes available
 - **Domain Portfolio Management** — Track domains you own with purchase price, value, and ROI
-- **Domain Valuation Engine** — Algorithmic domain value estimation based on length, TLD, keywords, brandability
+- **Domain Valuation Engine** — 100% transparent algorithmic valuation with detailed breakdown
+- **Smart Pounce Auctions** — Aggregated auctions from GoDaddy, Sedo, NameJet & more
 - **TLD Price Intelligence** — Compare prices across 886+ TLDs from Porkbun API
 - **Automated Price Scraping** — Daily cronjob scrapes real TLD prices from public APIs
 - **Price Change Alerts** — Email notifications when TLD prices change >5%
@@ -17,6 +18,22 @@ A professional full-stack application for monitoring domain name availability wi
 - **Historical Data** — Track price trends and availability history over time (12 months)
 - **Email Notifications** — Domain available alerts, price changes, weekly digests
 
+### Smart Pounce Auction Aggregator
+- **Multi-Platform Search** — GoDaddy, Sedo, NameJet, SnapNames, DropCatch
+- **Ending Soon** — Auctions ending in < 1 hour for sniping opportunities
+- **Hot Auctions** — Most-bid domains across all platforms
+- **Smart Opportunities** — AI-powered detection of undervalued domains
+- **Affiliate Integration** — Click through to bid (no payment handling = Swiss GwG compliant)
+- **Filters** — Search by keyword, TLD, platform, price range
+
+### Domain Valuation (Transparent)
+- **Clear Formula** — `Value = Base × Length × TLD × Keyword × Brand`
+- **Factor Breakdown** — Each multiplier explained (e.g., "4-letter domain ×5.0")
+- **Confidence Levels** — High/Medium/Low based on score consistency
+- **Real TLD Costs** — Registration cost context from database
+- **Value-to-Cost Ratio** — Investment decision metric
+- **Disclaimer** — Clear limitations of algorithmic valuation
+
 ### User Experience
 - **Modern UI** — Clean, minimalist dark-mode design with smooth animations
 - **Responsive** — Fully optimized for desktop, tablet, and mobile
@@ -282,6 +299,15 @@ This ensures identical prices on:
 | GET | `/api/v1/subscription` | Get current subscription |
 | POST | `/api/v1/subscription/upgrade` | Upgrade plan |
 
+### Smart Pounce (Auctions)
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/v1/auctions` | Search auctions across platforms |
+| GET | `/api/v1/auctions/ending-soon` | Auctions ending within X hours |
+| GET | `/api/v1/auctions/hot` | Most-bid auctions |
+| GET | `/api/v1/auctions/opportunities` | AI-powered opportunities (auth) |
+| GET | `/api/v1/auctions/stats` | Platform statistics |
+
 ### Admin
 | Method | Endpoint | Description |
 |--------|----------|-------------|