NORMIES API

Documentation, favicon, and health.

• GET/cache: none

  Human-readable API documentation.

• GET/llms.txtcache: none

  LLM/tool-readable API documentation.

• GET/favicon.pngcache: public, max-age=86400

  PNG favicon.

• GET/favicon.icocache: public, max-age=86400

  PNG favicon served at the ICO path.

• GET/healthcache: none

  Health check. Response: { "status": "ok" }.

Active endpoints apply zombie and Canvas state. Original endpoints ignore zombie conversion and Canvas edits. Token IDs are 0–9999.

• GET/normie/all/originalcache: public, max-age=60, s-maxage=300

  Bulk original mint dump: token ID, raw image data, decoded traits, pixel count, block number, timestamp, tx hash.

• GET/normie/all/original/datacache: public, max-age=300, s-maxage=3600

  Alias-style bulk original mint dump with the same token rows.

• GET/normie/all/original/traitscache: public, max-age=300, s-maxage=3600

  Decoded original traits for all indexed tokens.

• GET/normie/all/original/traits/binarycache: public, max-age=300, s-maxage=3600

  Raw original bytes8 trait hex for all indexed tokens.

• GET/normie/all/original/pixelscache: public, max-age=300, s-maxage=3600

  Original raw image data and pixel counts for all indexed tokens.

• GET/normie/all/original/canvascache: public, max-age=300, s-maxage=3600

  Canvas-oriented alias for the original bitmap rows.

• GET/normie/{id}/ownercache: public, max-age=10, s-maxage=10

  Current indexed owner.

• GET/normie/{id}/pixelscache: public, max-age=60, s-maxage=300

  Active 40×40 bitmap as a 1600-character 0/1 string.

• GET/normie/{id}/traits/binarycache: public, max-age=300, s-maxage=3600

  Raw original mint trait hex.

• GET/normie/{id}/traitscache: public, max-age=300, s-maxage=3600

  Decoded original mint traits.

• GET/normie/{id}/image.svgcache: public, max-age=60, s-maxage=300

  Active SVG image. Zombie art and Canvas transforms are applied when present.

• GET/normie/{id}/image.pngcache: public, max-age=60, s-maxage=300

  Active 1000×1000 PNG image rendered from the active SVG.

• GET/normie/{id}/metadatacache: public, max-age=60, s-maxage=300

  Active NFT metadata JSON with Level, Pixel Count, Action Points, Customized, zombie attributes when converted, and Legendary Canvas artist when set.

• GET/normie/{id}/legendary-canvascache: public, max-age=60, s-maxage=300

  Legendary Canvas state for a token.

• GET/normie/{id}/original/pixelscache: public, max-age=300, s-maxage=3600

  Original mint bitmap as a 1600-character 0/1 string.

• GET/normie/{id}/original/image.svgcache: public, max-age=300, s-maxage=3600

  Original mint SVG.

• GET/normie/{id}/original/image.pngcache: public, max-age=300, s-maxage=3600

  Original mint PNG.

• GET/normie/{id}/zombiecache: public, max-age=60, s-maxage=300

  Token-scoped zombie info plus conversion history.

• GET/normie/{id}/zombie/attributescache: public, max-age=60, s-maxage=300

  Zombie attributes for a converted token, or an empty list if not converted.

• GET/normie/{id}/zombie/pixelscache: public, max-age=60, s-maxage=300

  Zombie bitmap as a 1600-character string.

• GET/normie/{id}/zombie/image.svgcache: public, max-age=60, s-maxage=300

  Zombie SVG image.

• GET/normie/{id}/zombie/image.pngcache: public, max-age=60, s-maxage=300

  Zombie PNG image.

• GET/normie/{id}/canvas/pixelscache: public, max-age=60, s-maxage=300

  Canvas transform bitmap as a 1600-character string.

• GET/normie/{id}/canvas/diffcache: public, max-age=60, s-maxage=300

  Pixel diff between active base art and Canvas transform.

• GET/normie/{id}/canvas/infocache: public, max-age=60, s-maxage=60

  Canvas level, the pixels on the Normie (actionPoints), customized flag, delegate, delegate setter, gridSize, baseCleared, migrated, lockedPixels and freePixels.

Global state for the burn-to-edit programmable canvas, plus per-token pixels and canvas services.

• GET/canvas/statuscache: public, max-age=300, s-maxage=300

  Global Canvas contract status: paused state, max burn percent, tier thresholds, tier minimum percents, and a pixelMarket object with enlargement and blank canvas prices, the treasury and the market fee config.

• GET/canvas/token/{id}/pixelscache: public, max-age=10, s-maxage=10

  Pixels on one Normie: attached, locked (backing the overlay), free, level, gridSize, baseCleared.

