Snapshots API

Overview

The Snapshots API provides a current snapshot of odds, locked_odds, and settled odds for specified fixtures. This endpoint serves as a fallback mechanism when you're not in sync with the RabbitMQ feed, ensuring you can always access the latest data when needed.

Primary Use Case: Recovery and synchronization when your RabbitMQ connection is interrupted or out of sync.

API Reference

For detailed endpoint specifications, see: https://developer.opticodds.com/reference/get_copilot-snapshot-fixtures-odds#/.

Response Format

Data Structure

Making a request to this endpoint returns all odds, locked odds, and settled odds for the requested fixtures. The response data maintains the same structure as the following RabbitMQ events:

  • copilot-odds
  • copilot-locked-odds
  • copilot-settled-odds

Key Differences

  • Snapshot Indicator: All messages include a snapshot: true field to distinguish them from real-time feed data
  • Timestamp Behavior: This is a full data send where each message uses the timestamp from when that specific odd was last updated, which may not match the current request timestamp

Important Notes

  • Use this endpoint sparingly - it's designed as a recovery mechanism, not for regular polling
  • Timestamps in the response reflect the last update time for each individual odd, not the snapshot request time
  • All data types (odds, locked odds, settled odds) are included in a single response for the requested fixtures