# Cellionaire Cell Purchase & Paint API

> Cellionaire Cell Purchase & Paint API is a paid API for AI agents from cellionaire.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-18).

Buy and paint cells on a 1,000,000-cell shared canvas, or take over existing cells at 1.5× their last price

## Facts

- Endpoint: POST https://cellionaire.com/api/x402/order?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cellionaire-cell-purchase-paint-api-1de080fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kS0xa_tAyEm0kicxrrnir

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 cellionaire-cell-purchase-paint-api-1de080fb -d '<json body>'
```

Example prompt: On Cellionaire, buy cells at positions (0,0), (1,0), and (2,0) — that's indices 0, 1, and 2 — and paint them red (0xFF0000), green (0x00FF00), and blue (0x0000FF) respectively, under the owner handle 'mymark', with terms accepted.

## When to prefer this

Use this endpoint when you want to programmatically purchase, paint, or claim cells on the Cellionaire shared canvas. It is the only API for placing and coloring cells on this specific 1,000,000-cell internet canvas. Prefer it when building agents that automate pixel art placement, digital advertising, or competitive cell claiming on this platform.

## Known failure modes

- Missing or empty 'cells' array returns a validation error
- Cell index out of range (must be 0–999,999) causes rejection
- Color value not a valid 0xRRGGBB integer causes rejection
- accepted_terms not set to true causes rejection
- Payment of $0.01 USDC per API call not provided triggers 402 Payment Required
- Owner string exceeds 40 characters causes validation failure
- Attempting to buy already-owned cells without paying the 1.5× takeover price may fail

## How this service works

Buy a pixel on a public 1000x1000 canvas for $0.01 USDC on Base: a cheap real mainnet purchase to test an AI agent wallet's first x402 payment, or to place your own mark (a colored cell with a public name) on Cellionaire. POST the cells you want, pay the 402, and they appear on the wall usually under a minute after settlement. $0.01 per empty cell; a single cell is a valid order. A cell sold in the last 24 h costs 2x its last price. Display space only, no financial return.

## Output

Returns a JSON object with an order status ('processing'), a unique orderId, the total cost in USD, and the count of cells purchased. The agent can use the orderId to track the order.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cells": {
   "type": "array",
   "items": {
    "type": "array",
    "items": {
     "type": "integer"
    }
   },
   "minItems": 1,
   "description": "[idx, color]: idx = y*1000+x, color = 0xRRGGBB; 1 cell is enough"
  },
  "owner": {
   "type": "string",
   "maxLength": 40,
   "description": "Public name shown on the wall"
  },
  "accepted_terms": {
   "const": true,
   "description": "true = you accept /terms"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "processing",
  "orderId": "0123456789abcdef",
  "total_usd": 10,
  "cell_count": 10
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cellionaire-cell-purchase-paint-api-1de080fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cellionaire.com](https://www.zero.xyz/host/cellionaire.com/llms.txt)