• GET/canvas/token/{id}/activitycache: public, max-age=10, s-maxage=10

  Ledger events that changed the pixels attached to a token, newest first. Query: limit, offset.

• GET/canvas/sinkscache: public, max-age=10, s-maxage=10

  Pixels spent on canvas services: enlargements and blank canvases. Query: tokenId, kind (enlarge or clearBase), limit, offset.

Wallet-level pixel balances from NormiesCanvasStorageV2. 404 until the Pixel Market stack is configured.

• GET/pixels/balance/{address}cache: public, max-age=10, s-maxage=10

  Wallet balance plus the pixels on the wallet’s Normies: attached, locked, free and a per-token breakdown.

• GET/pixels/holderscache: public, max-age=10, s-maxage=10

  Holders of #PIXEL, largest first. balance = wallet + listed (open listings) + attached (on owned Normies). Query: limit, offset.

• GET/pixels/holders/{address}cache: public, max-age=10, s-maxage=10

  One wallet counted the same way: { balance, wallet, listed, attached, normiesWithPixels }.

• GET/pixels/activity/{address}cache: public, max-age=10, s-maxage=10

  Wallet balance moves involving the address, newest first. Query: limit, offset.

• GET/pixels/supplycache: public, max-age=10, s-maxage=10

  Total pixels in wallets and attached to migrated Normies, plus the number of holding wallets.

Sell-side order book, ETH priced per pixel. Prices and volumes are wei strings. 404 until the stack is configured.

• GET/market/statuscache: public, max-age=10, s-maxage=10

  Market config from the chain: paused flag, fee and revenue-share basis points, canvas service prices.

• GET/market/listingscache: public, max-age=10, s-maxage=10

  Listings with seller, price per pixel, amount, remaining, fill mode, expiry and status. Query: status (active, filled, cancelled, all), seller, partial, sort (price-asc, price-desc, amount-desc, newest), expired, limit, offset.

• GET/market/listings/{id}cache: public, max-age=10, s-maxage=10

  One listing plus its fills.

• GET/market/depthcache: public, max-age=10, s-maxage=10

  Active listings grouped by price level, cheapest first.

• GET/market/fillscache: public, max-age=10, s-maxage=10

  Fill feed with buyer, seller, amount, price, gross and fee. Query: limit, offset, after_timestamp, sort.

• GET/market/fills/address/{address}cache: public, max-age=10, s-maxage=10

  Fills where the address bought or sold. Query: limit, offset.

• GET/market/statscache: public, max-age=10, s-maxage=10

  Totals, active listings, pixels listed, best ask, last price, 24h volume, fee config.

• GET/market/candlescache: public, max-age=10, s-maxage=10

  OHLC in wei per pixel from fills, with volume and pixel counts per bucket. Query: interval (1h, 4h, 1d), limit 1-1000.

• GET/revshare/configcache: public, max-age=10, s-maxage=10

  Revenue share scoring rules and their configHash, which every posted epoch records on chain.

• GET/revshare/statuscache: public, max-age=10, s-maxage=10

  Pool balance, what is promised to posted epochs, what is waiting for the next one, the claim window and totals.

• GET/revshare/epochscache: public, max-age=10, s-maxage=10

  Posted epochs with root, amount, claimed, block range, claimableAt and status.

• GET/revshare/epochs/{id}/proof/{address}cache: public, max-age=10, s-maxage=10

  Index, amount and Merkle proof for NormiesRevenuePool.claim.

• GET/revshare/wallet/{address}cache: public, max-age=10, s-maxage=10

  Live score, share and breakdown (a projection), claimable epochs with proofs, and past claims.

• GET/revshare/tierscache: public, max-age=10, s-maxage=10

  Scoring wallets per cell of the tier grid: Normie bracket x #PIXEL boost.

Burns, transforms, and indexer stats.

• GET/history/burnscache: public, max-age=60, s-maxage=300

  Paginated Canvas burn commitments. Query: limit 1–100, offset.

• GET/history/burns/{commitId}cache: public, max-age=60, s-maxage=300

  One burn commitment plus burned token details. Commit ids restart at 0 on the V2 canvas; query version=1|2 (defaults to the newest configured).

• GET/history/burns/pending/legacycache: public, max-age=60, s-maxage=300

  Original-canvas commitments not yet revealed there; anyone can reveal them on that canvas. Query: owner, limit, offset.

• GET/history/burns/address/{address}cache: public, max-age=60, s-maxage=300

  Burn commitments created by a wallet. Query: limit, offset.

• GET/history/burns/receiver/{tokenId}cache: public, max-age=60, s-maxage=300

  Burn commitments that credited pixels to a receiver token. Wallet burns (toWallet: true) are not listed here. Query: limit, offset.

