# SpawnXchange Item Acquire

> SpawnXchange Item Acquire is a paid API for AI agents from spawnxchange.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Purchases and acquires a specific AI-built software item from the SpawnXchange marketplace, returning a signed invoice and download URL.

## Facts

- Endpoint: POST https://spawnxchange.com/api/v1/items/%7Buuid%7D/acquire
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spawnxchange-item-acquire-a7ac3cb3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oOSjsBXbDnVbzSfw2uAZg

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 spawnxchange-item-acquire-a7ac3cb3 -d '<json body>'
```

Example prompt: Buy the AI-built code item with UUID 3f2a1b4c-0000-4000-8000-abcdef012345 on SpawnXchange using USDC on the Base network — I accept the policy and license terms.

## When to prefer this

Use this endpoint when an agent needs to programmatically purchase and immediately download a specific AI-built software artifact from SpawnXchange by its UUID, paying with USDC on Base or Polygon. Prefer this over manual marketplace browsing when automation, CI/CD integration, or agent-driven procurement is needed. This is the correct endpoint when you have already identified the item (by UUID, e.g. via search) and need to complete the transaction.

## Known failure modes

- Invalid or non-existent item UUID returns 404 not found
- policy_accepted or license_accepted set to false or missing causes validation error
- Unsupported chain or currency enum value causes 400 bad request
- Payment failure or insufficient USDC balance causes payment error
- Signed URLs expire after 15 minutes, requiring a new purchase call
- Network (Base/Polygon) unavailability may cause timeout or 503

## How this service works

Agentic-first marketplace for reusable AI-built software.

## Output

Returns a JSON object with a unique order_id (UUID), an expiry window (15 minutes), a signed invoice_url pointing to a Google Cloud Storage invoice document, and a signed download_url pointing to the purchasable software package archive — both URLs are time-limited.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "polygon"
   ],
   "type": "string"
  },
  "currency": {
   "enum": [
    "USDC",
    "usdc"
   ],
   "type": "string"
  },
  "policy_accepted": {
   "type": "boolean",
   "const": true
  },
  "license_accepted": {
   "type": "boolean",
   "const": true
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "order_id": "00000000-0000-4000-8000-000000000000",
  "expires_in": "15 minutes",
  "invoice_url": "https://storage.googleapis.com/…signed-invoice-url…",
  "download_url": "https://storage.googleapis.com/…signed-package-url…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spawnxchange-item-acquire-a7ac3cb3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from spawnxchange.com](https://www.zero.xyz/host/spawnxchange.com/llms.txt)
