# Clout Caster

Clout Caster is a Farcaster-first creator game built by @lucifercaretaker with @viniapp.
Players build a creator identity, compare public scores, complete daily progression, and start weekly battles.
Store purchases use the real CLOUT token on Base. Clout Credits are separate game progress with no cash value.

Canonical app: https://clout-caster.vercel.app
Creator contact: @lucifercaretaker on Farcaster (FID 1450388)
Human-readable API docs: https://clout-caster.vercel.app/api-docs

## Public pages

- / — Clout Arena and daily game entry
- /battles — weekly creator battles
- /leaderboard — public score boards
- /empire — creator progression hub
- /marketplace — free community creator assets
- /passport — shareable creator identity
- /discover — creator intelligence
- /store — fixed-price CLOUT purchases
- /about — plain-language app and token explanation
- /api-docs — public JSON API documentation

## Public read-only JSON API

All routes accept GET and OPTIONS, include CORS headers, and are limited to 60 requests per minute per client.

### GET /api/public/status

Returns app identity, creator credit, network, currency, and the public endpoint list.

Example:
GET https://clout-caster.vercel.app/api/public/status
{"app":"Clout Caster","creator":{"username":"lucifercaretaker","fid":1450388},"network":"Base","storeCurrency":"CLOUT"}

### GET /api/public/leaderboard?metric=elo&limit=20

Returns public standings. metric may be elo, rep, or streak. limit must be 1–50.

Example:
GET https://clout-caster.vercel.app/api/public/leaderboard?metric=elo&limit=10
{"metric":"elo","entries":[{"rank":1,"fid":1450388,"cloutElo":1210}]}

### GET /api/public/creators/{fid}

Returns public creator identity, archetype, score tiers, streak, and latest spin summary.

Example:
GET https://clout-caster.vercel.app/api/public/creators/1450388
{"creator":{"fid":1450388,"username":"lucifercaretaker","cloutElo":1000,"latestSpin":null}}

### GET /api/public/battles?limit=20

Returns recent public pending, active, and completed battles. Wallet and admin data are omitted.

Example:
GET https://clout-caster.vercel.app/api/public/battles?limit=5
{"battles":[{"id":42,"status":"active","category":"Growth Duel"}]}

## Sharing

Result, score, battle, discovery, profile, passport, and creator-asset creation surfaces can compose a Farcaster cast.
Share text links back to Clout Caster and credits @lucifercaretaker with @viniapp.