Back to Browse
OneShot Agent Commerce Buy
x402
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
Price / call$0.001
Success—
StatusUnknown
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}.
Example use cases
Agent auto-reorders low inventory
“We're running low on office supplies — go buy 10 units of this stapler from https://officesupplystore.com/products/heavy-duty-stapler and send me the receipt.”
Gift purchase on behalf of user
“Buy 1 of these as a gift from https://giftshop.com/products/custom-mug — just one unit, and let me know the receipt ID once the order is placed.”
Automated dropship order fulfillment
“A customer just ordered, so please purchase 1 unit of https://supplier.com/products/bluetooth-speaker now to fulfill it — I need the receipt and request ID to track it.”
Technical details
Endpoint
POSThttps://win.oneshotagent.com/v1/tools/commerce/buy?utm_source=zero.xyzWhen to prefer
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.
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| quantity | number | |
| product_url | string |
Output
Schema · Response
{
"type": "json",
"example": {
"tool": "commerce",
"status": "processing",
"receipt_id": "rcpt_uuid",
"request_id": "uuid"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"