How tapanhaz/fsticker works
fsticker is a multi-broker market-data feed for Shoonya/NorenWS-compatible WebSockets. A user configures broker credentials, starts a synchronous or asyncio feed, and subscribes instruments; broker sessions reconnect and resubscribe independently while the merge layer produces a deduplicated tick stream. Optional stages build OHLC candles and persist completed candles to TimescaleDB. The graph reflects documented capabilities and source-index references; several implementation relationships are not directly visible in the excerpts, so they are omitted rather than inferred.
Main entry points: sf_feed.hpp Merged feed coordinator · ticker.hpp Broker ticker · bridge.hpp Sync feed API · async_feed.py Async feed API
Components 16
Feed APIs
- Sync feed API
fsticker/bridge.hpp - Async feed API
fsticker/async_feed.py - Async event queue
fsticker/async_queue_bridge.hpp
Broker Connections
- Broker ticker
fsticker/include/ticker.hpp - WebSocket session
fsticker/include/session.hpp - IP pinning
fsticker/include/ip_pinning.hpp - Reconnect backoff
fsticker/include/backoff.hpp
Merge Pipeline
- Merged feed coordinator
fsticker/include/merge/sf_feed.hpp - Tick reconstruction
fsticker/include/merge/reconstructor.hpp - Feed store
fsticker/include/merge/feed_store.hpp - Tick model
fsticker/include/merge/tick.hpp
Feed Outputs
- Candle engine
fsticker/include/merge/candle_engine.hpp - Candle persistence
fsticker/include/merge/timescale_sink.hpp
Other components
- Feed consumer
- Broker WebSockets
- Postgres / TimescaleDB
Connections 20
- Feed consumer → Sync feed API: starts and subscribes
README.md - Feed consumer → Async feed API: starts and subscribes
README.md - Sync feed API → Merged feed coordinator: coordinates feed
fsticker/bridge.hpp - Merged feed coordinator → Broker ticker: manages brokers
fsticker/include/merge/sf_feed.hpp - Broker ticker → Broker WebSockets: connects and subscribes
README.md - Broker ticker → WebSocket session: uses session
fsticker/include/ticker.hpp - Broker ticker → Reconnect backoff: backs off retries
fsticker/include/ticker.hpp - WebSocket session → IP pinning: pins connections
fsticker/include/session.hpp - Merged feed coordinator → Tick reconstruction: uses reconstruction
fsticker/include/merge/sf_feed.hpp - Merged feed coordinator → Feed store: uses store
fsticker/include/merge/sf_feed.hpp - Merged feed coordinator → Candle engine: configures candles
fsticker/include/merge/sf_feed.hpp - Merged feed coordinator → Candle persistence: configures persistence
fsticker/include/merge/sf_feed.hpp - Tick reconstruction → Tick model: produces ticks
fsticker/include/merge/reconstructor.hpp - Feed store → Tick model: stores ticks
fsticker/include/merge/feed_store.hpp - Candle engine → Tick model: consumes ticks
fsticker/include/merge/candle_engine.hpp - Candle persistence → Postgres / TimescaleDB: persists candles
fsticker/include/merge/timescale_sink.hpp - Merged feed coordinator → Async event queue: bridges async events
- Async event queue → Async feed API: delivers events
- Sync feed API → Feed consumer: delivers callbacks
README.md - Async feed API → Feed consumer: delivers callbacks
README.md