Pixel Acre advertising claim
Claim an atomically reserved group of 1 to 10,000 coordinates on API Acre's one-million-pixel 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 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"
}Response shape
{
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "advertising.pixel-claim",
"version": "1",
"data": {
"status": 1,
"reservationId": "example",
"pixelCount": "example",
"pricePerPixelUsdc": "example",
"totalPriceUsdc": "example",
"bounds": "example",
"gridUrl": "example",
"statusPath": "example",
"rulesVersion": "example",
"linkPolicy": "example"
},
"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"}'