/archive/{partition path}

GET https://data.vike.io/archive/venue=polymarket/date={YYYY-MM-DD}/{stream}.parquet
GET https://data.vike.io/archive/venue=polymarket/asset={asset}/tenor={tenor}/date={YYYY-MM-DD}/{stream}.parquet

One path prefix covering the whole archive. The two path shapes above are two Hive partitionings of the same data behind one path, not two endpoints — full detail of both, and which dates each covers, is on Bulk archive.

There is no JSON response to show you. The body is a binary Apache Parquet file — the 2026-09-01 trades file the download recipe below fetches is 13,459,739 bytes. So the first example asks for the first 2 KB of the next day's partition instead of the whole of it, which is enough to prove the route, the gate and the file type without moving the file:

curl -H "X-API-Key: $VIKE_API_KEY" \
  -r 0-2047 -D - -o /dev/null \
  "https://data.vike.io/archive/venue=polymarket/date=2026-09-02/trades.parquet"

Response headers, verbatim, 2026-09-03:

HTTP/1.1 206 Partial Content
Content-Type: application/octet-stream
Content-Length: 2048
Content-Range: bytes 0-2047/12314277
Last-Modified: Thu, 03 Sep 2026 00:32:06 GMT
ETag: "6a98c006-bbe6a5"
Cache-Control: private, no-store
Server: cloudflare
cf-cache-status: DYNAMIC

The first four bytes of that body are 50 41 52 31 — the ASCII PAR1 every Parquet file opens and closes with. The rest is zstd-compressed column data and is not readable as text.

Three of those headers are worth reading as confirmations rather than trivia. 206 with a Content-Range is the Range row of the table below, working — the server served 2,048 bytes of a file it told you is 12,314,277. That total is also the cross-check on manifest.json: its dates entry for 2026-09-02 reports the trades stream at 1,006,555 rows and 12,314,277 bytes — the same total — so a size read from the manifest is the size you will actually be billed bandwidth for. And cf-cache-status: DYNAMIC beside Cache-Control: private, no-store is the third bullet below holding: Cloudflare saw the response and declined to cache it.

Drop the credential and the same URL never reaches the file — the request is refused before the file is opened. The status is 401 Authorization Required and the body is a plain HTML error page from the edge, not a JSON envelope:

<html>
<head><title>401 Authorization Required</title></head>
<body>
<center><h1>401 Authorization Required</h1></center>
</body>
</html>

There are no query parameters. What you can vary is the path and a small set of headers:

# download one whole day of one stream: a flat partition, written to disk
curl -H "X-API-Key: $VIKE_API_KEY" \
  -o polymarket-trades-2026-09-01.parquet \
  "https://data.vike.io/archive/venue=polymarket/date=2026-09-01/trades.parquet"

# one crypto up/down family's file for the same day: the small alternative to the multi-asset flat one (a family with no rows in a stream has no file that day)
curl -H "X-API-Key: $VIKE_API_KEY" \
  -o polymarket-btc-5m-trades-2026-09-01.parquet \
  "https://data.vike.io/archive/venue=polymarket/asset=btc/tenor=5m/date=2026-09-01/trades.parquet"

# an interrupted download: -C - resumes where the file on disk ends, which is what Range support is for
curl -H "X-API-Key: $VIKE_API_KEY" \
  -C - -o polymarket-trades-2026-09-01.parquet \
  "https://data.vike.io/archive/venue=polymarket/date=2026-09-01/trades.parquet"

# which streams exist for a day: a directory URL answers with an HTML listing once you present a credential
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/archive/venue=polymarket/date=2026-09-01/"

# the two streams that are not gigabytes, fetched one whole file each; book_events is the large one, so size it with the manifest before you pull it
for s in trades l1_quotes; do
  curl -H "X-API-Key: $VIKE_API_KEY" \
    -o "polymarket-$s-2026-09-01.parquet" \
    "https://data.vike.io/archive/venue=polymarket/date=2026-09-01/$s.parquet"
done

Send one of the two credentials, not both.

A missing file is a legitimate answer in the family layout. A family with zero rows in a stream on a given day has no file for that stream, and the family layout does not cover every date the date= layout does. Enumerate families[] rather than assuming.

Three properties of this location worth knowing before you point a tool at it:

• Responses carry Cache-Control: private, no-store, on every response. An authenticated file must never be cached at the edge — a cached copy would bypass both the gate and the usage record — so do not expect a CDN to serve a repeat download for you.
• A directory URL under /archive/ returns a listing rather than a 403, once you present a credential. The listing is HTML.
• Throughput is capped at 50 MB/s per connection. It is a bandwidth bound, not a request bound; parallel whole-file downloads are the supported way to go faster, and cost one recorded download each.