IBKR Integratie

Interactive Brokers (IBKR) is het uitvoeringsplatform voor Whitefield. Deze pagina beschrijft het integratieontwerp voor geautomatiseerde handel, reconciliatie en FX-hedging.

Zie Het Plan voor de samenvatting.

---

Waarom IBKR

Factor	IBKR	Alternatieven
Commissies	Laagste tier (per-share pricing)	2-5x duurder
API-toegang	Client Portal API + Flex API	Beperkt of afwezig
Fractional shares	4-decimaal precisie	Vaak alleen gehele aandelen
FX hedging	Spot forex + CME futures	Beperkt
Professionele rekeningen	BV-structuur ondersteund	Niet altijd
Multi-currency	Meerdere valuta-saldi	Beperkt

---

Flex API-client (reconciliatie)

De Flex API is IBKR’s rapportage-interface voor het ophalen van gestructureerde handels- en positiedata in XML/CSV-formaat.

Functionaliteit

Rapporttype	Frequentie	Doel
Trades	Dagelijks	Vergelijking met engine-trades
Posities	Dagelijks	Vergelijking met engine-holdings
Account-waarde	Dagelijks	NAV-reconciliatie
Cash-bewegingen	Wekelijks	Stortingen/opnames tracking

3-tier reconciliatie

Tier	Drempel	Actie
OK	< 0,1% verschil	Automatisch goedgekeurd
Waarschuwing	0,1% - 1,0%	Review vereist, NAV publiceerbaar
Fout	> 1,0%	Blokkeert NAV-publicatie, handmatige interventie

IBKR is de “belt” (primaire NAV-bron), de engine de “suspenders” (sanity check). De gepubliceerde NAV is altijd de IBKR-waarde.

---

IB Gateway (Orderuitvoering)

IB Gateway is IBKR’s headless applicatie voor API-gebaseerde orderuitvoering via de Client Portal API.

Ontwerp

Helios Engine (signalen)
    │
    ▼ Signalen JSON
    │
IB Gateway Container (Docker)
    │
    ▼ Client Portal API
    │
IBKR Servers (orderuitvoering)

Ordertypen

Systeem	Ordertype	Timing
System 1	Market-on-Open (MOO)	Woensdag open (na dinsdag-close signaal)
System 2	Market-on-Open (MOO)	Volgende dag open
System 2	Bracket (TP/SL)	Bij entry, actief tot exit
System 2	Market-on-Close (MOC)	Penultimate-day time exit

Veiligheidsmaatregelen

• Geen live-to-engine terugkoppeling — orders worden vanuit signalen geplaatst, niet vanuit live-portefeuilledata
• Dry-run modus — alle orders gaan eerst door simulatie voordat live-uitvoering wordt ingeschakeld
• Rate limiting — maximaal X orders per minuut om throttling te voorkomen
• Audit trail — alle orderverzoeken en -resultaten worden gelogd

IBKR Sub-accounts (Toekomst)

Multi-profiel via sub-accounts

Bij introductie van meerdere risicoprofielen (Defensief, Agressief) worden IBKR Financial Advisor (FA) sub-accounts gebruikt:

Aspect	Huidige situatie	Toekomst
Accounts	1 hoofdrekening	FA master + N sub-accounts
Trades	1 set signalen	N sets signalen (per profiel)
Reconciliatie	1 vergelijking	N vergelijkingen
NAV	1 NAV	N NAV’s

Open vragen (Phase 34 research):

1. Ondersteunt IBKR FA sub-accounts aparte portefeuilles met onafhankelijke rapportage?
2. Wat is de manuele overhead van 3x engine runs per week?
3. Hoe werkt Flex API-rapportage per sub-account?

FX Hedging via IBKR

Spot FX-uitvoering

Bij lancering (< EUR 500K AUM) wordt IBKR Spot FX gebruikt voor valuta-afdekking:

1. Signaal: Tweewekelijks, gealigneerd met System 1 rebalance
2. Uitvoering: Verkoop USD / koop EUR in spot FX-markt
3. Resultaat: Negatief USD-cashsaldo, positief EUR-saldo
4. Kosten: Commissie 0,20 bps + spread ~0,2 pips + overnight financiering

Bij schaling naar EUR 500K+ wordt overgestapt op CME Futures (6E) voor ~150 bps lagere carry cost.

Zie Valuta-afdekking voor de volledige analyse.