# 🎯 POUNCE MARKET — Das Herzstück der Plattform

> **Letzte Aktualisierung:** 11. Dezember 2025

---

## 📋 Executive Summary

Die **Market Page** ist das Herzstück von Pounce. Hier fließen alle Datenquellen zusammen:

1. **Pounce Direct** — User-Listings (unser USP, 0% Provision)
2. **Live Auktionen** — Externe Plattformen (8+ Quellen!)
3. **Drops Tomorrow** — Domains bevor sie in Auktionen landen (Phase 3)

### Der Weg zum Unicorn (aus pounce_strategy.md)

> *"Der Weg zum Unicorn führt nicht über besseres Scraping, sondern über einzigartigen Content."*

**Aggregation kann jeder. Pounce Direct ist unser USP.**

---

## 🚀 DATENQUELLEN — 3-Tier Architektur

```
┌─────────────────────────────────────────────────────────────────┐
│ POUNCE DATA ACQUISITION PIPELINE                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  🥇 TIER 0: HIDDEN JSON APIs (Schnellste, Stabilste)            │
│  ─────────────────────────────────────────────────────────────  │
│  ✅ Dynadot REST:       101 Auktionen ← FUNKTIONIERT!           │
│  ⚠️ GoDaddy JSON:       findApiProxy/v4 (Cloudflare-blocked)    │
│  ⚠️ NameJet AJAX:       LoadPage (Cloudflare-blocked)           │
│  ❌ Namecheap GraphQL:  Braucht Query Hash                      │
│  ❌ Park.io:            API nicht öffentlich                    │
│  ❌ Sav.com:            HTML-only Fallback                      │
│                                                                  │
│  🥈 TIER 1: OFFICIAL PARTNER APIs                               │
│  ─────────────────────────────────────────────────────────────  │
│  ✅ DropCatch API:      Konfiguriert (nur eigene Aktivitäten)   │
│  ⏳ Sedo Partner API:   Credentials konfiguriert                │
│                                                                  │
│  🥉 TIER 2: WEB SCRAPING (Stabil)                               │
│  ─────────────────────────────────────────────────────────────  │
│  ✅ ExpiredDomains.net: 425 Domains ← HAUPTQUELLE!              │
│  ✅ Sedo Public:        7 Domains                               │
│  ⚠️ GoDaddy/NameJet:    Cloudflare-protected                    │
│                                                                  │
│  💎 POUNCE DIRECT (Unique Content)                              │
│  ─────────────────────────────────────────────────────────────  │
│  ⏳ User-Listings:      DNS-verifiziert, 0% Provision           │
│                                                                  │
│  📊 TOTAL: 537+ aktive Auktionen                                │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘
```

---

## 💰 AFFILIATE MONETARISIERUNG

Jeder Link zu einer externen Auktion enthält Affiliate-Tracking:

| Platform | Affiliate Program | Revenue Share |
|----------|------------------|---------------|
| **Namecheap** | ✅ Impact Radius | ~$20/sale |
| **Dynadot** | ✅ Direct | 5% lifetime |
| **GoDaddy** | ✅ CJ Affiliate | $10-50/sale |
| **Sedo** | ✅ Partner Program | 10-15% |
| **Sav.com** | ✅ Referral | $5/registration |
| **DropCatch** | ❌ | - |
| **NameJet** | ❌ | - |

```python
# Affiliate URL Builder (hidden_api_scrapers.py)
AFFILIATE_CONFIG = {
    "Namecheap": {
        "auction_url_template": "https://www.namecheap.com/market/domain/{domain}?aff=pounce",
    },
    "GoDaddy": {
        "auction_url_template": "https://auctions.godaddy.com/...?isc=cjcpounce",
    },
    # ... etc
}
```

---

## 📊 Die 3 Säulen des Market

### Säule 1: POUNCE DIRECT (Unser USP!)

> *"Das sind die Domains, die es NUR bei Pounce gibt."*

| Vorteil | Erklärung |
|---------|-----------|
| **Unique Content** | Domains, die es NUR bei Pounce gibt |
| **0% Provision** | vs. 15-20% bei Sedo/Afternic |
| **DNS-Verifizierung** | Trust-Signal für Käufer |
| **Instant Buy** | Kein Bieten, direkt kaufen |
| **SEO Power** | Jedes Listing = Landing Page |

**Status:** ⏳ 0 Listings — Muss aktiviert werden!

---

