Skip to main content
GET
/
polymarket
/
holders
/
markets
/
history
Get market holders history
curl --request GET \
  --url https://api.struct.to/v1/polymarket/holders/markets/history
[
  {
    "t": 123,
    "h": 123
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.struct.to/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
condition_id
string

Market condition ID (0x-prefixed hex)

​
market_slug
string

Market slug (e.g. will-trump-win)

​
from
integer<int64>

Start timestamp (Unix seconds). If omitted, derived from hours param.

​
to
integer<int64>

End timestamp (Unix seconds). Defaults to now.

​
count_back
integer<int32>

Number of candles to return (default: 500, max: 2500)

​
hours
number<double>

Fallback time range in hours when from/to are not provided (default: 24, max: 336 = 14 days)

​
pagination_key
string

Cursor-based pagination key from previous response

Response

Market holder count history with automatic granularity (1m/5m/15m/1h/6h buckets)

​
t
integer<int64>
required
​
h
integer<int64> | null
Last modified on May 1, 2026