Skip to main content
GET
Get Prices History
Retrieve time-series price data for a specific market outcome token. Useful for charting, backtesting, and trend analysis.

Query Parameters

string
required
CLOB token ID (Polymarket token address). This is the unique identifier for the outcome token you want price history for.
number
Start timestamp in Unix seconds. Omit to use the server default (beginning of available data).
number
End timestamp in Unix seconds. Omit to use the current time.
string
Time aggregation interval. One of: max, all, 1m, 1w, 1d, 6h, 1h.
integer
default:"1"
Data fidelity in minutes. Higher values produce coarser data with fewer points. Default is 1 (one-minute granularity).
string
default:"polymarket"
Trading venue identifier. Default: polymarket.

Response

array
Array of price data points.

Authorizations

Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

market
string
required

CLOB token ID (Polymarket token address)

startTs
number

Start timestamp (Unix seconds)

endTs
number

End timestamp (Unix seconds)

interval
enum<string>

Time aggregation interval

Available options:
max,
all,
1m,
1w,
1d,
6h,
1h
fidelity
integer
default:1

Data fidelity in minutes (default 1)

Required range: x >= 1
venue
string
default:polymarket

Trading venue (default: polymarket)

Maximum string length: 50

Response

200 - application/json

Historical prices

code
integer
Example:

200

message
string
Example:

"success"

data
object