List Polymarket price history
List the price history of a Polymarket outcome token.
Headers
Get your API keyAPI key (`sfk_...`)
Outcome token id: a market outcome's `tokenId`.
pattern: ^[0-9]{1,100}$
How far back to go: `1h`, `6h`, `1d`, `1w`, `1m` (one month), `max` or `all`. Default: `1w`. Ignored when `from` is given.
one of: 1h, 6h, 1d, 1w, 1m, max, all
Start of the range, unix seconds.
≥ 1 · ≤ 4102444800
End of the range, unix seconds. Default: now.
≥ 1 · ≤ 4102444800
Seconds per point, 60–86400. Default: chosen from the range.
≥ 60 · ≤ 86400
Items per page, 1–1000. Default: 500.
≥ 1 · ≤ 1000
Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.
min 1 chars · max 6000 chars
Endpoint-specific response payload.
`not_found` when the token has no price history: unknown.
one of: found, not_found
The token id asked for.
Oldest first.
Start of the bucket (ISO-8601, UTC).
Price as a probability between 0 and 1.
Length of the bucket in seconds.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/tokens/54533043819946592547517511176940999955633860128497669742211153063842200957669/price-history?interval=1w" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket price history.