Get market holders history

curl --request GET \
  --url https://api.struct.to/v1/polymarket/holders/markets/history

[
  {
    "t": 123,
    "h": 123,
    "block": 123
  }
]

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,
    "block": 123
  }
]

condition_id

string

Market condition ID (0x-prefixed hex)

market_slug

string

Market slug

from

integer<int64>

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

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

Market holder count history.

integer<int64>

required

Bucket timestamp as Unix seconds.

integer<int64> | null

Holder count at the end of the bucket.

block

integer<int64> | null

Latest block represented by this bucket.

Last modified on June 17, 2026