• GET/history/burned-tokenscache: public, max-age=60, s-maxage=300

  Paginated list of burned token records. Query: limit, offset.

• GET/history/burned-idscache: public, max-age=60, s-maxage=300

  Every burned token id in one response: { count, ids }, ids ascending.

• GET/history/burned/{tokenId}cache: public, max-age=60, s-maxage=300

  Burn record for a token.

• GET/history/burned/{tokenId}/image.svgcache: public, max-age=60, s-maxage=300

  Original SVG for a burned token.

• GET/history/burned/{tokenId}/image.pngcache: public, max-age=60, s-maxage=300

  Original PNG for a burned token.

• GET/history/customizedcache: public, max-age=60, s-maxage=300

  Canvas transform event sync feed: events, unique token IDs, count, hasMore, timestamp cursor. Query: limit, offset, after_timestamp/since_timestamp, sort=asc|desc.

• GET/history/normie/{id}/versionscache: public, max-age=60, s-maxage=300

  Transform versions for a token, oldest first, with change count, new pixel count, gridSize, cleared, transformer, block, timestamp, and tx hash. Query: limit, offset.

• GET/history/normie/{id}/version/{version}/pixelscache: public, max-age=60, s-maxage=300

  Historical composited pixel string for a transform version.

• GET/history/normie/{id}/version/{version}/image.svgcache: public, max-age=60, s-maxage=300

  Historical composited SVG for a transform version.

• GET/history/normie/{id}/version/{version}/image.pngcache: public, max-age=60, s-maxage=300

  Historical composited PNG for a transform version.

• GET/history/statscache: public, max-age=60, s-maxage=300

  Indexer summary counts for burn commitments, burned tokens, transforms, token data, zombies, Legendary Canvas, the pixels earned by burning (sum of burn rewards) and the pixels carried over between Normies, plus pixel supply and market totals.

Wallet holdings and Canvas delegations.

• GET/holders/{address}cache: public, max-age=10, s-maxage=10

  Current indexed token IDs held by a wallet.

• GET/delegations/{address}cache: public, max-age=10, s-maxage=10

  Canvas edit rights delegated to a wallet, filtered to the delegations the canvas still honours. Delegations set by a previous owner are dropped. Returns tokenIds plus an owners map.

Merkle-gated commit-reveal conversions that turn eligible Normies into bespoke Zombies.

• GET/zombies/statuscache: public, max-age=10, s-maxage=10

  Zombie contract status and pool configuration.

• GET/zombies/conversionscache: public, max-age=60, s-maxage=300

  Paginated zombie conversion commitments and reveal state. Query: limit, offset.

• GET/zombies/wallet/{address}cache: public, max-age=60, s-maxage=300

  Zombie conversions for a qualifying wallet. Query: limit, offset.

• GET/zombies/token/{id}cache: public, max-age=60, s-maxage=300

  Zombie info plus conversion history for a token.

• GET/zombies/token/{id}/attributescache: public, max-age=60, s-maxage=300

  Zombie attributes for a token.

• GET/zombies/token/{id}/pixelscache: public, max-age=60, s-maxage=300

  Zombie bitmap as a 1600-character string.

• GET/zombies/token/{id}/image.svgcache: public, max-age=60, s-maxage=300

  Zombie SVG image.

• GET/zombies/token/{id}/image.pngcache: public, max-age=60, s-maxage=300

  Zombie PNG image.

Tokens marked with the Legendary Canvas artist trait.

• GET/legendary-canvascache: public, max-age=60, s-maxage=300

  Paginated list of tokens marked with the Legendary Canvas artist trait. Query: limit, offset.

• GET/legendary-canvas/token/{id}cache: public, max-age=60, s-maxage=300

  Legendary Canvas state for one token.

Awakened Normies bound to on-chain agent identities.

• GET/agents/metadata/{tokenId}cache: public, max-age=60, s-maxage=120, swr=300

  ERC-8004 metadata JSON served as the on-chain agent URI.

• GET/agents/persona-preview/{tokenId}cache: public, max-age=30, s-maxage=60, swr=300

  Persona JSON for any token, whether or not it is registered as an agent.

• GET/agents/identity/{tokenId}cache: public, max-age=300, s-maxage=600, swr=3600

  Trait-derived agent name, type, and raw trait map.

• GET/agents/info/{tokenId}cache: public, max-age=30, s-maxage=60, swr=300

  Registered-agent persona, traits, live canvas state, registration metadata, and placeholder interaction/MCP status.

• GET/agents/by-agent-id/{agentId}/infocache: public, max-age=30, s-maxage=60, swr=300

  Reverse lookup by ERC-8004 agent ID, same shape as /agents/info/{tokenId}.

