{"uid":"cap_t7giCBduHKdNXy-sZ8cQr","slug":"21millionpixels-art-paint-pixel-81f7ae25","name":"21millionpixels.art Paint Pixel","description":"Paint one pixel on 21millionpixels.art, a shared 21,000,000-pixel canvas. Reads are free; paid pixels skip the human cooldown.","url":"https://21millionpixels.art/api/agent/paint","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"x":{"type":"integer","maximum":4999,"minimum":0,"description":"column, 0 at the left"},"y":{"type":"integer","maximum":4199,"minimum":0,"description":"row, 0 at the top"},"color":{"type":"integer","maximum":108,"minimum":0,"description":"palette index; 1-32 for everyone, 33-108 for wallets that own a plot, 0 clears the tile. GET /api/info lists the hex values and which indices are retired"},"username":{"type":"string","pattern":"^[a-z0-9_-]+$","maxLength":20,"minLength":3,"description":"optional; the name this wallet paints under"}}},"responseSchema":{"type":"json","example":{"x":2500,"y":2100,"ok":true,"plot":105250,"color":3,"payer":"0x857b06519e91e3a54538791bdbb0e22373e36b66","paidTo":"0xdD666CDCf2BCcff8D1C8161ed24FF26c0ed429b9","changed":true,"settled":true,"version":1234,"username":"my-agent","plotOwned":false,"transaction":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2Lfgcj-lM_L3vNQ2hpxRi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Paints a single pixel at specified coordinates with a given color on a shared 21-million-pixel Bitcoin-themed canvas, deducting a micropayment to skip the cooldown timer.","exampleAgentPrompt":"Paint a red pixel at coordinates x=2500, y=2100 on the 21millionpixels canvas under the username 'my-agent'.","exampleUseCases":[{"title":"Agent claims canvas territory","prompt":"Paint a blue pixel at x=1000, y=500 on the 21millionpixels.art canvas and label it with username 'bot-colony'."},{"title":"Automated pixel art pattern","prompt":"Place a green pixel at x=300, y=700 on the 21millionpixels canvas as part of my pattern — use username 'pixel-painter'."},{"title":"Bitcoin-themed commemorative pixel","prompt":"Mark the 21 million pixel canvas at coordinates x=21000, y=1000 with an orange pixel to celebrate the Bitcoin halving, under username 'satoshi-fan'."}],"resultDescription":"Returns a JSON object confirming the painted pixel, including its x/y coordinates, plot index, color value, payer wallet address, recipient address, whether the pixel actually changed (changed: true/false), whether payment settled, current canvas version number, the username used, whether the caller owns that plot, and the on-chain transaction hash.","failureModes":["Invalid coordinates outside the 21,000,000-pixel canvas bounds return an error","Payment failure or insufficient USDC balance prevents pixel from being placed","Color value out of supported range returns a validation error","Duplicate pixel paint at same location with same color returns changed: false","Network or blockchain settlement delays may cause settled: false in response","Invalid or missing username may cause request rejection"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to autonomously place pixels on the 21millionpixels.art collaborative canvas without waiting for the human cooldown timer. It is the only paid API path for this specific canvas, making it ideal for bots, automated art generation, or agents marking territory programmatically. Use it when micropayment-gated pixel placement with on-chain settlement confirmation is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:22.549Z","isFirstParty":false}