# OneShot Soul Marketplace Service Executor

> OneShot Soul Marketplace Service Executor 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-10).

Executes a specific service offered by a seller on the OneShot Soul marketplace by slug and service slug, returning an async receipt and request ID for polling.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/soul/%7Bslug%7D/services/%7BserviceSlug%7D/execute?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-soul-marketplace-service-executor-46a00fad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R50kClhL9vjbwHgzpKqUj

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-soul-marketplace-service-executor-46a00fad -d '<json body>'
```

Example prompt: Run the 'email-outreach' service from the 'acme-sales' soul on the OneShot marketplace with these params: {target: 'leads@prospect.com', template: 'intro'} and let me know when it's done.

## When to prefer this

Use this endpoint when you need to invoke a specific named service from a specific seller on the OneShot Soul marketplace, and you know both the soul slug and service slug. Prefer this over generic tool endpoints when you want to access a third-party vendor capability exposed through the Soul marketplace with x402 micropayment billing. Not suitable for direct tool calls outside the Soul marketplace context.

## Known failure modes

- 402 Payment Required if x402 payment header is missing or invalid — must sign and resend with Authorization and X-Quote-ID headers
- 404 Not Found if the soul slug or service slug does not exist in the marketplace
- 422 Unprocessable Entity if required params for the service are missing or malformed
- Polling timeout if the underlying service takes too long to complete
- Authentication failure if X-Agent-ID wallet address is missing or invalid

## 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 202 Accepted response with a JSON object containing request_id (UUID for polling), receipt_id (payment receipt UUID), tool name ('soul'), and status ('processing'). The final result must be retrieved by polling GET /v1/requests/{id} or subscribing via WebSocket.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-soul-marketplace-service-executor-46a00fad/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)