How Pricing Works
OneShot uses the x402 Payment Required protocol. Every API call is paid for individually with USDC on Base — no API keys, no subscriptions, no monthly bills.
- Your agent makes a request
- OneShot responds with
402 Payment Required and a price
- Your agent signs a USDC payment
- The request executes
The SDK handles this entire flow automatically. You just fund your wallet and call the API.
API Pricing
All prices are in USD (USDC) per request.
| Endpoint | Price | Unit |
|---|
| Research | $0.10 | per query |
| People Discovery | $0.10 | per search |
| Email Enrichment | $0.05 | per lookup |
| Profile Enrichment | $0.05 | per profile |
| Email Verification | $0.01 | per email |
| Email Quote | $0.02 | per quote |
| Email Send | dynamic | see below |
| Email Inbox | free | - |
| Voice Call | dynamic | see below |
| SMS Send | dynamic | see below |
| SMS Inbox | free | - |
| Commerce Search | $0.02 | per query |
| Commerce Buy | dynamic | see below |
| Build | dynamic | see below |
| Update Build | dynamic | see below |
Quote-Based Pricing
Some operations have variable costs. These use a quote flow — you request a quote, review the price, then authorize payment.
Email Send
Email pricing depends on whether you already have a verified sender domain.
New domain (first send):
| Component | Cost |
|---|
| Domain registration | ~$15.00 (one-time, from registrar) |
| Service fee (1st recipient) | $1.00 |
| Each additional recipient | +$0.01 |
| Component | Cost |
|---|
| Service fee (1st recipient) | $0.01 |
| Each additional recipient | +$0.001 |
| Recipients | Service Fee |
|---|
| 1 | $0.01 |
| 10 | $0.019 |
| 100 | $0.109 |
| 1,000 | $1.009 |
The quote endpoint returns an exact cost breakdown before you commit. Domain registration is a one-time fee — once verified, you only pay the service fee. Maximum 500 recipients per request.
Voice Call
Voice calls are priced based on duration and whether you need a dedicated phone number.
| Component | Cost |
|---|
| Analysis pipeline | $0.10 |
| Phone registration | $5.00 (first call only) |
| Call time | ~$0.35/minute |
If a call fails to achieve its objective (success_evaluation = “fail”), you’re charged at cost and credited the margin.
SMS Send
SMS pricing is based on message segments and recipient count.
| Component | Cost |
|---|
| Per segment per recipient | $0.035 |
- Standard characters (GSM-7): 160 characters per segment
- Unicode/emoji: 70 characters per segment
Examples:
| Message | Recipients | Segments | Total |
|---|
| ”Your order shipped” (18 chars) | 1 | 1 | $0.035 |
| ”Your order shipped” (18 chars) | 10 | 1 | $0.35 |
| Long message (200 chars, GSM-7) | 1 | 2 | $0.07 |
| Message with emoji (100 chars) | 3 | 2 | $0.21 |
Reading your SMS inbox is free — no payment required for inbox list or get endpoints.
Commerce Buy
Commerce purchases include:
- Product price: The actual item cost
- Shipping & tax: Calculated at checkout
- Service fee: 5% margin on the transaction
- The base API fee is $0.00 — you only pay the quoted total
Build
Build creates fully-functional, production-ready websites with real hosting infrastructure. Base price includes deployment, SSL, CDN, and high-quality stock images from Unsplash:
| Component | Cost |
|---|
| Base price (3 sections) | $10.00 |
| Extra sections | $5.00 each |
| Lead capture form | $5.00 |
| Source URL analysis | $5.00 |
| Custom domain | $10.00 |
| Build Type | Sections | Add-ons | Total |
|---|
| Portfolio | 3 | None | $10 |
| SaaS landing page | 5 | Lead capture | $25 |
| Full marketing site | 7 | Lead capture, source analysis | $40 |
Updates to existing builds are significantly discounted. Store your request_id to iterate on your builds.
Development & Testing
| Environment | Network | Pricing |
|---|
| Development | Base Sepolia (testnet) | Free — all endpoints $0.00 |
| Staging | Base Sepolia (testnet) | $0.01 per endpoint |
| Production | Base (mainnet) | Full pricing above |
The SDK runs in development mode by default, so you can build and test without spending real USDC.
Getting Started
