OneShot Agent

Add real-world actions to your existing agent. Keep your model, framework, and hosting. OneShot gives you research, email, voice, web, and commerce tools through one SDK, with payments handled behind each call.

​

How OneShot Fits

Call OneShot from your agent, application, or background worker. Your code decides when to act and what to do with the result. SDK tool calls don’t require a OneShot runtime. Start with one action. Add more through the same client as your workflow grows.

​

Guaranteed Execution

Our promise: your action gets done. OneShot takes responsibility for executing accepted actions through completion, including provider failures, error recovery, and retries. Your agent chooses the action and uses the result; OneShot owns getting it done. The execution guarantee is a service commitment. Requests must have valid inputs, required permissions, and sufficient funding, and execution must respect your spending limits. Completion means carrying out the requested tool action—for example, sending an email—not guaranteeing that its recipient replies. The current API still exposes failed jobs and error codes; a failed response is not proof of completion. For an unresolved execution, retain the request ID and contact OneShot support so the action can be investigated. See job status for the current response contract. This commitment does not change the API’s existing status values or make it safe to blindly repeat actions that may already have executed.

​

Key Features

​

How It Works

1. Call from your code: Choose a tool and pass its inputs through the SDK.
2. Guaranteed execution: OneShot owns execution, error recovery, and retries through completion. The SDK handles quotes, payment, and job polling. Wallet sessions sign payments in USDC on Base. Access-token sessions use available credits without wallet signing.
3. Continue your workflow: Use the result in your next step. Keep your agent’s logic in your existing stack.

Use a Coinbase CDP wallet or bring your own key. Follow the quickstart to connect and fund your wallet.

​

BTW, Each Paid Action Comes With a Record

You also get receipts and spend tracking alongside the tools. Inspect what an action cost, attribute it to an agent, and verify the signed record. Set daily and per-call budgets when you need spending limits. See spend budgets to configure limits and audit context to attach the reason for a call.

​

Philosophy

OneShot is designed for one-shot interactions:

• Each API call is independent and self-funded
• Minimal context required
• Clean, deterministic responses
• A receipt for each action taken

​

Choose Your Integration

​

Machine-readable spec

The full API surface is published as an OpenAPI 3.1 specification — 82 operations across 19 tag groups, regenerated on every deploy from the same Zod schemas the server uses at runtime.

• Spec: https://win.oneshotagent.com/openapi.json
• Interactive docs: https://win.oneshotagent.com/docs

Use it to generate clients, register with API directories, or import directly into Postman, Insomnia, ChatGPT actions, or Claude / OpenAI assistants. See the OpenAPI Specification page for SDK generation examples.

​

Soul.Markets