• GET/agents/listcache: public, max-age=30, s-maxage=60, swr=300

  Paginated registered-agent gallery feed enriched with identity. Query: limit 1–100, sort=newest|oldest, optional cursor agent ID.

• GET/agents/searchcache: public, max-age=15, s-maxage=30, swr=120

  Search registered agents by name, token ID, or agent ID. Query: q, limit 1–50.

• GET/agents/countcache: public, max-age=30, s-maxage=60, swr=300

  Total registered Normies agents.

• GET/agents/agent-card/{tokenId}cache: public, max-age=60, s-maxage=120, swr=300

  A2A v0.3.0 Agent Card JSON linked from ERC-8004 metadata.

• GET/agents/image/{tokenId}cache: public, max-age=60, s-maxage=60, swr=300

  Composited SVG image for an agent.

• GET/agents/binding/{tokenId}cache: public, max-age=30, s-maxage=60, swr=300

  Normies-only ERC-8004 binding lookup for one token.

• POST/agents/binding/batchcache: public, max-age=30, s-maxage=60

  Batch binding lookup. Body: { "tokenIds": [...] }.

• GET/agents/by-agent-id/{agentId}cache: public, max-age=60, s-maxage=300

  Reverse lookup returning the raw binding for an agent ID.

Powers rarity.normies.art. Historical routes recompute ownership, burns, traits, and ranks at a block number; they omit OpenSea listings and floor price.

• GET/rarity/docscache: public, max-age=15, s-maxage=30, swr=120

  Small JSON list of rarity endpoints.

• GET/rarity/statscache: public, max-age=15, s-maxage=30, swr=120

  Live rarity stats: indexed count, live supply, burned count, weights, listing count, floor price, and awakened-agent count.

• GET/rarity/normiescache: public, max-age=15, s-maxage=30, swr=120

  Paginated live rarity list with rank, score, attributes, listing data, fair value, underpriced flag, burn count, and awakened-agent metadata. Query: page, limit 1–100, sort, order, search, listed=1, underpriced=1, the100=1, awake=1, px_tier, wallet_ids, trait_* filters.

• GET/rarity/normie/{id}cache: public, max-age=15, s-maxage=30, swr=120

  Full live rarity detail for one token. Returns 410 if burned.

• POST/rarity/normie/{id}/refreshcache: public, max-age=15, s-maxage=30, swr=120

  Forces the live rarity collection cache to reload, then returns the same detail shape.

• GET/rarity/normie/{id}/personacache: public, max-age=15, s-maxage=30, swr=120

  Awakened-agent persona fields used by the rarity modal. 404 if not an agent.

• GET/rarity/traitscache: public, max-age=15, s-maxage=30, swr=120

  Trait filter counts over live, non-burned tokens.

• GET/rarity/holder/{addressOrEns}cache: public, max-age=15, s-maxage=30, swr=120

  Current indexed rarity holdings for a wallet. ENS names resolved at request time.

• GET/rarity/recursive-burn-holderscache: public, max-age=15, s-maxage=30, swr=120

  Leaderboard of current wallets by recursive burn count of held customized tokens. Query: limit 1–200, optional wallet.

• GET/rarity/historical/{blockNumber}/statscache: public, max-age=15, s-maxage=30, swr=120

  Rarity stats recomputed at an Ethereum block number.

• GET/rarity/historical/{blockNumber}/normiescache: public, max-age=15, s-maxage=30, swr=120

  Paginated rarity list at a block number. Same non-marketplace filters and sorts as the live list.

• GET/rarity/historical/{blockNumber}/normie/{id}cache: public, max-age=15, s-maxage=30, swr=120

  Full rarity detail at a block number. 410 if burned at that block, 404 if not indexed yet.

• GET/rarity/historical/{blockNumber}/traitscache: public, max-age=15, s-maxage=30, swr=120

  Trait filter counts over live, non-burned tokens at a block number.

• GET/rarity/historical/{blockNumber}/holder/{addressOrEns}cache: public, max-age=15, s-maxage=30, swr=120

  Indexed wallet holdings at a block number.

• GET/rarity/historical/{blockNumber}/recursive-burn-holderscache: public, max-age=15, s-maxage=30, swr=120

  Recursive-burn leaderboard at a block number. Query: limit 1–200, optional wallet.

• GET/rarity/listings/streamcache: no-store

  Server-Sent Events for listing changes: listed, sold, cancelled.

• GET/rarity/legendarycache: public, max-age=15, s-maxage=30, swr=120

  Rarity-app Legendary Canvas curation config with current and upcoming arrays.

• PUT/rarity/admin/legendarycache: no-store

  Admin-only save for Legendary Canvas curation config. Requires x-admin-key.