Build on BRAINROT

The Community Public Interface (CPI) is a public, read-only API over BRAINROT's on- and off-chain data. Grab an API key, then build leaderboards, dashboards, bots — whatever you like.

Get an API key →

Authentication

Every /v1 request needs an API key, sent as a bearer token or the X-API-Key header. Keys are issued from your dashboard.

curl https://cpi.brainrot.works/v1/stats \
  -H "Authorization: Bearer cpi_live_your_key_here"

Endpoints

GET/v1/tokensPer-token off-chain activity (paginated)

GET/v1/tokens/:idA single token's activity summary

GET/v1/statsCollection-level totals

GET/v1/leaderboardBrainpoints leaderboard

Limits & fair use

Responses are rate-limited per key. Watch the RateLimit-Remaining header.
Reads are cached at the edge — expect data to lag by up to a few minutes.
The API is read-only. There are no write endpoints, by design.