{"uid":"cap_YhBy1FHaikq9Xi3RdHoQd","slug":"canvas-0000402-xyz-13229def","name":"Canvas Pixel Region Purchase","description":"Pay $0.01/pixel to buy a canvas region. Provide x1,y1,x2,y2 for a specific position or width+height for auto-placement. Minimum region: 10×10 pixels. Returns region_id and owner_token. Use owner_token to update content later for free. Network: Base Mainnet. Each request purchases one region and returns placement coordinates plus the owner token.","url":"https://canvas.0000402.xyz/buy?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"x1":{"type":"integer","description":"Left edge pixel, 0–1499. Example: a 10×10 block at top-left uses x1=0. Provide all four of x1,y1,x2,y2 for manual placement; omit all four to use auto-placement instead."},"x2":{"type":"integer","description":"Right edge pixel (exclusive), 10–1500. x2 = x1 + width. Example: a 10×10 block at top-left uses x2=10. Required together with x1,y1,y2 for manual placement."},"y1":{"type":"integer","description":"Top edge pixel, 0–1499. Example: a 10×10 block at top-left uses y1=0. Provide all four of x1,y1,x2,y2 for manual placement; omit all four to use auto-placement instead."},"y2":{"type":"integer","description":"Bottom edge pixel (exclusive), 10–1500. y2 = y1 + height. Example: a 10×10 block at top-left uses y2=10. Required together with x1,y1,x2 for manual placement."},"color":{"type":"string","description":"Hex color e.g. '#ff6b35'. Required."},"width":{"type":"integer","description":"Width in pixels for auto-placement (min 10). Only used when x1,y1,x2,y2 are all omitted. If manual coords are provided, omit width and height entirely."},"height":{"type":"integer","description":"Height in pixels for auto-placement (min 10). Only used when x1,y1,x2,y2 are all omitted. If manual coords are provided, omit width and height entirely."},"tooltip":{"type":"string","description":"Hover text shown on canvas (max 100 chars). Optional."},"link_url":{"type":"string","description":"Click-through URL (https:// only). Optional."}}},"responseSchema":{"type":"json","example":{"x1":0,"x2":100,"y1":0,"y2":100,"message":"Region painted. Store your owner_token — it is required to update content later.","region_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","price_paid":"$100.00","owner_token":"secret-uuid-store-this","pixel_count":10000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.00","reviews":1,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LXAPn3L7uhyBFcoTEPpSY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase a rectangular pixel region on a shared canvas by paying $0.01/pixel, returning a region ID and owner token for future content updates.","exampleAgentPrompt":"Buy me a 50x50 pixel region on the shared canvas starting at position x=100, y=200 — I want to own that spot and get the owner token so I can update it later.","exampleUseCases":[{"title":"Place a brand ad on canvas","prompt":"I want to put a small advertisement for my startup on the shared pixel canvas — grab me a 200x100 pixel region somewhere visible and make sure I get the owner token so I can swap out the creative later."},{"title":"Reserve pixels for a community mural","prompt":"Can you claim a 150x150 block on the collaborative canvas for our community art project? Auto-place it wherever there's open space and hold onto the owner token so we can upload our mural design afterward."},{"title":"Buy canvas space at exact coordinates","prompt":"Purchase a 10x10 pixel region at exactly x=50, y=50 on the shared canvas for me — I want that specific spot locked in and need the owner token to update what's displayed there whenever I want."}],"resultDescription":"Returns a region_id identifying the purchased canvas region, an owner_token for authenticating future free content updates, and the placement coordinates (x1, y1, x2, y2) where the region was placed on the canvas.","failureModes":["Insufficient USDC balance to cover pixel cost (payment failure)","Requested region already owned by another user (conflict)","Coordinates out of canvas bounds (validation error)","Region dimensions below minimum 10x10 pixel requirement","Auto-placement fails if no suitable space available on canvas","Network issues with Base Mainnet transaction"],"whenToPreferThis":"Use this endpoint when an agent needs to claim and own a specific or auto-placed rectangular region on the shared pixel canvas, particularly when the user wants persistent ownership (via owner_token) to update content later. Prefer over alternatives when the goal is to permanently reserve canvas space backed by a blockchain payment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-05-29T00:01:53.592Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:30:40.554Z","isFirstParty":false,"canonicalSlug":"canvas-0000402-xyz-13229def"}