Konzept Mehrere Handelsplattformen: Polymarket US, spaeter Kalshi (#622-#629)

Ein Kunde mit US-Wohnsitz soll ueber Polymarket US handeln - eine eigene,
CFTC-regulierte Boerse, an der die heutige CLOB-Anbindung nicht verwendbar ist.
Das Konzept macht Plattform zu einem Begriff im Core, laesst Module ihre
Plattformen erklaeren und haelt Strategievarianten je Plattform im Modul.

Begruendungen zu #622-#629 in docs/ROADMAP.md, Bauanleitung in
docs/archiv/konzepte/KONZEPT-Multi-Plattform.md.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
2026-09-18 10:54:00 +02:00
co-authored by Claude Opus 5
parent 94716157cf
commit 05979406c7
3 changed files with 445 additions and 0 deletions
+95
View File
@@ -408,6 +408,80 @@ Abgleich der unabhängig erhobenen Buchhaltung gegen die eigene Trading-DB. Nied
aber der eigentliche Prüfwert des Moduls: **Abweichungen zwischen beiden Quellen sind das
Signal.**
### Mehrere Handelsplattformen (#622–#627)
**Anlass (16.09.2026):** Ein Kunde mit Wohnsitz in den USA kann KYC machen. polymarket.com sperrt
US-IPs, er muss über **Polymarket US** handeln — eine eigene, CFTC-regulierte Börse mit eigener
API. Von der heutigen CLOB-Anbindung ist dort nichts verwendbar: andere Anmeldung (Ed25519 statt
EIP-712/HMAC), Märkte per Slug statt Token-ID, USD statt USDC, automatische Abwicklung statt
Redeem, andere Gebührenformel, eigener Liquiditätspool.
Richard hat entschieden: Wir bauen nicht nur einen zweiten Adapter, sondern machen **Plattform zu
einem Begriff im Core**, damit später Kalshi ein weiterer Adapter ist und kein weiterer Umbau.
Module erklären ausdrücklich, welche Plattformen sie bedienen; Strategien dürfen sich je Plattform
unterscheiden.
**Warum in B und nicht in C:** Es entsteht kein neues Strategiemodul, sondern ein weiterer Weg, die
gebauten Module an echtes Geld zu bringen. Die Abhängigkeit von A bleibt: Ohne Betriebsfreigabe
(#621) und Feldtest handelt auch der US-Kunde nicht live.
**Die zwei Auflagen, die das Konzept trägt:**
1. **Der Global-CLOB-Code wird umhüllt, nicht umgebaut.** `PolymarketClobClient` bleibt Zeile für
Zeile, wie er ist; der Global-Adapter übersetzt nur. Ein Fundament, das den bewährten Geldpfad
verändert, wäre teurer als der US-Kunde wert ist.
2. **Die Plattform-Erklärung eines Moduls wirkt im Handelspfad**, nicht nur in der Anzeige. Das
Order-Gateway lehnt ab, was das auslösende Modul nicht erklärt hat — dieselbe Lehre wie #569/#570.
→ [archiv/konzepte/KONZEPT-Multi-Plattform.md](./archiv/konzepte/KONZEPT-Multi-Plattform.md)
### [B] #622 — PL-0: Voraussetzungen für den US-Kunden klären
Keine Programmierarbeit, aber ohne sie ist #625 nur lesend baubar: API-Schlüssel des Kunden,
Serverstandort (US-Standort gegen US-IP-Sperre von polymarket.com), ob es für die Retail-API eine
Testumgebung gibt, und unsere Rolle beim automatisierten Handel auf einem fremden KYC-Konto.
### [B] #623 — PL-1: Plattform-Fundament im Core
`PlatformId`, `PlatformCapabilities`, neutrale Verträge mit `InstrumentRef` statt `TokenId`,
Registry, Global-Adapter als Hülle, Spalte `platform` mit Vorgabe `polymarket-global`.
**Akzeptanz: Verhalten unverändert, Diff an `PolymarketClobClient.cs` leer.** `TokenId` steht in
73 Dateien — deshalb bleibt es als Eigenschaft erhalten und zieht schrittweise um.
### [B] #624 — PL-2: Module erklären ihre Plattformen
**Auslöser: sobald #623 abgeschlossen ist.**
`IPolyTraderModule.SupportedPlatforms` mit Vorgabe „nur Global" — ein Modul, das nichts erklärt,
verhält sich wie heute. Kennzeichen in Modul-Tab und Kontenansicht (Desktop und WebUI aus einer
Core-Regel, wie seit #560), Warnung bei Konten ohne Modul, Sperre im Order-Gateway.
Warum Erklärung **und** Fähigkeiten: Dass eine Plattform alles Nötige *hat*, heißt nicht, dass die
Strategie dort *geprüft* ist.
### [B] #625 — PL-3: Adapter Polymarket US
**Auslöser: sobald #623 abgeschlossen ist; echte Orders zusätzlich erst nach #622.**
Erst lesend, dann Demo gegen das echte US-Buch, dann Orders. Die Retail-API hat keine dokumentierte
Sandbox — Demo gegen Produktion ist damit der einzige Weg zur Messphase.
### [B] #626 — PL-4: ResolutionFarming für Polymarket US
**Auslöser: sobald #624 und #625 abgeschlossen sind.**
Erste Strategie für den US-Kunden, weil sie keine fremden Wallet-Daten braucht. Die US-Gebühr
`Θ·p·(1−p)` ist nahe 0,95 sehr klein, Maker bekommen einen Rabatt, und der Redeem (#146) entfällt.
Global-Schwellen sind wegen des getrennten Pools **nicht** übertragbar — Startwerte kommen aus der
Messphase.
### [B] #627 — PL-5: Accounting für Polymarket-US-Konten
**Auslöser: sobald #625 abgeschlossen ist.**
Keine Chain, keine Data-API: Aktivität, Saldo und Balance-Ledger kommen aus der US-API, in USD.
Macht nebenbei #147 (US-Steuerschicht) greifbar — der US-Kunde ist genau dieser Fall.
---
## C — Neue Strategiemodule
@@ -543,6 +617,27 @@ keine API existiert. Berührt auch #151 — die Fingerprint-Baseline wäre von d
Prüfplan: [pruefplaene/PREDICTALYTICS-PRUEFPLAN-Master-Auswahl.md](./pruefplaene/PREDICTALYTICS-PRUEFPLAN-Master-Auswahl.md)
### [D] #628 — PL-6: CopyTrading plattformübergreifend
**Auslöser: sobald #625 abgeschlossen ist und Richard entschieden hat, ob sich das lohnt.**
Auf Polymarket US sind fremde Wallets nicht sichtbar; CopyTrading hat dort keine eigenen Master.
Denkbar wäre: Master weiter auf Polygon beobachten, auf dem passenden US-Markt ausführen.
**Warum nicht beschlossen:** Nicht jeder Markt existiert in den USA, der Pool ist getrennt, Kurse
und Gebühren weichen ab — der Einstieg liegt systematisch anders als beim Master, und genau dieser
Abstand entscheidet heute über die Rentabilität (#163).
→ [archiv/konzepte/KONZEPT-Multi-Plattform.md](./archiv/konzepte/KONZEPT-Multi-Plattform.md)
### [D] #629 — PL-7: Adapter Kalshi
**Auslöser: sobald #623 abgeschlossen ist und ein Kunde Kalshi konkret braucht.**
Vorbereitet, nicht beschlossen. Zugleich der Prüfstein für #623: Kommt der Adapter ohne Änderung an
einem Modul aus, trägt die Abstraktion.
→ [archiv/konzepte/KONZEPT-Multi-Plattform.md](./archiv/konzepte/KONZEPT-Multi-Plattform.md) §7
---
## T — Technische Schuld