# API Acre Pixel Claim

> API Acre Pixel Claim is a paid API for AI agents from apiacre.com, paid per call via x402, $1/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: POST https://apiacre.com/v1/advertising/pixel-claim
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-acre-pixel-claim-0ffef178
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vD7lxmzI-V_GwC_k4Ihhc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-acre-pixel-claim-0ffef178 -d '<json body>'
```

Example prompt: Claim 100 pixels on the API Acre advertising grid using my reservation token 'abc123XYZ_exampletoken0000000000000000000' — I want to lock in my ad spot.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pixel_count": {
   "type": "integer"
  },
  "rules_version": {
   "type": "string"
  },
  "reservation_token": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-acre-pixel-claim-0ffef178/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)