KapitaalBot

Publieke docs zijn functioneel volledig en canoniek, maar bevatten geen broncode, geen private accountdetails en geen reproduceerbare tuning.

01 — Systeemarchitectuur

← 00 — Module-inventaris | 01 — Architectuur | 02 — Data-ingest →

Dit document beschrijft de architectuur van de Krakenbot trading engine: componenten, datastromen, database-topologie en procesmodellen.

Systeemoverzicht

De Krakenbot is opgebouwd uit modulaire lagen met strikte verantwoordelijkheden:

  • Ingest Laag: Verwerkt publieke en private WebSocket feeds, valideert checksums (L2) en persisteert ruwe marktdata.
  • State & Projection: Onderhoudt de in-memory en Redis-backed toestand van de markt (MSP), orderboeken en balansen.
  • Strategy Pipeline: Analyseert regimes, berekent edge/confidence en genereert execution mandates.
  • Execution Engine: Beheert de order lifecycle, positie-monitoring, trailing stops en risk guards.
  • Observability: Verzamelt metrics, logt funnel-events en faciliteert forward-return analyse.

Runtime Topologie

Krakenbot gebruikt een dual-pool architectuur om ingest-load te scheiden van execution-latency.

Datastromen (Live Pad)

Het systeem is state-first en route-centric. De hot-path scant geen ruwe tabellen per tick, maar gebruikt een ververste run_symbol_state.

Strategy Pipeline Flow

De pipeline transformeert marktdata naar uitvoerbare plannen via een hiërarchie van filters en scorers.

Execution Lifecycle

Orders doorlopen een strikte state-machine om consistentie tussen de database en de exchange te garanderen.

Database Topologie (SSOT)

Het systeem onderscheidt drie logische rollen voor data-opslag:

PoolOmgevingsvariabelePrimaire Inhoud (SSOT)
INGESTINGEST_DATABASE_URLRuwe marktdata, L2/L3 metrics, run_symbol_state (refreshed).
DECISIONDECISION_DATABASE_URLOrders, Fills, Posities, Safety State, Watchdog logs.
RESEARCHRESEARCH_DATABASE_URLForward-return observations, Microstructure snapshots.

Harde Regel: Geen cross-pool joins in de applicatie. Gebruik db_target_precheck.sh voor diagnose.

Procesmodel & Services

Krakenbot draait als een set van systemd services op de productie-server (/srv/krakenbot):

  1. krakenbot-ingest.service:

    • Taak: Continue dataverzameling.
    • Mode: run-ingest.
    • Schrijft naar: INGEST pool.

  2. krakenbot-execution.service:

    • Taak: Strategie-evaluatie en trading.
    • Mode: run-execution-live.
    • Schrijft naar: DECISION pool.

  3. Maintenance:

    • retention: Periodieke opschoning van oude samples.
    • watchdog: Bewaakt consistentie en herstelt stale states.

← 00 — Module-inventaris | 01 — Architectuur | 02 — Data-ingest →

Document gegenereerd voor technische documentatie. Laatst bijgewerkt: 2026-04-13.

Doneer…