How nvxtien/emporia works
Emporia is a distributed trading platform whose browser workflow passes through a single gateway to authentication and capability-owning services. Order intake is the central runtime path: the OMS processes commands through its Disruptor hot path, maintains order lifecycle state, and routes execution in-process. Separate services provide market/reference data, preferences, and portfolio receipts. README statements support the cross-service links; source excerpts and the index expose selected internal calls, so unsampled internal wiring is not inferred.
Main entry points: MarketDataService.java Market data service · EmporiaGatewayApplication.java API gateway · OrderCommandController.java Order API · OrderCommandHandler.java Order command handler
Components 20
Web and access
- Trading workspace
frontend/src/components/TradingWorkspacePage.tsx - API gateway
gateway/src/main/java/com/emporia/gateway/EmporiaGatewayApplication.java - OIDC and users
authentication/src/main/java/com/emporia/authentication/web/LoginController.java
Reference and market data
- Instrument listings
static-data-service/src/main/java/com/emporia/staticdata/InstrumentController.java - Market data service
market-data-service/src/main/java/com/emporia/marketdata/MarketDataService.java - Quote distribution
market-data-service/src/main/java/com/emporia/marketdata/MarketDataStreamService.java
Order lifecycle and execution
- Order API
order-management-service/src/main/java/com/emporia/ordermanagement/controller/OrderCommandController.java - Disruptor pipeline
order-management-service/src/main/java/com/emporia/ordermanagement/disruptor/DisruptorOrderPipeline.java - Order command handler
order-management-service/src/main/java/com/emporia/ordermanagement/service/OrderCommandHandler.java - Order state cache
order-management-service/src/main/java/com/emporia/ordermanagement/service/OrderStateCache.java - Order persistence
order-management-service/src/main/java/com/emporia/ordermanagement/repository/TradingOrderRepository.java - Execution routing
order-management-service/src/main/java/com/emporia/execution/RoutingExecutionVenueGateway.java - SOR and VWAP
emporia-algorithmic-strategies/src/main/java/com/emporia/strategy/api/AlgorithmicExecutionStrategy.java
User and portfolio capabilities
- Watchlists and layouts
user-preferences-service/src/main/java/com/emporia/userpreferences/WatchlistService.java - Portfolio receipts
portfolio-service/src/main/java/com/emporia/portfolio/PortfolioReceiptService.java
External systems
- Market providers
market-data-service/src/main/java/com/emporia/marketdata/MarketDataProvider.java - Execution venues
order-management-service/src/main/java/com/emporia/execution/ExecutionVenueGateway.java - Alpaca and FIX sources
market-data-service/src/main/java/com/emporia/marketdata/AlpacaIexMarketDataProvider.java - Exchange-core simulation
Other components
- Trading user
Connections 21
- Trading user → Trading workspace: uses
README.md - Trading workspace → API gateway: calls API
README.md - API gateway → OIDC and users: routes access
README.md - API gateway → Instrument listings: routes requests
README.md - API gateway → Market data service: routes requests
README.md - API gateway → Order API: routes orders
README.md - API gateway → Watchlists and layouts: routes requests
README.md - Market data service → Instrument listings: loads listings
README.md - Market data service → Market providers: gets quotes
market-data-service/src/main/java/com/emporia/marketdata/MarketDataService.java - Quote distribution → Market data service: snapshots quotes
market-data-service/src/main/java/com/emporia/marketdata/MarketDataStreamService.java - Quote distribution → Market data service: resolves listings
market-data-service/src/main/java/com/emporia/marketdata/MarketDataStreamService.java - Alpaca and FIX sources → Market data service: supplies prices
README.md - Order API → Disruptor pipeline: submits commands
README.md - Disruptor pipeline → Order command handler: handles commands
order-management-service/src/main/java/com/emporia/ordermanagement/disruptor/DisruptorOrderPipeline.java - Order command handler → Order state cache: updates state
order-management-service/src/main/java/com/emporia/ordermanagement/service/OrderCommandHandler.java - Order command handler → Order persistence: persists asynchronously
README.md - Order API → Instrument listings: validates listings
README.md - Execution routing → SOR and VWAP: selects strategy
README.md - Execution routing → Execution venues: dispatches execution
- Order API → Market data service: requests venue quotes
README.md - Exchange-core simulation → Portfolio receipts: submits snapshots
README.md