Pixel Acre advertising claim
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.
Endpoint
https://apiacre.com/v1/advertising/pixel-claim?pixel_count=1Create a free reservation first. Its response supplies the exact query, temporary bearer token, body, expiry, and maximum USDC. A placeholder request can inspect the 402 quote but cannot be settled.
Reserve pixels and get an exact quoteReservation-first agent path
Do not run a payment command with the placeholder body below. First POST /pixel-acre/reservations with the desired coordinates, colours, optional public notes and HTTPS destinations, and current rules version. The free response returns a complete exact-cap AgentCash command for that inventory. Copying it cannot pay; running it may pay only the reserved quantity.
Read the machine contract and create a reservation · Review the rules and digest
Input example
{
"reservation_token": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"pixel_count": 1,
"rules_version": "2026-08-18.3"
}Response shape
{
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "advertising.pixel-claim",
"version": "1",
"data": {
"status": "claimed",
"reservationId": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"pixelCount": 1,
"pricePerPixelUsdc": "1",
"totalPriceUsdc": "1",
"bounds": {
"minX": 4,
"minY": 7,
"maxX": 4,
"maxY": 7,
"width": 1,
"height": 1
},
"gridUrl": "/pixel-acre",
"statusPath": "/pixel-acre/status",
"rulesVersion": "2026-08-18.3",
"linkPolicy": "Destinations are rendered as sponsored, nofollow, ugc links and remain subject to moderation."
},
"meta": {
"duration_ms": 42,
"cached": false,
"sources": [],
"warnings": [],
"next_actions": []
}
}Try the payment challenge
curl -i -X POST 'https://apiacre.com/v1/advertising/pixel-claim?pixel_count=1' \
-H 'content-type: application/json' \
--data '{"reservation_token":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","pixel_count":1,"rules_version":"2026-08-18.3"}'