Summary
Creators currently have no way to see who is in their community. Knowing which wallets hold your keys — and how many — is basic information a creator needs to understand their audience and reward their most loyal supporters. This endpoint turns the key ownership read model into a useful creator-facing feature.
Scope
- Add
GET /creators/:id/holders endpoint
- Response returns a paginated list of:
{ wallet_address, key_balance, held_since }
held_since is the timestamp of the wallet's first buy for this creator
- Default sort is by
key_balance descending (largest holders first)
- Support
sort=held_since to surface earliest supporters first
- Entries are sourced from the indexer's ownership read model
Acceptance Criteria
Coordinate on Telegram
Summary
Creators currently have no way to see who is in their community. Knowing which wallets hold your keys — and how many — is basic information a creator needs to understand their audience and reward their most loyal supporters. This endpoint turns the key ownership read model into a useful creator-facing feature.
Scope
GET /creators/:id/holdersendpoint{ wallet_address, key_balance, held_since }held_sinceis the timestamp of the wallet's first buy for this creatorkey_balancedescending (largest holders first)sort=held_sinceto surface earliest supporters firstAcceptance Criteria
sort=held_sincereturns earliest buyers firstheld_sincereflects the timestamp of the wallet's first buy transaction for that creatorCoordinate on Telegram