# Parity House Public API

Public, read-only. No authentication. All 5,000 characters are browsable.

Nobody picks which character they mint. The token-to-character map is a
permutation fixed for the whole collection at once by /allocation, and the
roster itself lives onchain, so every assignment is independently
recomputable from the shift and stride published there.

GET /characters?limit&offset&department&team&search&rarity&trait_<dim>&sort
GET /characters/:id            full profile (roster + onchain + memory)
GET /characters/:id/traits     trait indices + labels + rarity score
GET /characters/:id/image.svg  24x24 onchain-identical pixel PFP
GET /characters/:id/history    memory (interactions, jobs, errors, relationships)
GET /tokens/:tokenId           owner, and which roster record the token holds
GET /tokens/:tokenId/image.svg sealed dossier, or the assigned character's PFP
GET /allocation                roster contract, reveal state, shift and stride
GET /departments               department + team headcounts
GET /traits                    full trait rarity table
GET /stats                     collection-level statistics
GET /feed                      recorded onchain + memory activity
GET /mint-status               public mint open/price + supply + reveal state
GET /holders/:address          tokens held, sealed or revealed
GET /agents/:id/agent.json     agent descriptor: persona, capabilities, identity, chain
GET /agents/:id/activate.md    activation skill for the holder's AI agent (Circle Agent Stack on Arc)
GET /agents?status&department&team&capability&q   agent discovery (default: characters with an ERC-8004 identity)
GET /agents/:id/status         live agent state: steward, operator, identity, bound wallet, USDC, reputation, next_step
GET /agents/:id/reputation     ERC-8004 ReputationRegistry feedback
GET /agents/:id/registration.json  ERC-8004 registration file (registration-v1)
GET /.well-known/agent-registration.json  endpoint-domain proof for every identity served here
GET /health