Options-Fundament und Kapitalmodell im Core; Modul OptionsWheel
Das OptionsWheel setzt auf Dingen auf, die es im Core nicht gab. Diese Sitzung baut sie. #298 Optionen als Instrument. InstrumentKind/OptionSpec und ein druckbarer Instrumentenschluessel ("AAPL|20260918|C|150"); TradeSignal und OrderRequest tragen ein optionales OptionSpec, ohne das sich der Aktienpfad unveraendert verhaelt. Position.Notional rechnet ab jetzt mit der Kontraktgroesse - vorher war jede Option um Faktor 100 zu klein bewertet und damit jedes Risikolimit wirkungslos, lautlos und in die gefaehrliche Richtung. Daneben neu BoundCapital: ein Short Put bindet Strike x Kontraktgroesse, nicht die vereinnahmte Praemie. #300 sell-to-open. Jeder Auftrag zerfaellt in einen schliessenden und einen eroeffnenden Teil; der schliessende wird von keinem Limit verhindert - auch nicht vom Kaufstopp, denn ein Rueckkauf baut eine Verpflichtung ab. Deckungspruefung im Core, nicht im Modul: Short Call nur mit freien Aktien, Short Put nur mit reservierbarem Bargeld. #302-#305 Kapital- und Buchmodell. Buecher mit reservierten Namen und Eigentumsregeln, Pool mit Caps und Headroom, Margin-Sperre in vier Schichten, core_reservation mit Lebenszyklus, Frist, Idempotenz ueber (SignalId, ContractKey) und Quarantaene beim Start. #309/#310 Modul OptionsWheel: ow_-Schema mit fuenf Tabellen, Zustandsautomat, StrikeSelector, RollDecider, PremiumMath - vollstaendig ohne Broker testbar. Der Handelsbetrieb bleibt gesperrt, solange #299 und #294 fehlen; das Modul sagt das ueber GetActivationBlocker, statt still nichts zu tun. #293 --verify-order am Daemon: eine Order durch die vollstaendige Kette (Buch, Risiko, Bindung, Order, Fill, Buchung, Abschluss). Ohne --confirm ein Trockenlauf; Abbruch ausserhalb von Paper-Modus UND Paper-Port. Drei Widersprueche in den Konzepten sind dabei entschieden worden: Schicht B heisst ab jetzt "kein UNGEDECKTER Short" (der Grund der Regel war der Kredit, nicht der Short), die Hausreserve wird einmal abgezogen statt zweimal, und der Positionsschluessel ist eine Spalte statt eines Sechser-Verbunds (MySQL verlangt NOT NULL fuer Schluesselspalten). Begruendungen stehen in docs/ROADMAP.md. Enthaelt ausserdem die noch nicht committete Arbeit aus der vorigen Sitzung: die Fehlerbehebungen aus Epic X (WorkerBase-Intervall, BackupWorker, --check gegen die Datenbank, CapitolTrades-429, SIGTERM) samt DatabaseEndpoint, MysqlDumpTool und der Roadmap-Umstellung. Sie lag im Arbeitsbaum und liess sich nicht abtrennen, weil beide Staende dieselben Dateien beruehren. 213 -> 369 Tests, Build ohne Warnung. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
@@ -0,0 +1,172 @@
|
||||
using FluentAssertions;
|
||||
using IBKRTrader.Core.Trading;
|
||||
using IBKRTrader.Modules.OptionsWheel.Logic;
|
||||
|
||||
namespace IBKRTrader.Tests.Modules.OptionsWheel;
|
||||
|
||||
/// <summary>
|
||||
/// Roll-Entscheidung und Prämienrechnung – die beiden Stellen, an denen das Wheel Geld verliert,
|
||||
/// wenn sie falsch sind.
|
||||
/// </summary>
|
||||
[Trait("cat", "unit")]
|
||||
public class RollAndPremiumTests
|
||||
{
|
||||
private static readonly DateOnly Today = new(2026, 8, 1);
|
||||
|
||||
private static OptionSpec Put(decimal strike = 150m, DateOnly? expiry = null) =>
|
||||
new("AAPL", expiry ?? new DateOnly(2026, 9, 5), strike, OptionRight.Put);
|
||||
|
||||
private static WheelRules Rules => new();
|
||||
|
||||
// ─── Prämienrechnung ─────────────────────────────────────────────────────────
|
||||
|
||||
[Fact]
|
||||
public void PremiumPerContract_UsesTheContractSize()
|
||||
{
|
||||
PremiumMath.PremiumPerContract(2.50m, Put()).Should().Be(250m);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void CapitalAtRisk_IsCashForPuts_AndShareValueForCalls()
|
||||
{
|
||||
PremiumMath.CapitalAtRisk(Put(150m), underlyingPrice: 160m).Should().Be(15_000m);
|
||||
|
||||
var call = new OptionSpec("AAPL", new DateOnly(2026, 9, 5), 150m, OptionRight.Call);
|
||||
PremiumMath.CapitalAtRisk(call, underlyingPrice: 160m).Should().Be(16_000m);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void AnnualizedReturn_PutsShortAndLongContractsOnTheSameScale()
|
||||
{
|
||||
// 250 auf 15.000 in 30 Tagen sind gut 20 % p. a. Ohne den Zeitbezug wuerde die Auswahl
|
||||
// systematisch die lang laufenden Kontrakte bevorzugen - die mit dem langsamsten
|
||||
// Zeitwertverfall.
|
||||
var r = PremiumMath.AnnualizedReturnPercent(250m, 15_000m, 30);
|
||||
|
||||
r.Should().BeApproximately(20.28m, 0.01m);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void AnnualizedReturn_OfAContractExpiringToday_IsZero_NotADivisionByZero()
|
||||
{
|
||||
PremiumMath.AnnualizedReturnPercent(250m, 15_000m, 0).Should().Be(0m);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void BreakEven_IsStrikeMinusPremiumForAPut()
|
||||
{
|
||||
PremiumMath.BreakEven(Put(150m), premiumPerShare: 2.50m).Should().Be(147.50m);
|
||||
|
||||
var call = new OptionSpec("AAPL", new DateOnly(2026, 9, 5), 150m, OptionRight.Call);
|
||||
PremiumMath.BreakEven(call, 2.50m).Should().Be(152.50m);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void EffectiveCostBasis_FallsWithEveryPremiumCollected()
|
||||
{
|
||||
// Zugeteilt zu 150, insgesamt 600 Praemie auf 100 Stueck -> Einstand 144.
|
||||
PremiumMath.EffectiveCostBasis(150m, 600m, 100).Should().Be(144m);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void DaysToExpiry_IsNeverNegative()
|
||||
{
|
||||
PremiumMath.DaysToExpiry(new DateOnly(2026, 7, 1), Today).Should().Be(0);
|
||||
}
|
||||
|
||||
// ─── Rollen ──────────────────────────────────────────────────────────────────
|
||||
|
||||
private static RollDecider.OpenLeg Leg(
|
||||
DateOnly expiry, decimal delta, decimal underlying, decimal currentPrice = 1.00m,
|
||||
decimal premiumReceived = 250m) =>
|
||||
new(Put(150m, expiry), premiumReceived, currentPrice, delta, underlying);
|
||||
|
||||
[Fact]
|
||||
public void PlentyOfTimeLeft_MeansHold()
|
||||
{
|
||||
var leg = Leg(new DateOnly(2026, 9, 5), delta: 0.20m, underlying: 160m); // 35 Tage
|
||||
|
||||
RollDecider.Decide(leg, Rules, Today).Action.Should().Be(LegAction.Hold);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void ShortTimeLeftButFarOutOfTheMoney_MeansHold()
|
||||
{
|
||||
// Die Restlaufzeit allein ist kein Grund: ein weit aus dem Geld liegender Kontrakt darf
|
||||
// wertlos verfallen - das ist der Normalfall und der billigste Ausgang.
|
||||
var leg = Leg(new DateOnly(2026, 8, 15), delta: 0.10m, underlying: 180m); // 14 Tage
|
||||
|
||||
RollDecider.Decide(leg, Rules, Today).Action.Should().Be(LegAction.Hold);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void ShortTimeLeftAndInTheMoney_RollsWhenTheTargetPaysACredit()
|
||||
{
|
||||
var leg = Leg(new DateOnly(2026, 8, 15), delta: 0.60m, underlying: 140m, currentPrice: 11m);
|
||||
var target = Put(145m, new DateOnly(2026, 9, 18));
|
||||
|
||||
// Rueckkauf 1.100, neue Praemie 1.400 -> 300 Netto-Kredit.
|
||||
var d = RollDecider.Decide(leg, Rules, Today, target, rollTargetPremium: 1_400m);
|
||||
|
||||
d.Action.Should().Be(LegAction.Roll);
|
||||
d.Target.Should().Be(target);
|
||||
d.Reason.Should().Contain("Netto-Kredit");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void ADebitRoll_IsRefused_AndAssignmentIsAllowedInstead()
|
||||
{
|
||||
// Ein Debit-Roll kauft nur Zeit und kostet dabei Geld: er verschiebt das Problem und
|
||||
// verkleinert das Konto.
|
||||
var leg = Leg(new DateOnly(2026, 8, 15), delta: 0.60m, underlying: 140m, currentPrice: 11m);
|
||||
|
||||
var d = RollDecider.Decide(leg, Rules, Today, Put(145m), rollTargetPremium: 900m);
|
||||
|
||||
d.Action.Should().Be(LegAction.AllowAssignment);
|
||||
d.Reason.Should().Contain("Belastung");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void WithoutAnEligibleTarget_AssignmentIsAllowed()
|
||||
{
|
||||
var leg = Leg(new DateOnly(2026, 8, 15), delta: 0.60m, underlying: 140m, currentPrice: 11m);
|
||||
|
||||
RollDecider.Decide(leg, Rules, Today, rollTarget: null).Action
|
||||
.Should().Be(LegAction.AllowAssignment);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void ProfitTarget_IsOffByDefault()
|
||||
{
|
||||
// 250 vereinnahmt, Rueckkauf kostet nur noch 20 -> 92 % erreicht. Ohne eingeschaltetes
|
||||
// Ziel bleibt das folgenlos.
|
||||
var leg = Leg(new DateOnly(2026, 9, 5), delta: 0.10m, underlying: 170m, currentPrice: 0.20m);
|
||||
|
||||
RollDecider.Decide(leg, Rules, Today).Action.Should().Be(LegAction.Hold);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void ProfitTarget_ClosesTheLeg_WhenSwitchedOn()
|
||||
{
|
||||
var rules = Rules;
|
||||
rules.ProfitTargetPercent = 50m;
|
||||
var leg = Leg(new DateOnly(2026, 9, 5), delta: 0.10m, underlying: 170m, currentPrice: 0.20m);
|
||||
|
||||
var d = RollDecider.Decide(leg, rules, Today);
|
||||
|
||||
d.Action.Should().Be(LegAction.Close);
|
||||
d.Reason.Should().Contain("vereinnahmt");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void InTheMoney_IsSideAware()
|
||||
{
|
||||
var put = Put(150m);
|
||||
var call = new OptionSpec("AAPL", new DateOnly(2026, 9, 5), 150m, OptionRight.Call);
|
||||
|
||||
RollDecider.IsInTheMoney(put, 140m).Should().BeTrue();
|
||||
RollDecider.IsInTheMoney(put, 160m).Should().BeFalse();
|
||||
RollDecider.IsInTheMoney(call, 160m).Should().BeTrue();
|
||||
RollDecider.IsInTheMoney(call, 140m).Should().BeFalse();
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user