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 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]
}