OneShot SDK Overview

​

What is the OneShot SDK?

• Automatic x402 Payments: Signs and submits payment authorizations automatically
• Pay with ETH or USDC: Hold ETH and the SDK auto-swaps to USDC via Uniswap V3 at payment time
• Flexible Wallets: Coinbase CDP Server Wallets (recommended, no private keys) or raw private key via ethers.js
• Job Polling: Waits for async jobs to complete
• Type Safety: Full TypeScript support with proper types

​

Why Use the SDK?

​

For Humans

// Without SDK: Handle 402 responses, sign payments, poll jobs manually
// With SDK: One line
await agent.email({ to: "[email protected]", subject: "Hi", body: "Hello" });

​

For AI Agents

• No manual payment flow handling
• Automatic retry logic for rate limits
• Clean error messages
• Minimal token usage in prompts

​

Quick Example

import { OneShot } from "@oneshot-agent/sdk";

// Coinbase CDP Server Wallet — no private key needed
// Reads CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET from env
const agent = await OneShot.create({ cdp: true });

// Send email (handles quote + payment + send automatically)
await agent.email({
  to: "[email protected]",
  subject: "Hello from OneShot",
  body: "This was sent autonomously!",
});

import { OneShot } from "@oneshot-agent/sdk";

// Raw private key — existing behavior
const agent = new OneShot({
  privateKey: process.env.AGENT_PRIVATE_KEY,
});

// Deep research
const report = await agent.research({
  topic: "Latest AI agent frameworks",
  depth: "comprehensive",
});

console.log(report.report_content);

​

Key Features

​

Supported Tools

​

All SDKs and Packages

​

Next Steps