---
title: "Get Snapshot At Timestamp"
method: GET
path: "/v2/markets/{market_id}/snapshot-at/{timestamp}"
tags: ["v2 - Snapshots"]
---

# Get Snapshot At Timestamp

`GET /v2/markets/{market_id}/snapshot-at/{timestamp}`

Get the closest snapshot to a specific timestamp.

Returns the snapshot closest to the given timestamp, but only if it's within ±2 seconds. Returns 404 if no snapshot is found within that range.

Note: Snapshots are always returned as an array (containing 0 or 1 element).

## Path parameters

- `market_id` string, required
- `timestamp` string, date-time, required

## Query parameters

- `coin` string, required

## Response `200`

Successful Response

- SnapshotAtTimestampResponse — Snapshot at timestamp response (always includes market and array of snapshots).
  - `market` MarketResponse, required — Single market response.
    - `market_id` string, required
    - `event_id` string, required
    - `slug` string, required
    - `market_type` string, required
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `{coin}_price_start` number, nullable — Coin price (USD) at market start. Field name depends on the coin queried: btc_price_start, eth_price_start, sol_price_start, etc.
    - `condition_id` string, nullable
    - `clob_token_up` string, nullable
    - `clob_token_down` string, nullable
    - `winner` string, nullable
    - `final_volume` number, nullable
    - `final_liquidity` number, nullable
    - `{coin}_price_end` number, nullable — Coin price (USD) at market end/resolution. Field name depends on the coin queried: btc_price_end, eth_price_end, sol_price_end, etc.
    - `resolved_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `snapshots` SnapshotResponse[], required — Array containing 0 or 1 snapshot closest to the requested timestamp
    - `id` integer, required — Unique snapshot identifier
    - `time` string, date-time, required — Timestamp when the snapshot was captured (ISO8601)
    - `market_id` string, required — ID of the market this snapshot belongs to
    - `{coin}_price` number, nullable — Coin price at the time of snapshot (USD). Field name depends on the coin queried: btc_price, eth_price, sol_price, etc.
    - `price_up` number, nullable — Best price for the UP token (0-1 range)
    - `price_down` number, nullable — Best price for the DOWN token (0-1 range)
    - `orderbook_up` OrderBookResponse — Order book containing bid and ask orders.
      - `bids` OrderBookEntry[], required — List of bid orders (buy orders), sorted by price descending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens
      - `asks` OrderBookEntry[], required — List of ask orders (sell orders), sorted by price ascending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens
    - `orderbook_down` OrderBookResponse — Order book containing bid and ask orders.
      - `bids` OrderBookEntry[], required — List of bid orders (buy orders), sorted by price descending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens
      - `asks` OrderBookEntry[], required — List of ask orders (sell orders), sorted by price ascending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens

## Other responses

- `401` — Missing or invalid API key
- `404` — No snapshot found within ±2 seconds of timestamp
- `422` — Validation Error

---

[API](https://skmtc.dev/polybacktest/apis/polybacktest-api.md) · [All operations](https://skmtc.dev/polybacktest/apis/polybacktest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polybacktest/polybacktest-api/revisions/262c9a5e60e4/schema)