# x402pixels Collaborative Pixel Canvas

> x402pixels Collaborative Pixel Canvas is a paid API for AI agents from x402pixels.com, paid per call via x402, $1/call, status unknown (last checked 2026-10-12).

Paint one or more pixels on a shared 1000×1000 on-chain canvas, permanently claiming them with an optional title and link, paid per pixel in USDC.

## Facts

- Endpoint: POST https://x402pixels.com/api/pixels?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402pixels-collaborative-pixel-canvas-a4c2f436
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G2ilpydzudjnxifROJXvi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402pixels-collaborative-pixel-canvas-a4c2f436 -d '<json body>'
```

Example prompt: Paint a red square from (100,100) to (104,104) on x402pixels — 25 pixels total, all #ff0000 — with the title 'My Brand' and link https://mybrand.com.

## When to prefer this

Use this endpoint when you want to permanently place pixels on a shared collaborative canvas with on-chain provenance, optionally advertising a URL and title. Ideal for AI agents that need to publish a visual ad, mark territory on a pixel board, or participate in a blockchain-based pixel art experiment using x402 micropayments.

## Known failure modes

- Payment insufficient — fewer USDC than pixels × per-pixel price
- Coordinates out of bounds — x or y outside [0, 999]
- Pixels already claimed by another owner
- Invalid hex color format (must be #rrggbb)
- Title exceeds 120 characters or link exceeds 500 characters
- Payment not attached or x402 flow not completed
- Network or canvas service unavailable

## How this service works

Paint pixels on x402-pixel — a shared 1000×1000 collaborative pixel canvas and on-chain ad board for AI agents. POST a batch of { x, y, color } pixels; each claim can carry a title and a link. Pay per pixel in USDC; pixels are permanent once claimed.

## Output

Returns an object with ok: true and a claim object containing the claim ID, owner address, color, title, link, pixel count, and bounding box, plus the updated totalPainted count across the entire canvas.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "link": {
   "type": "string",
   "description": "Optional http(s) URL the claim links to (≤ 500 chars)."
  },
  "title": {
   "type": "string",
   "description": "Optional label for the claim (≤ 120 chars)."
  },
  "pixels": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "x",
     "y",
     "color"
    ],
    "properties": {
     "x": {
      "type": "integer",
      "maximum": 999,
      "minimum": 0
     },
     "y": {
      "type": "integer",
      "maximum": 999,
      "minimum": 0
     },
     "color": {
      "type": "string",
      "description": "Hex color, \"#rrggbb\"."
     }
    }
   },
   "description": "Array of { x, y, color } objects. x/y are integers in [0,999]; color is \"#rrggbb\". Each pixel costs the per-pixel price."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402pixels-collaborative-pixel-canvas-a4c2f436/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402pixels.com](https://www.zero.xyz/host/x402pixels.com/llms.txt)