How oddin-gg/gosdk works
Oddin.gg’s Go SDK combines a REST catalog API with a streaming odds-feed client. The main consumer workflow is to configure and construct a client, subscribe (which connects to AMQP if needed), decode feed deliveries into typed messages, and consume them; subscriptions can be drained before shutdown. Separate capabilities expose catalog lookups and caches, replay controls, producer status, and feed recovery. The excerpts show several internal calls, but not the full client/session wiring, so some relationships are omitted rather than inferred.
Main entry points: client.go Client lifecycle · api/client.go REST API client · session.go Session orchestration · channelConsumer.go Delivery consumer
Components 19
Client lifecycle
- Client lifecycle
client.go - Configuration
config.go - Subscription
subscription.go
Streaming feed
- Session orchestration
session.go - AMQP feed client
internal/feed/client.go - Delivery consumer
internal/feed/channelConsumer.go - Feed XML decoder
internal/feed/xml/decode.go - Feed message builder
internal/factory/feedMessage.go - Typed messages
types/message.go
Catalog API
- REST API client
internal/api/client.go - Catalog caches
internal/cache/manager.go - Sports catalog
internal/sport/manager.go - Market catalog
internal/market/manager.go
Feed operations
- Producer state
internal/producer/manager.go - Feed recovery
internal/recovery/manager.go - Replay controls
internal/replay/manager.go
Other components
- SDK consumer
- AMQP broker
- Oddin REST API
Connections 20
- SDK consumer → Client lifecycle: configures
- Client lifecycle → Subscription: creates
- Subscription → Session orchestration: receives messages
- Session orchestration → AMQP feed client: uses
session.go - AMQP feed client → AMQP broker: connects
internal/feed/client.go - Session orchestration → Delivery consumer: dispatches deliveries
session.go - Delivery consumer → Feed XML decoder: decodes
internal/feed/channelConsumer.go - Delivery consumer → Feed message builder: builds messages
internal/feed/channelConsumer.go - Feed message builder → Typed messages: produces
internal/factory/feedMessage.go - Client lifecycle → REST API client: sets up
- REST API client → Oddin REST API: requests data
internal/api/client.go - Sports catalog → REST API client: fetches catalog
internal/sport/manager.go - Sports catalog → Catalog caches: uses
internal/sport/manager.go - Market catalog → Catalog caches: reads and clears
internal/market/manager.go - Market catalog → REST API client: loads descriptions
- Client lifecycle → Producer state: sets up
- Client lifecycle → Feed recovery: sets up
- Client lifecycle → Replay controls: exposes
- Replay controls → REST API client: controls replay
internal/replay/manager.go - Replay controls → Sports catalog: resolves matches
internal/replay/manager.go