Cohorts
Wallet clusters, their members, and the evidence edges that produced them.
A cohort is a set of wallets the Indexer has grouped together. Each cohort publishes the edges that produced it, so a membership claim can be inspected rather than taken on faith.
4 routes. Every path below is served under /index/v1/{chain}, and every request carries an x-api-key header, so those two are not repeated per route. The shared contract for pagination, snapshots, precision and absence is in Read API.
Cohorts By Token
GET /cohortsFunding cohorts seeded by members funded in this token, in ascending cohort id. primary marks the anchor asset. The cursor is bound to the funding generation, so a new generation answers 409 stale_cursor and the walk restarts.
| Parameter | In | Required | Notes |
|---|---|---|---|
token | query | yes | 0x-prefixed token address to look up cohorts for. |
cursor | query | no | Opaque page cursor, bound to the funding generation. |
limit | query | no | Rows per page. |
Cohort Detail
GET /cohorts/{id}Cohort metadata: kind, size, primary asset, generation, and for a Funding cohort freshness {ruleVersion, overridesVersion, currentRuleVersion, currentOverridesVersion, stale, staleReasons} plus a hoisted stale.
| Parameter | In | Required | Notes |
|---|---|---|---|
id | path | yes | Cohort id: 8 bytes, 16 hex digits, no 0x prefix. |
Cohort Edges
GET /cohorts/{id}/edgesThe evidence edges that produced membership. Screened members' edges are withheld (screenedOut), with the same freshness and cohortsComplete trio as /members.
| Parameter | In | Required | Notes |
|---|---|---|---|
id | path | yes | Cohort id: 8 bytes, 16 hex digits, no 0x prefix. |
cursor | query | no | Opaque page cursor. See Pagination. |
limit | query | no | Page row cap. See Pagination for the shared contract; the exact default and maximum for this route are on the schema. |
Cohort Members
GET /cohorts/{id}/membersMember wallets, each with admittedBy {signals, edge, funder, assetKind, asset, firstBlock, lastBlock}. Members a current entity override screens out (the member, or the funder that admitted it) are dropped and listed in screened/screenedOut, and the page reports freshness.stale. cohortsComplete/cohortsIncompleteReason/fundingGeneration state whether the funding half was ever derived.
| Parameter | In | Required | Notes |
|---|---|---|---|
id | path | yes | Cohort id: 8 bytes, 16 hex digits, no 0x prefix. |
cursor | query | no | Opaque page cursor. See Pagination. |
limit | query | no | Page row cap. See Pagination for the shared contract; the exact default and maximum for this route are on the schema. |