# OneShot Agent Commerce Buy

> OneShot Agent Commerce Buy is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Purchases a product from a URL on behalf of an AI agent, initiating a commerce transaction and returning a receipt

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/commerce/buy?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-commerce-buy-0a3f43a5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gljaIpry0mSUPFqQ4s_qJ

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 oneshot-agent-commerce-buy-0a3f43a5 -d '<json body>'
```

Example prompt: Go ahead and buy 2 units of this product for me: https://www.example-store.com/products/wireless-headphones — handle the purchase and give me the receipt ID when it's done.

## When to prefer this

Use this endpoint when an AI agent needs to autonomously purchase a product from an e-commerce URL without human checkout interaction. Prefer this over search-only or browse endpoints when you have a specific product URL and quantity ready. It is the right choice when you need a receipt and async tracking of a fulfilled order, and when you are prepared to handle x402 micropayment authentication.

## Known failure modes

- Invalid or unreachable product_url returns an error
- Quantity of 0 or negative may be rejected
- Payment 402 must be handled before the purchase proceeds — unsigned or missing payment header causes rejection
- Product out of stock or unavailable at the target URL
- Async job may fail after 202 acceptance — poll /v1/requests/{id} to detect final failure
- Unsupported retailer or region may result in a failed fulfillment

## How this service works

Tools, payments, and compute orchestration for autonomous AI agents.

## Authentication

- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).
  First call returns `402 Payment Required` with a quote; sign and resend the request
  with `Authorization: <signed payment header>` and `X-Quote-ID: <quote_id>`.
- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).
- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`
  (issued by `POST /v1/soul/register`).
- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the
  `API-Version: 2026-01-30` header.

## Async tools & polling

Most tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll
`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.
A WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.

## Pricing

See [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full
table. Per-call costs for this environment, rendered from the same config the routes bill from:

| Tool | Cost |
|---|---|
| Web search | $0.001 |
| Web read | $0.002 |
| Research | $0.01 |
| Person enrichment | $0.005 |
| Email verification | $0.001 |
| Deep research (person) | $0.05 |
| Social profiles | $0.50 |
| Local business search | $0.01 |
| Commerce search | $0.002 |
| LinkedIn history sync | $0.02 per bounded run |
| LinkedIn reply | $0.02 per message |
| LinkedIn profile view | $0.01 per view |
| LinkedIn post reaction | $0.01 per reaction |
| Email send | quote-based; service fee from $0.005 per send |
| SMS send | $0.0035 per segment per recipient |
| Voice call | $0.35/minute + $5.00 number registration on the first call |
| Browser task | quote-based; minimum $0.005 |
| Website build | quote-based; from $1.00 |
| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |

## Error format

`{ "error": "<machine_code>", "message": "<human readable>", "details": <optional> }`.
Validation errors include a `details` field with the failing field paths.

## Output

Returns a JSON object with the tool name ('commerce'), processing status, a unique receipt_id for the transaction, and a request_id for polling the async result via GET /v1/requests/{id}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "quantity": {
   "type": "number"
  },
  "product_url": {
   "type": "string",
   "format": "uri"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "commerce",
  "status": "processing",
  "receipt_id": "rcpt_uuid",
  "request_id": "uuid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-commerce-buy-0a3f43a5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)