← Cookbook

✅ runnable

Recipe 13 — Configure performance-fee opt-in

Status: ✅ runnable SDK surface: client.billing.opt_in_perf_fee(strategy_instance_id=...) Server endpoint: POST /v1/billing/perf-fee/opt-in TZ reference: TZ-3 §26.4 (perf-fee FSM); 10% fee on profit above HWM

Opt a strategy into the 10% performance fee on profit above the per-strategy high-water mark. The fee accrues per snapshot tick (1h cron) and crystallizes according to the dispute-window policy (Phase 4-G locked at 1 day).

result = await client.billing.opt_in_perf_fee(
    strategy_instance_id="s_01HZ...",
    consent_signature="0x...",  # EIP-712 signature over the consent body
)
const result = await client.billing.optInPerfFee({
  strategy_instance_id: 's_01HZ...',
  consent_signature: '0x...',
});

Verify accruals with client.billing.list_perf_fees(...). To revoke, see the M4-S2 DSR-erasure flow (recipe deferred).

Source: cookbook/recipes/13-perf-fee-optin/README.md