---
title: "List futures snapshots"
method: GET
path: "/v3/{coin}/futures/snapshots"
tags: ["v3 - Binance Futures"]
---

# List futures snapshots

`GET /v3/{coin}/futures/snapshots`

## Path parameters

- `coin` 'btc' | 'eth' | 'sol', required

## Query parameters

- `start_time` string
- `end_time` string
- `limit` integer
- `cursor` string
- `include_count` boolean

## Response `200`

Successful response

- V3BinanceSnapshotsListResponse
  - `data` V3BinanceSnapshot[], required
    - `id` integer, required
    - `price` number, required
    - `bids` unknown[] — Order book bids
      - unknown
    - `asks` unknown[] — Order book asks
      - unknown
    - `timestamp` string, date-time, required
  - `pagination` V3Pagination, required — Cursor pagination metadata. `total_count` is omitted unless `?include_count=true` is passed.
    - `next_cursor` string, nullable — Opaque cursor; pass back as `?cursor=` to fetch the next page
    - `has_more` boolean, required
    - `limit` integer, required
    - `count` integer, required — Number of items in this page
    - `total_count` integer, nullable — Only set when ?include_count=true (expensive)
  - `meta` V3Meta, required — Per-response metadata included on every v3 response.
    - `request_id` string, required
    - `timestamp` string, date-time, required

## Other responses

- `400` — Validation error (invalid coin, cursor, parameter, timestamp, …)
- `401` — Authentication failure (missing or invalid API key)
- `402` — Plan upgrade required
- `403` — Endpoint or coin not in the caller's plan
- `429` — Rate limit exceeded

---

[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)