Platform users can earn the same reviewed KOL badge as every CabalSpy ID user. It needs a connected X account, and the requirements described in the overview: at least 5,000 followers, an X account older than 90 days and at least $25,000 on-chain volume in the last 7 days. Every application is reviewed manually.
Status
GET /v1/platform-users/kol?external_id=<id>
Whether the user holds the KOL badge.
Whether the user meets every criterion right now.
The badge criteria and whether the user meets each of them.
The latest measured 7-day on-chain volume in USD.
When the next volume check can be requested, or null.
The latest application: status, applied_at and reviewed_at. Null when the user never applied.
Volume check
POST /v1/platform-users/kol/volume-check
Queues a fresh measurement of the user’s 7-day on-chain volume. Answers 202 with "queued": true; read the result with the status endpoint. Checks are rate limited per user, volume_check_next_at says when the next one is possible.
Your id of the user. Alternatively pass csid_id.
Apply
POST /v1/platform-users/kol/apply
Applies for the badge in the user’s name. Answers 201 with "application": "pending". The user must have X connected and meet every criterion, otherwise the answer is kol_not_eligible with the criteria.
Your id of the user. Alternatively pass csid_id.
The status endpoint and the user object show badge: true once the badge is granted.
Errors
See Errors for the full list.