# 402milly — full documentation for agents > The documents 402milly publishes for agents, in one file: the map (llms.txt), > the overview (index.md), the purchase manual (SKILL.md) and the API contract > (OpenAPI). Each section names the URL it comes from; that URL is the source of > truth. ======================================================================== Source: https://402milly.xyz/llms.txt ======================================================================== # 402milly — Million Dollar Pixel Marketplace > Own your piece of internet history. Buy pixels on the 402milly grid and display your image > and link, paid in USDC via the x402 protocol (gasless, multichain). Built by Ultravioleta DAO. ## What is 402milly? A pixel-advertising marketplace where humans and AI agents buy blocks of a shared grid and attach an image and a link. Payment is the authentication: every purchase is an x402 flow (HTTP 402 challenge, then a signed USDC payment settled by the facilitator; the buyer pays no gas). Pricing starts at $1 USDC per 10×10 block. ## Machine-readable resources - **Agent-facing overview** (markdown): https://402milly.xyz/index.md - **Full documentation in one file**: https://402milly.xyz/llms-full.txt - **x402 discovery** (the paid routes): https://402milly.xyz/.well-known/x402 - **Authentication guide for agents**: https://402milly.xyz/auth.md - **A2A agent card**: https://402milly.xyz/.well-known/agent-card.json - **Agent skills index**: https://402milly.xyz/.well-known/agent-skills/index.json - **MCP server card**: https://402milly.xyz/.well-known/mcp/server-card.json - **OpenAPI**: https://api.402milly.xyz/openapi.json - **Grid metadata** (configuration and live stats): https://api.402milly.xyz/grid/metadata - **Website**: https://402milly.xyz - **This file**: https://402milly.xyz/llms.txt ## API Base URL: `https://api.402milly.xyz/` - `POST /purchase` — buy pixels (x402 paid: 402 challenge, then signed payment) - `POST /tiles/batch` — fetch pixel tiles for the viewer - `GET /grid/metadata` — grid configuration and live stats - `GET /pixels/{id}` — single pixel / deep link ## Built with the house SDK - `uvd-x402-sdk` — x402 payments on the frontend (npm: https://www.npmjs.com/package/uvd-x402-sdk) and on the purchase backend (PyPI: https://pypi.org/project/uvd-x402-sdk/) ## Operator Ultravioleta DAO — https://ultravioletadao.xyz ======================================================================== Source: https://402milly.xyz/index.md ======================================================================== # 402milly — Million Dollar Pixel Marketplace Own your piece of internet history. Buy pixels on the 402milly grid and display your image and link, paid in USDC via the **x402 protocol** (gasless, multichain) across 10+ EVM chains plus Solana, NEAR, Stellar, and Sui. Built by Ultravioleta DAO. - **Current grid:** 1,000,000 pixels (1000×1000), expanding to 402,002,500 (20,050×20,050) - **Price:** from $1 USDC per 10×10 block - **Payment:** x402 (you sign, the facilitator pays gas) ## API Base URL: `https://api.402milly.xyz/` - `POST /purchase` — buy pixels (x402 paid; HTTP 402 challenge, then signed payment) - `POST /tiles/batch` — fetch pixel tiles for the viewer - `GET /grid/metadata` — grid configuration and live stats - `GET /pixels/{id}` — single pixel / deep link ## Agent resources - Agent skills index: `/.well-known/agent-skills/index.json` - MCP server card: `/.well-known/mcp/server-card.json` - A2A agent card: `/.well-known/agent-card.json` - API catalog: `/.well-known/api-catalog` - Authentication guide: `/auth.md` ## Links - Website: https://402milly.xyz/ - Operator: Ultravioleta DAO — https://ultravioleta.xyz/ ======================================================================== Source: https://402milly.xyz/.well-known/agent-skills/x402-pixel-purchase/SKILL.md ======================================================================== --- name: x402-pixel-purchase description: Buy advertising pixels on the 402milly.xyz Million Dollar Pixel marketplace by paying USDC via the x402 protocol. Use when an agent needs to reserve or purchase pixel space, read the pixel grid, or look up a pixel by id. --- # Purchase pixels on 402milly.xyz (x402 / USDC) 402milly.xyz is a Million Dollar Pixel marketplace where pixels are bought in blocks (from $1 in USDC per 10x10 block), paid via the x402 protocol. The crypto wallet only SIGNS; an x402 facilitator submits the on-chain transaction and pays gas. ## API Base URL: `https://api.402milly.xyz/` - `POST /tiles/batch` - read occupied pixels for a set of tiles. Body: `{"tiles":[{"x":0,"y":0}]}`. - `GET /grid/metadata` - grid configuration + stats (dimensions, tiles, pixels sold). - `GET /pixels/{id}` - look up a single pixel block (deep linking). - `POST /purchase` - buy pixels (x402-paid, two-step flow below). ## Two-step x402 purchase flow 1. POST `/purchase` WITHOUT the `X-PAYMENT` header and with `imageUrl` empty. The server replies `HTTP 402` with payment requirements (amount, token, recipient, and EIP-712 / Solana signing data). 2. Sign the payment (EVM: sign the EIP-712 structured message only - never sendTransaction; Solana: sign the partial USDC-transfer transaction only - never signAndSendTransaction). Upload the image, then POST `/purchase` again WITH the `X-PAYMENT` header and the real `imageUrl`. The server verifies the payment with the facilitator and records the purchase. The image must be a PNG or JPEG of exactly `width` x `height` pixels, the area you are buying. `POST /upload` only returns a presigned S3 form: it does not resize. A purchase whose image does not match is refused with `HTTP 400` (`expected` / `got` in the body) before anything is charged. The upload is private: nothing is served at `imageUrl` until the purchase is paid and its content approved (do not fetch it before: a CDN may cache the 404). The form is valid for 5 minutes and the upload is kept for at least 1 day, so buy within a day of uploading or upload again. `linkUrl` must be an `http://` or `https://` URL; any other scheme is refused with `HTTP 400`. ## Rules - Never modify the x402 payload structure. - Never require `imageUrl` on the initial 402 request. - Never make the user's wallet pay gas or submit the transaction directly - the facilitator is the fee payer. ## MCP An MCP server exposing the full 402milly API over Streamable HTTP is available at `https://mcp.402milly.xyz/mcp` (see `/.well-known/mcp/server-card.json`). ======================================================================== Source: https://api.402milly.xyz/openapi.json ======================================================================== # 402milly.xyz Pixel Marketplace API (OpenAPI, version 2.0.0) API for purchasing and managing pixels on the 402M pixel grid. Powered by x402 protocol for gasless USDC payments on Base, Avalanche, and more. ## Guidance 402milly sells advertising space on a pixel grid: you buy a rectangular block and attach an image, a title and a link. Main route: POST /purchase with {x, y, width, height, title, linkUrl}. Called without an X-PAYMENT header it answers HTTP 402 with x402 payment requirements (accepts[]); resend the same body plus the X-PAYMENT header and an imageUrl obtained from POST /upload to complete the purchase. The image must be a PNG or JPEG of exactly width x height pixels: POST /upload does not resize, and a purchase whose image does not match is refused with HTTP 400 before anything is charged. The uploaded image stays private until the purchase is paid and approved, and an upload is kept for at least 1 day. linkUrl must be an http:// or https:// URL. Payment is gasless USDC via x402 (EIP-3009 signature on EVM chains, partial transaction on Solana) - a facilitator submits the transaction and pays gas, the buyer only signs. Price is $0.01 per pixel when paying with a dollar stablecoin (USDC, AUSD, PYUSD, USDT) and EUR0.01 per pixel when paying with EURC; minimum block 10x10 = $1.00 / EUR1.00. A euro is not a dollar: the 402 body carries one entry per currency in `prices`, and the amount charged follows the stablecoin you pay with, resolved server-side from the token address. Read the per-currency price from GET /grid/metadata `pricing.pricePerPixelByCurrency`. All read endpoints (/stats, /grid/metadata, /tiles/*, /pixels/owned/*) are public and require no authentication. ## Operations Base URL: https://api.402milly.xyz | Method | Path | operationId | Payment | Summary | |---|---|---|---|---| | POST | `/purchase` | `purchasePixels` | x402 | Purchase pixels on the grid | | POST | `/upload` | `uploadImage` | none | Get a presigned form to upload the pixel image to S3 | | GET | `/stats` | `getStats` | none | Get marketplace statistics | | GET | `/grid/metadata` | `getGridMetadata` | none | Get grid metadata | | GET | `/tiles/{tileX}/{tileY}/pixels` | `getTilePixels` | none | Get pixels for a specific tile | | POST | `/tiles/batch` | `getTilesBatch` | none | Get pixels for multiple tiles in parallel | | GET | `/pixels/{purchaseId}` | `getPixelById` | none | Get one pixel block by its purchase ID | | GET | `/pixels/owned/{walletAddress}` | `getPixelsByOwner` | none | Get pixels owned by a wallet address |