fin-engine-core

Shared core library for fin-engine microservices.

Contratos Estables (v1)

OrderSignal

Intención de orden generada por el brain.

from fin_engine_core import OrderSignal, SIDE_BUY, SIDE_SELL

signal = OrderSignal(
    side=SIDE_BUY,
    simbolo="AAPL",
    razon="SCORE>THRESHOLD",
    score=0.45,
    regimen="TRENDING",
)

NotificationEvent

Evento de notificación para el notifier.

from fin_engine_core import NotificationEvent

event = NotificationEvent(
    tipo="venta",
    usuario="pedro",
    simbolo="AAPL",
    pnl=12.34,
)

EventBus

Interfaz pub/sub abstraída.

from fin_engine_core import RedisSignalBus, InMemorySignalBus

bus = RedisSignalBus(host="localhost", port=6379)
bus.publicar("señales", signal)

Domain Models

from fin_engine_core import (
    AccountSnapshot,
    PositionSnapshot,
    snapshot_desde_estado,
    OrderJournal,
    OrderStateMachine,
    TradingCalendar,
    get_category,
    get_et_now,
    get_cl_now,
    is_market_open_et,
)

Instalación

pip install fin-engine-core==1.0.0

Versionado

SemVer estricto. v1.x = estable. Breaking changes = v2.0.0.