Skip to main content
GET
/
polymarket
/
holders
/
positions
/
{position_id}
/
history
Get position holders history
curl --request GET \
  --url https://api.struct.to/v1/polymarket/holders/positions/{position_id}/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.

Path Parameters

​
position_id
string
required

Position ID (ERC1155 token ID)

Query Parameters

​
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

Position 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