Concepts

Snapshots

Snapshots are time-ordered top-of-book samples for a research window: YES bid/ask plus the aligned coin price. Max window is 6 hours.

The market page does not use this endpoint. It calls preview (cached coverage + path + sample). See data layers.

What you get

{
  "ts": 1728153900.0,
  "yes_best_bid": 0.42,
  "yes_best_ask": 0.43,
  "coin_price": 85693.97
}

Downsampling

Use step_ms to thin the tape (e.g. 30000 for ~30s spacing) and limit to cap rows. Leave include_book=false unless you need full L2 arrays — those payloads are large.

When to use exports instead

Snapshots are for interactive inspection. For spreadsheets or pipelines, create an export and download the file.