Files
foxhunt/services/trading_service
jgrusewski 1aef51f99b fix(stubs): implement 15 production stubs, fix routing, delete placeholders
Web-gateway routing:
- Point TRADING_SERVICE_URL at api-gateway (proto mismatch fix)
  Web-gateway uses foxhunt.tli.TradingService proto but was connecting
  directly to trading-service which implements trading.TradingService.
  api-gateway already proxies Subscribe* → Stream* correctly.

GitLab KAS:
- Disable gitlab_kas in appConfig to stop sidekiq NotifyGitPushWorker
  errors (KAS pod was already disabled but Rails still tried to connect)

Trading service monitoring (3 stubs → real):
- AcknowledgeAlert: real alert lookup + state mutation in shared store
- GetActiveAlerts: returns actual active alerts from in-memory store
- StreamAlerts: now persists generated alerts (capped at 1000 entries)

Trading service ML streams (2 stubs → real):
- StreamModelMetrics: emits real inference_count, error_count, latency
  per model every N seconds from the RuntimeModelInfo registry
- StreamSignalStrength: emits per-symbol signal aggregation from model
  ensemble weights and latency confidence

Backtesting service:
- stop_backtest: real CancellationToken cancellation (was no-op)
  Tokens stored per-backtest, execute_backtest wraps strategy call
  in tokio::select! for immediate cancellation

Deleted 7 empty placeholder files:
- 4 Wave D regime stubs (dynamic_stops, ensemble, performance_tracker,
  position_sizer) — comment-only files, never wired
- 2 Wave 3 feature stubs (microstructure, statistical)
- 1 PPO stub (unified_ppo.rs — empty struct definitions)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-28 23:47:31 +01:00
..

Trading Service

Overview

The trading_service is the core execution engine for the Foxhunt HFT platform. It manages the entire lifecycle of trading operations, from order placement and execution to real-time position keeping and risk management. This service is critical for high-frequency, low-latency trading activities, ensuring compliance and optimal performance.

Features

  • Order Execution: Handles high-throughput order placement, modification, and cancellation across various exchanges.
  • Position Management: Maintains real-time tracking of all open positions, including P&L calculations and exposure.
  • Risk Integration: Integrates with upstream risk systems to enforce pre-trade and post-trade compliance checks.
  • Compliance Checks: Automatically applies regulatory and internal compliance rules to all trading activities.
  • Market Data Subscriptions: Subscribes to and processes real-time market data feeds for informed decision-making.
  • Real-time P&L Tracking: Provides immediate profit and loss updates for active strategies and overall portfolio.
  • Health Checks and Metrics: Exposes endpoints for monitoring service health and operational metrics.

gRPC API

The trading_service exposes a gRPC API for interacting with its core functionalities. Key endpoints include:

  • PlaceOrder - Submit new orders
  • CancelOrder - Cancel existing orders
  • GetPosition - Query current positions
  • SubscribeMarketData - Subscribe to market data feeds
  • GetPnlUpdates - Retrieve real-time P&L updates

Running the service

To run the trading_service binary:

cargo run --bin trading_service

Configuration

The service is configured via the central config crate with PostgreSQL backend. Key configuration includes:

  • Database connection strings
  • Risk parameters and limits
  • Broker connection settings
  • gRPC server port and TLS settings

TLS Configuration (Agent S3)

The Trading Service supports TLS 1.3 with optional mutual TLS (mTLS) for secure gRPC communications.

Environment Variables:

TLS_ENABLED=false                                    # Enable TLS (default: false)
TLS_CERT_PATH=/app/certs/trading_service/server.crt # Server certificate
TLS_KEY_PATH=/app/certs/trading_service/server.key  # Server private key
TLS_CA_PATH=/app/certs/trading_service/ca.crt       # CA certificate
TLS_REQUIRE_CLIENT_CERT=false                        # Require client certs (default: false)

Certificate Directory Structure:

/app/certs/trading_service/
├── server.crt          # Server certificate
├── server.key          # Server private key
└── ca.crt              # CA certificate for client verification

Features:

  • TLS 1.3 encryption for all gRPC traffic
  • Mutual TLS (mTLS) support for client certificate authentication
  • 6-layer certificate validation (expiration, purpose, constraints, extensions, SANs, revocation)
  • Role-based access control (RBAC) via certificate Organizational Unit (OU)
  • CRL (Certificate Revocation List) support

Security Note: TLS is disabled by default for development. Enable TLS_ENABLED=true for production deployments.

Testing

To run the tests for the trading_service crate:

cargo test --package trading_service

Documentation

Comprehensive API documentation is available at docs.rs/trading_service.