Skip to main content
GET
/
v1
/
btc
/
future
/
snapshots
Futures Snapshots
curl --request GET \
  --url https://api.polyhistorical.com/v1/btc/future/snapshots \
  --header 'X-API-Key: <x-api-key>'
{
  "data": [
    {}
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

​
Futures Snapshots

Returns paginated historical Binance Futures BTC/USDT depth snapshots captured by PolyHistorical.
Requires a Pro or Enterprise plan. Historical futures snapshots are currently available for BTC/USDT.

​
Request

https://api.polyhistorical.com/v1/btc/future/snapshots

​
Headers

​
X-API-Key
string
required
Your API key. See Authentication.

​
Query parameters

​
limit
integer
default:"100"
Number of snapshots to return (1-1000).
​
offset
integer
default:"0"
Pagination offset.
​
start_time
integer
Filter snapshots from this UTC epoch timestamp in milliseconds.
​
end_time
integer
Filter snapshots up to this UTC epoch timestamp in milliseconds.

​
Response

​
data
array
Paginated list of snapshot objects.
​
total
integer
Total snapshots matching the filters.
​
limit
integer
Requested result limit.
​
offset
integer
Current pagination offset.

​
Example

cURL
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.polyhistorical.com/v1/btc/future/snapshots?limit=100&offset=0"

​
Response

{
  "data": [
    {
      "symbol": "BTCUSDT",
      "time_epoch_ms": 1779730000000,
      "coin_price": 77593.69,
      "bids": [
        { "price": 77593.68, "quantity": 0.64379 }
      ],
      "asks": [
        { "price": 77593.70, "quantity": 0.20000 }
      ],
      "last_update_id": 94228633307
    }
  ],
  "total": 12345,
  "limit": 100,
  "offset": 0
}