API Reference

V1 Parquet API

Returns one market or instrument's historical data for one data type and UTC date as a Parquet file. For Polymarket, symbol is the market_slug; for Chainlink, it is the instrument symbol, such as BTCUSD; for Predict.fun, it is the numeric market_id for l2 and onchain_fills, and markets_lifecycle for lifecycle (one file per day with every market).

See historical data details for availability and data schemas for file contents.

To find Polymarket markets and the dates PMData has data for, see the markets catalog.

Path parameters

All path parameters are required.

Available data types

Chainlink downloads require a paid plan (Plus: Polymarket or Plus: Predict.fun). Free accounts can download Polymarket data older than 3 weeks (21 days). Supported symbols are listed in Chainlink historical data details.

Predict.fun is a separate product with its own allowance: free accounts can download Predict.fun data older than 3 weeks, and data from the last 3 weeks needs Plus: Predict.fun (Plus: Polymarket does not include it). Predict.fun files hold the order book of each market's first outcome only; the outcome parameter returns 400. See Predict.fun historical data details.

Example

Request one market's L2 data:

https://api.pmdata.dev/v1/polymarket/l2/2026/08/08/will-jd-vance-win-the-2028-us-presidential-election.parquet

Request one day of Predict.fun market lifecycle updates:

https://api.pmdata.dev/v1/predict_fun/lifecycle/2026/10/01/markets_lifecycle.parquet

Response

A successful request returns 200 OK with a Parquet file and consumes one download quota unit. Repeated downloads consume quota again.

Unavailable files return 404 Not Found and do not consume quota. For Polymarket trades and onchain_fills, a 404 on a day the market was recorded means it had no trades that day; the markets catalog lists which markets were recorded on which days.

This endpoint returns the complete file; byte-range requests are supported by the ZIP API below.

ZIP API

Returns a ZIP archive of Parquet files for one UpDown asset and timeframe, one data type and one UTC day. This lets you download a day's recorded markets in one request.

Path parameters

All path parameters are required.

Example

Download one UTC day of BTC 5-minute UpDown L2 data:

https://api.pmdata.dev/v1/polymarket/l2/2026/08/08/btc-5m.zip

Response and download quota

A successful request returns 200 OK with Content-Type: application/zip. The archive contains the available market Parquet files for the requested series and date. An unavailable archive returns 404 Not Found.

Quota is charged per archive and data type:

Resuming downloads

ZIP downloads support a single byte range. Send Range: bytes=START- to resume an interrupted download, or Range: bytes=START-END to request a specific portion. A valid range returns 206 Partial Content with a Content-Range header.

Requests starting after byte 0 do not consume additional download quota. A full download or a range starting at byte 0 consumes the archive's normal quota. Suffix ranges and multiple ranges are not supported; invalid or out-of-bounds ranges return 416 Range Not Satisfiable.

Errors

Error responses generally contain a JSON error field and may include a message. A free account requesting Chainlink data receives 403 Forbidden:

{
  "error": "Chainlink data is not included in the free tier. Please upgrade at https://pmdata.dev/pricing"
}

A free account requesting Polymarket data from the last 3 weeks receives 403 Forbidden:

{
  "error": "Data from the last 3 weeks is not included in the free tier. Please upgrade at https://pmdata.dev/pricing"
}

An account without Plus: Predict.fun requesting Predict.fun data from the last 3 weeks receives 403 Forbidden:

{
  "error": "Predict.fun data from the last 3 weeks requires the Plus: Predict.fun plan. Please upgrade at https://pmdata.dev/pricing"
}

When a free account has insufficient download quota, the API returns 429 Too Many Requests:

{
  "error": "You have used up all your free download quota. Please upgrade at https://pmdata.dev/pricing",
  "message": "You have used up all your free download quota. Please upgrade at https://pmdata.dev/pricing"
}

Paid accounts with insufficient download quota receive 429 Too Many Requests:

{
  "error": "Too Many Requests",
  "message": "Download quota has been used up."
}

An invalid ZIP range returns an empty body with a Content-Range: bytes */FILE_SIZE header.

Deprecated endpoints

These endpoints still work and return the same data as the V1 API. Use the V1 endpoints above for new code.

Supports UpDown 5m, 15m and 1h markets only.

Returns the same file as the ZIP API.

Returns the same file as the V1 Parquet API for Chainlink.

/get-download-url, /get-download-urls and the poly_snapshot and snapshot data types return 410 Gone. To get order book snapshots, download l2 data and generate them with l2_to_snapshot.py.