Skip to main content
GET
/
polymarket
/
builders
/
{builder_code}
/
retention
Cohort retention for a builder
curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders/{builder_code}/retention
[
  {
    "cohort_day": 123,
    "cohort_size": 123,
    "retained": {
      "d1": 123,
      "d7": 123,
      "d30": 123
    },
    "retention": {
      "d1": 123,
      "d7": 123,
      "d30": 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

​
builder_code
string
required

Builder code.

Query Parameters

​
from
integer<int64>

Inclusive start of cohort window (Unix seconds). Default: now - 30 days.

​
to
integer<int64>

Inclusive end of cohort window (Unix seconds). Default: now - 1 day. Cohorts within this range have at least one full day for D1 retention; older cohorts are required for D7/D30.

Response

200 - application/json

Per-cohort-day retention metrics

​
cohort_day
integer<int64>
required

Cohort day as Unix-second timestamp at 00:00 UTC.

​
cohort_size
integer<int64>
required

Number of distinct traders whose first-ever trade with this builder landed on cohort_day.

​
retained
object
required

Counts of cohort traders active on day +1 / +7 / +30.

​
retention
object
required

Retained counts as fractions of cohort_size (0 when cohort is empty).

Last modified on May 1, 2026