Normies API

Returns the 40x40 monochrome bitmap as a 1600-character binary string of 0s and 1s. Row-major order, top-left to bottom-right. 1 = pixel on (#48494b), 0 = pixel off (#e3e5e4 background). If the Normie has been customized, returns the composited (original XOR transform) bitmap.

curl https://your-api-domain.com/normie/0/pixels

# Response: 1600 characters
# 0000000000000000000000000000000000000000
# 0000000001111111111111100000000000000000
# ...

Returns the raw bytes8 trait data as a hex string. Each byte is an index into a trait category (8 categories total).

curl https://your-api-domain.com/normie/0/traits/binary

# Response: 0x0001000305010200

Returns decoded traits as a JSON object with human-readable labels.

curl https://your-api-domain.com/normie/0/traits

# Response:
{
  "raw": "0x0001000305010200",
  "attributes": [
    { "trait_type": "Type", "value": "Human" },
    { "trait_type": "Gender", "value": "Female" },
    { "trait_type": "Age", "value": "Young" },
    { "trait_type": "Hair Style", "value": "Straight Hair" },
    { "trait_type": "Facial Feature", "value": "Shadow Beard" },
    { "trait_type": "Eyes", "value": "Big Shades" },
    { "trait_type": "Expression", "value": "Serious" },
    { "trait_type": "Accessory", "value": "Top Hat" }
  ]
}

Returns the Normie image as an SVG. 1000x1000 output with a 40x40 viewBox. Matches the on-chain renderer output exactly (RLE row-scan optimization). If customized, returns the composited image.

curl https://your-api-domain.com/normie/0/image.svg -o normie.svg

# Or use directly in HTML:
# <img src="https://your-api-domain.com/normie/0/image.svg" />

Returns the Normie image as a 1000x1000 PNG. Rasterized from the SVG with pixel-perfect rendering. If customized, returns the composited image.

curl https://your-api-domain.com/normie/0/image.png -o normie.png

Returns the full NFT metadata JSON, matching the on-chain tokenURI() output (V4 renderer). Includes name, attributes (with canvas-aware Level, Action Points, Customized), SVG image, and animation URL. If customized, uses the composited image.

curl https://your-api-domain.com/normie/0/metadata

# Response:
{
  "name": "Normie #0",
  "attributes": [
    { "trait_type": "Type", "value": "Human" },
    ...
    { "display_type": "number", "trait_type": "Level", "value": 1 },
    { "display_type": "number", "trait_type": "Pixel Count", "value": 527 },
    { "display_type": "number", "trait_type": "Action Points", "value": 0 },
    { "trait_type": "Customized", "value": "No" }
  ],
  "image": "data:image/svg+xml;base64,...",
  "animation_url": "data:text/html;base64,..."
}

Returns the current owner of a Normie. Returns 404 if the token has been burned or was never minted.

curl https://your-api-domain.com/normie/42/owner

# Response:
{
  "tokenId": "42",
  "owner": "0x1234...abcd"
}

Returns all Normie token IDs currently owned by the given wallet address.

curl https://your-api-domain.com/holders/0x1234...abcd

# Response:
{
  "address": "0x1234...abcd",
  "tokenIds": ["42", "100", "1337"]
}

Returns the original 40x40 bitmap as a 1600-character binary string, before any Canvas edits.

Returns the original Normie SVG image, before any Canvas edits.

Returns the original Normie PNG image, before any Canvas edits.

Returns the transform layer (XOR overlay) as a 1600-character binary string. Each 1 represents a pixel that was flipped by the Canvas edit. Returns all 0s if the Normie has not been customized.

Returns a pixel-level diff between the original and the Canvas edits. Lists which pixels were added (turned on) and removed (turned off).

curl https://your-api-domain.com/normie/42/canvas/diff

# Response:
{
  "added": [{ "x": 10, "y": 5 }, { "x": 11, "y": 5 }],
  "removed": [{ "x": 20, "y": 15 }],
  "addedCount": 2,
  "removedCount": 1,
  "netChange": 1
}

Returns Canvas metadata for a Normie: action points, level, customization status, and delegate info.

curl https://your-api-domain.com/normie/42/canvas/info

# Response:
{
  "actionPoints": 25,
  "level": 3,
  "customized": true,
  "delegate": "0x0000000000000000000000000000000000000000",
  "delegateSetBy": "0x0000000000000000000000000000000000000000"
}

Returns the global NormiesCanvas contract status: paused state and burn tier configuration.

curl https://your-api-domain.com/canvas/status

# Response:
{
  "paused": false,
  "maxBurnPercent": 4,
  "tierThresholds": [490, 890],
  "tierMinPercents": [1, 2, 3]
}

Lists all burn commitments (newest first). Supports pagination via ?limit=50&offset=0 (max 100 per page).

curl https://your-api-domain.com/history/burns?limit=10

# Response:
[
  {
    "commitId": "0",
    "owner": "0x1234...abcd",
    "receiverTokenId": "42",
    "tokenCount": 3,
    "transferredActionPoints": "0",
    "blockNumber": "12345678",
    "timestamp": "1700000000",
    "txHash": "0xabc...def",
    "revealed": true,
    "totalActions": "15",
    "expired": false
  }
]

Returns a single burn commitment with its array of burned tokens. Each burned token includes the token ID and its pixel count at the time of burn.

curl https://your-api-domain.com/history/burns/0

# Response:
{
  "commitId": "0",
  "owner": "0x1234...abcd",
  "receiverTokenId": "42",
  "tokenCount": 3,
  "revealed": true,
  "totalActions": "15",
  "burnedTokens": [
    { "tokenId": "100", "pixelCount": 527 },
    { "tokenId": "200", "pixelCount": 490 },
    { "tokenId": "300", "pixelCount": 612 }
  ]
}

Returns burn commitments by owner address. Paginated.

Returns burn commitments where the specified token was the receiver of action points. Paginated.

Lists all individually burned tokens (newest first). Paginated.

Returns burn info for a specific token: which commitment it was burned in, pixel count at time of burn.

Returns the SVG image of a burned Normie. SSTORE2 data persists on-chain even after the token is burned, so the original image is still readable.

curl https://your-api-domain.com/history/burned/100/image.svg -o burned-normie.svg

Returns the PNG image of a burned Normie.

Lists all transform versions for a token. Each entry represents a setTransformBitmap call with metadata about pixel changes. Versions are 0-indexed chronologically.

curl https://your-api-domain.com/history/normie/42/versions

# Response:
[
  {
    "version": 0,
    "changeCount": 12,
    "newPixelCount": 535,
    "transformer": "0x1234...abcd",
    "blockNumber": "12345678",
    "timestamp": "1700000000",
    "txHash": "0xabc...def"
  }
]

Returns the SVG image for a historical version. Reconstructed by XOR-compositing the original image with the stored transform bitmap from that version.

curl https://your-api-domain.com/history/normie/42/version/0/image.svg -o version-0.svg

Returns the PNG image for a historical version.

Returns the composited 1600-character pixel string for a historical version.

Returns global Canvas activity statistics.

curl https://your-api-domain.com/history/stats

# Response:
{
  "totalBurnCommitments": 25,
  "totalBurnedTokens": 100,
  "totalTransforms": 50,
  "totalActionPointsDistributed": "1500"
}