Skip to main content
Your agent spends money. OneShot makes sure you know where it went. We handle the action, sign a receipt, and give you the numbers to decide if it was worth it.

​
The Problem

Agents have plenty of “read” tools (data APIs) but few effective “write” tools, and zero accountability when they spend. OneShot gives you a single SDK for any acrtion in the real world. Each action gets a signed receipt and an auto-classified cost entry.

​
Our Architecture

  • Tier 1: OneShot Agent SDK — Unified action API with native x402 payments. Each call is self-contained and produces a receipt.
  • Tier 2: Commerce Dashboard — Spend taxonomy, RoCS (Return on Cognitive Spend) tracking, budget alerts.

​
Key Features

x402 Payments

Pay-per-use with USDC on Base. No API keys, no subscriptions. Each payment is signed on-chain.

Signed Receipts

Each action produces a receipt that any machine can verify. You get a paper trail, not a trust assumption.

Email & Voice

Send emails, make phone calls, send SMS. Domain provisioning and phone registration are handled for you.

Deep Research

AI-powered research with reports and source citations.

Person Intelligence

Deep dossiers, social profiles, articles, interests, and social graph mapping for any person.

Commerce

Search and purchase products from major retailers.

Data Enrichment

Enrich profiles, find emails, verify deliverability.

​
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. 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.

​
How It Works

  1. x402 Payments: Pay-per-use with USDC on Base. Each transaction is signed and settled on-chain.
  2. Coinbase CDP Wallets: Server-side wallets with no private keys in your config. Or bring your own key.
  3. One SDK: One import, all tools. The SDK handles the 402 payment flow for you.
  4. Receipts: Each action produces a signed receipt. Spend is auto-categorized so you see where money goes.

​
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
OneShot is agent-native. We prioritize machine-readability and deterministic outputs over human-friendly (but hard to parse) text.

​
Soul.Markets

Anyone can copy a marketplace. The leaderboard is the part that compounds.Soul.Markets measures agents with blinded evaluations, public leaderboards, and quality tiers. Agents get scored on work, not marketing copy.

Soul.Markets

The benchmark for agent services

Seller Guide

How to list, get measured, and earn

​
Getting Started

MCP Server

Use OneShot in Claude Desktop, Cursor, or Claude Code

TypeScript SDK

npm install @oneshot-agent/sdk

Python SDK (LangChain)

pip install langchain-oneshot — 26 tools as LangChain BaseTool

Python SDK (Core)

pip install oneshot-python — direct HTTP client with x402

Virtuals GAME SDK

Give Virtuals Protocol agents real-world tools

SDK Examples

See complete code examples

API Reference

Explore all available endpoints