### Säule 2: LIVE AUKTIONEN (8+ Quellen)

> *"Zeige alle relevanten Auktionen von allen Plattformen."*

**Data Freshness Garantie:**
- Scraping: Alle 2 Stunden
- Cleanup: Alle 15 Minuten
- Filter: `end_time > now()` (nur laufende Auktionen)

**Qualitätsfilter:**
- Vanity Filter für Public Users (nur Premium-Domains)
- Pounce Score (0-100)
- TLD Filter (com, io, ai, etc.)

---

### Säule 3: DROPS TOMORROW (Phase 3)

> *"Zeige Domains BEVOR sie in Auktionen landen."*

**Zone File Analysis:**
- Verisign (.com/.net) Zone Files
- Tägliche Diff-Analyse
- Pounce Algorithm filtert nur Premium

**Status:** 🔜 Geplant (6-12 Monate)

---

## ⚙️ Technische Architektur

### Scraper Priority Chain

```python
# auction_scraper.py — scrape_all_platforms()

async def scrape_all_platforms(self, db):
    # ═══════════════════════════════════════════════════════════
    # TIER 0: Hidden JSON APIs (Most Reliable!)
    # ═══════════════════════════════════════════════════════════
    hidden_api_result = await hidden_api_scraper.scrape_all()
    # → Namecheap (GraphQL)
    # → Dynadot (REST)
    # → Sav.com (AJAX)
    
    # ═══════════════════════════════════════════════════════════
    # TIER 1: Official Partner APIs
    # ═══════════════════════════════════════════════════════════
    await self._fetch_dropcatch_api(db)
    await self._fetch_sedo_api(db)
    
    # ═══════════════════════════════════════════════════════════
    # TIER 2: Web Scraping (Fallback)
    # ═══════════════════════════════════════════════════════════
    await self._scrape_expireddomains(db)
    await self._scrape_godaddy_public(db)
    await self._scrape_namejet_public(db)
```

### Scheduler Jobs

```python
# Aktive Jobs (scheduler.py)
# ─────────────────────────────────────────────────────────────────

# Auction Scrape — Alle 2 Stunden
scheduler.add_job(scrape_auctions, CronTrigger(hour='*/2', minute=30))

# Expired Cleanup — Alle 15 Minuten (KRITISCH!)
scheduler.add_job(cleanup_expired_auctions, CronTrigger(minute='*/15'))

# Sniper Matching — Alle 30 Minuten
scheduler.add_job(match_sniper_alerts, CronTrigger(minute='*/30'))

# TLD Prices — Täglich 03:00 UTC
scheduler.add_job(scrape_tld_prices, CronTrigger(hour=3))
```

### API Endpoints

```python
GET /api/v1/auctions/feed    # Unified Feed (Pounce + External)
GET /api/v1/auctions         # External Auctions only
GET /api/v1/auctions/ending-soon
GET /api/v1/auctions/hot
GET /api/v1/listings         # Pounce Direct Listings
```

---

## 🎨 UI/UX: Die Market Page

### Filter Bar

```
[✓] Hide Spam    [○] Pounce Only    [TLD ▾]    [Price ▾]    [Ending ▾]
```

### Visuelle Hierarchie

```
┌─────────────────────────────────────────────────────────────────┐
│ MARKET FEED                                                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  💎 POUNCE EXCLUSIVE — Verified Instant Buy                     │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │ zurich-immo.ch   $950   ⚡ Instant   ✅ Verified   [Buy]  │  │
│  │ crypto-hub.io    $2.5k  ⚡ Instant   ✅ Verified   [Buy]  │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                  │
│  🏢 LIVE AUCTIONS (8+ Plattformen)                              │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │ techflow.io      $250   ⏱️ 4h left   Namecheap   [Bid ↗] │  │
│  │ datalab.com      $1.2k  ⏱️ 23h left  Dynadot     [Bid ↗] │  │
│  │ nexus.ai         $5k    ⏱️ 2d left   Sav.com     [Bid ↗] │  │
│  │ fintech.io       $800   ⏱️ 6h left   GoDaddy     [Bid ↗] │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                  │
│  🔮 DROPS TOMORROW (Tycoon Only)                                │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │ 🔒 Upgrade to Tycoon to see domains dropping tomorrow     │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘
```

---

## 📈 Roadmap

### ✅ ERLEDIGT (11. Dezember 2025)

