Cellionaire

Price a selection of cells right now and say whether it can be ordered (meets the minimum, not reserved, not in image review). Nothing is reserved or charged. Wraps POST /api/quote. Wall coordinates: x 0..999 (left to right), y 0..999 (top to bottom); cell index = y*1000 + x.

Create an order for cells and return the USDC payment details (recipient wallet, token, amount_units, Solana reference, pay_by, status URL). This tool does not pay: the caller sends the USDC transfer itself before pay_by. Same validation and limits as the website (minimum cells, at most 16 colours (image orders are not supported here), rate limits, unpaid orders per IP). accepted_terms must be true and means you accept the terms at https://cellionaire.com/terms. Wall coordinates: x 0..999 (left to right), y 0..999 (top to bottom); cell index = y*1000 + x. If you can pay with x402, use prepare_x402_order instead (one request, no transfer to build). If you have no wallet, give status_url to a human.

Status of an order and its USDC payment (state, received, confirmations, refunds). usdc.remaining is an amount to send only when usdc.can_topup is true, or when state is waiting (then it is the one full amount). If can_topup is false after a payment was seen, remaining is omitted: do not send a second transfer. Wraps GET /api/order/{id}. status: pending, processing, paid, pending_review, expired, cancelled, late_paid, refund_pending, refunded, failed.

Rules, prices, size, minimum order, payment networks, terms version and whether purchases are open. Numbers come from the live settings. No input.

Price cells and return a ready-to-send x402 request (URL, method, headers, JSON body, exact amount). Nothing is reserved or charged. Send it with an x402 client (x402-fetch, x402-axios, @x402/fetch); it pays and creates the order in one request. Raise the client's max amount if the price is above its default cap (x402-fetch 0.10 USDC, @x402/fetch 1 USDC). Cells that already have an owner can be bought over at the overwrite price (get_wall_info prices.rule: the multiplier times the last price while the cell is inside its reset window, otherwise the empty-cell price); total_usd here, and the 402 of the returned request, state the exact amount. Areas map to the HTTP body as [y*1000+x, 0xRRGGBB] pairs.

Pixels and owners of a rectangle (w*h <= 10000). format "json" (default): base64 RGBA pixels plus runs of empty / buyer (with public display name) / house cells. format "png": the rectangle as a PNG image. Wraps GET /api/region. Wall coordinates: x 0..999 (left to right), y 0..999 (top to bottom); cell index = y*1000 + x.

Current wall version, the URL of the full-wall PNG (1 pixel = 1 cell; alpha 0 empty, 255 bought, 254 site-owned house art) and how to read regions. Wraps GET /api/wall. No input.