{"uid":"cap_R50kClhL9vjbwHgzpKqUj","slug":"oneshot-soul-marketplace-service-executor-46a00fad","name":"OneShot Soul Marketplace Service Executor","description":"Tools, payments, and compute orchestration for autonomous AI agents.\n\n## Authentication\n\n- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).\n  First call returns `402 Payment Required` with a quote; sign and resend the request\n  with `Authorization: <signed payment header>` and `X-Quote-ID: <quote_id>`.\n- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).\n- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`\n  (issued by `POST /v1/soul/register`).\n- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the\n  `API-Version: 2026-01-30` header.\n\n## Async tools & polling\n\nMost tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll\n`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.\nA WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.\n\n## Pricing\n\nSee [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full\ntable. Per-call costs for this environment, rendered from the same config the routes bill from:\n\n| Tool | Cost |\n|---|---|\n| Web search | $0.001 |\n| Web read | $0.002 |\n| Research | $0.01 |\n| Person enrichment | $0.005 |\n| Email verification | $0.001 |\n| Deep research (person) | $0.05 |\n| Social profiles | $0.50 |\n| Local business search | $0.01 |\n| Commerce search | $0.002 |\n| LinkedIn history sync | $0.02 per bounded run |\n| LinkedIn reply | $0.02 per message |\n| LinkedIn profile view | $0.01 per view |\n| LinkedIn post reaction | $0.01 per reaction |\n| Email send | quote-based; service fee from $0.005 per send |\n| SMS send | $0.0035 per segment per recipient |\n| Voice call | $0.35/minute + $5.00 number registration on the first call |\n| Browser task | quote-based; minimum $0.005 |\n| Website build | quote-based; from $1.00 |\n| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |\n\n## Error format\n\n`{ \"error\": \"<machine_code>\", \"message\": \"<human readable>\", \"details\": <optional> }`.\nValidation errors include a `details` field with the failing field paths.","url":"https://win.oneshotagent.com/v1/soul/%7Bslug%7D/services/%7BserviceSlug%7D/execute?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object"}}},"responseSchema":{"type":"json","example":{"tool":"soul","status":"processing","receipt_id":"rcpt_uuid","request_id":"uuid"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oPdh1WWU_alge2F3cOrR9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Automate lead enrichment via soul vendor","prompt":"Use the 'lead-enrich' service from the 'dataforge' soul on OneShot to enrich this list of contacts with job titles and company info — pass these params: {contacts: ['john@corp.com', 'jane@startup.io']}."},{"title":"Trigger custom AI research task","prompt":"Execute the 'deep-market-research' service from the 'researchbot' soul with params {topic: 'EV battery startups in Europe', depth: 'comprehensive'} and poll for the result when it's ready."},{"title":"Run automated content generation via marketplace","prompt":"Invoke the 'blog-draft' service on the 'contentforge' soul marketplace seller with params {topic: 'AI agents in finance', tone: 'professional', length: 800} and give me the output once it's complete."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:47.095Z","isFirstParty":false,"canonicalSlug":"oneshot-soul-marketplace-service-executor-46a00fad"}