{"uid":"cap_vD7lxmzI-V_GwC_k4Ihhc","slug":"api-acre-pixel-claim-0ffef178","name":"API Acre Pixel Claim","description":"Claim atomically reserved pixels or multi-colour blocks with optional public notes and sponsored HTTPS links, covering up to API Acre's full 1,250 x 800 exact-million advertising grid. Each pixel costs exactly 1 USDC; the pixel_count query parameter sets the x402 amount. Create the free reservation first at POST /pixel-acre/reservations.","url":"https://apiacre.com/v1/advertising/pixel-claim","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pixel_count":{"type":"integer"},"rules_version":{"type":"string"},"reservation_token":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"bounds":"example","status":1,"gridUrl":"example","linkPolicy":"example","pixelCount":"example","statusPath":"example","rulesVersion":"example","reservationId":"example","totalPriceUsdc":"example","pricePerPixelUsdc":"example"},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[]},"service":"advertising.pixel-claim","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$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_rJ8DEyDwBsKO6wg4SypSW","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":"Atomically claims reserved pixels on a one-million-pixel advertising grid, associating an optional public note and sponsored HTTPS link, at exactly 1 USDC per pixel.","exampleAgentPrompt":"Claim 100 pixels on the API Acre advertising grid using my reservation token 'abc123XYZ_exampletoken0000000000000000000' — I want to lock in my ad spot.","exampleUseCases":[{"title":"Brand launch pixel ad purchase","prompt":"I just created a reservation on API Acre and got a token — now I want to claim 250 pixels to display my startup's logo and link to our homepage. The reservation token is 'myToken123ABCDEFGHIJKLMNOPQRSTUVWXYZ12345' and I want to use rules version v1.0.0-2024-01."},{"title":"Bulk pixel block acquisition for campaign","prompt":"I'm running a marketing campaign and need to claim 1000 pixels on the API Acre grid. I have my reservation token 'campaignTkn00000000000000000000000000000000' ready — go ahead and finalize the claim."},{"title":"Minimal single-pixel placement","prompt":"Claim just 1 pixel on the API Acre million-pixel grid using reservation token 'singlePixelRes0000000000000000000000000000' to test that my integration works end-to-end."}],"resultDescription":"Returns a JSON object with the claimed pixel bounds on the grid, claim status code, a URL to view the grid, the link policy for the ad, pixel count, a status polling path, the rules version applied, reservation ID, total price in USDC, and price per pixel in USDC, plus request metadata including warnings and suggested next actions.","failureModes":["Invalid or expired reservation_token returns an auth/token error","pixel_count exceeds 1,000,000 or is less than 1 returns a validation error","rules_version format mismatch (not 10-32 chars) returns a schema validation error","Attempting to claim already-claimed pixels returns a conflict error","Insufficient USDC payment (x402 payment short by pixel count) results in payment rejection","Missing reservation_token results in a missing required field error"],"whenToPreferThis":"Use this endpoint when you have already created a pixel reservation via POST /pixel-acre/reservations and hold a valid 43-character reservation token, and now need to atomically finalize and pay for the pixel claim on the API Acre advertising grid. This is the payment and commitment step, not the initial reservation step. Choose this over generic ad-placement APIs when you specifically want on-chain USDC-denominated pixel advertising on the API Acre million-pixel grid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:41:28.687Z","isFirstParty":false}