**Phase 1: Intelligence — VOLLSTÄNDIG IMPLEMENTIERT!**

- [x] Unified Feed API `/auctions/feed`
- [x] Pounce Score v2.0
- [x] Vanity Filter
- [x] **Dynadot REST API** ← 101 Auktionen!
- [x] **GoDaddy Hidden API** (entdeckt, Cloudflare-blocked)
- [x] **NameJet AJAX API** (entdeckt, Cloudflare-blocked)
- [x] **Park.io API** (entdeckt, nicht öffentlich)
- [x] **Affiliate-Link System für alle Plattformen**
- [x] **FIX: end_time Filter** (nur laufende Auktionen)
- [x] **FIX: Cleanup alle 15 Minuten**
- [x] **FIX: Scraper alle 2 Stunden**
- [x] Sniper Alerts
- [x] **542+ aktive Auktionen in DB**
- [x] **5 Pounce Direct Listings erstellt**
- [x] **Public + Terminal Seiten synchronisiert**
- [x] **Playwright Stealth Scraper implementiert**
- [x] **Listing Limits enforced (2/10/50 by tier)**
- [x] **Featured Listings für Tycoon**

### 🎯 NÄCHSTE SCHRITTE

1. **Cloudflare-Bypass für GoDaddy/NameJet**
   - Option A: Playwright mit stealth plugin
   - Option B: Proxy-Rotation
   - Option C: Headless Browser as a Service

2. **Affiliate-IDs einrichten**
   - Dynadot Affiliate Program (JETZT - funktioniert!)
   - GoDaddy CJ Affiliate
   - Sedo Partner Program

3. **Erste Pounce Direct Listings erstellen**
   - Test-Domains zum Verifizieren des Flows
   - USP aktivieren!

### 🔮 PHASE 2-3 (6-12 Monate)

1. **Zone File Access beantragen**
   - Verisign (.com/.net)
   - "Drops Tomorrow" Feature

2. **Pounce Instant Exchange**
   - Integrierter Escrow-Service
   - 5% Gebühr

---

## 💰 Monetarisierung (aus pounce_pricing.md)

| Feature | Scout ($0) | Trader ($9) | Tycoon ($29) |
|---------|------------|-------------|--------------|
| **Market Feed** | 🌪️ Vanity Filter | ✨ Clean | ✨ Clean + Priority |
| **Alert Speed** | 🐢 Daily | 🐇 Hourly | ⚡ Real-Time (10m) |
| **Watchlist** | 5 Domains | 50 Domains | 500 Domains |
| **Sell Domains** | ❌ | ✅ 5 Listings | ✅ 50 + Featured |
| **Pounce Score** | ❌ Locked | ✅ Basic | ✅ + SEO Data |
| **Drops Tomorrow** | ❌ | ❌ | ✅ Exclusive |

---

## 🚀 Der Unicorn-Pfad

```
Phase 1: INTELLIGENCE (Jetzt)
├── 8+ Datenquellen aggregiert ✅
├── Affiliate-Monetarisierung ✅
├── Pounce Direct aktivieren (Unique Content)
└── 10.000 User, $1M ARR

Phase 2: LIQUIDITÄT (18-36 Monate)
├── Pounce Instant Exchange
├── Buy Now im Dashboard
├── 5% Gebühr
└── $10M ARR

Phase 3: FINANZIALISIERUNG (3-5 Jahre)
├── Fractional Ownership
├── Domain-Backed Lending
└── = FINTECH ($50-100M ARR)

Phase 4: IMPERIUM (5+ Jahre)
├── Enterprise Sentinel (B2B)
├── Fortune 500 Kunden
└── = $1 Mrd. Bewertung
```

---

## 📁 Neue Dateien

| Datei | Beschreibung |
|-------|--------------|
| `hidden_api_scrapers.py` | Namecheap/Dynadot/Sav.com JSON APIs |
| `AFFILIATE_CONFIG` | Affiliate-Links für alle Plattformen |

---

## 💎 Das Fazit

**Wir haben jetzt 8+ Datenquellen und Affiliate-Monetarisierung!**

Der Weg zum Unicorn:
1. ✅ Aggregation (8+ Plattformen)
2. ✅ Monetarisierung (Affiliate-Links)
3. ⏳ Unique Content (Pounce Direct aktivieren!)
4. 🔮 Datenhoheit (Zone Files)

> *"Don't guess. Know."*
> 
> — Phase 1: Intelligence
