How pricing works OneShot uses the x402 Payment Required protocol. Every API call is paid individually with USDC on Base. No API keys, no subscriptions.
Your agent makes a request
OneShot responds with 402 Payment Required and a price
Your agent signs a USDC payment (or the SDK auto-swaps ETH to USDC)
The request executes
Payment methods Method Currency How it works x402 (USDC) USDC on Base Direct payment, default for SDK agents x402 (ETH) ETH on Base Auto-swapped to USDC via Uniswap V3. Set currency: 'ETH' in the SDK Stripe ACP USD For LLM agents (e.g. ChatGPT) paying via Stripe SharedPaymentTokens
The SDK handles x402 payments automatically. Fund your wallet with USDC or ETH. For Stripe ACP, see the
Stripe ACP docs .
API pricing All prices are in USD (USDC) per request.
Endpoint Price Unit Research $0.01 per query People Discovery $0.01 per search Email Enrichment $0.005 per lookup Profile Enrichment $0.005 per profile Email Verification $0.001 per email Email Quote $0.002 per quote Email Send dynamic see below Email Inbox free - Voice Call dynamic see below SMS Send dynamic see below SMS Inbox free - Deep Research Person $0.05 per person Social Profiles $0.01 per lookup Article Search $0.01 per search Person Newsfeed $0.01 per profile Person Interests $0.01 per person Person Interactions $0.01 per profile Web Search $0.001 per query Web Read $0.002 per URL Commerce Search $0.002 per query Commerce Buy dynamic see below Build dynamic see below Update Build dynamic see below Browser dynamic see below Compute dynamic see below
Quote-based pricing Some operations have variable costs. 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 (one-time, pass-through from registrar) Service fee (1st recipient) $0.10 Each additional recipient +$0.001
Verified domain (subsequent sends): Component Cost Service fee (1st recipient) $0.005 Each additional recipient +$0.001
Bulk examples (verified domain): Recipients Service Fee 1 $0.005 10 $0.014 100 $0.104 1,000 $1.004
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 by duration and whether you need a dedicated phone number.
Component Cost Analysis pipeline $0.01 Phone registration $5.00 (first call only) Call time $0.35/minute
Conference calls (multiple participants) use a shared OneShot number, so there is no phone registration fee.
If a call fails its objective (success_evaluation = “fail”), you are charged at provider cost and credited the difference.
SMS Send SMS pricing is per message segment per recipient.
Component Cost Per segment per recipient $0.0035
Segment sizing:
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.0035 ”Your order shipped” (18 chars) 10 1 $0.035 Long message (200 chars, GSM-7) 1 2 $0.007 Message with emoji (100 chars) 3 2 $0.021
Reading your SMS inbox is free. No payment required for inbox list or get endpoints.
Commerce Buy Commerce purchases include the product price, shipping, tax, and a service fee. The base API fee is $0.00. You only pay the quoted total.
Build Build creates websites with hosting, SSL, CDN, and stock images from Unsplash.
Component Cost Base price (3 sections) $1.00 Extra sections $0.50 each Lead capture form $0.50 Source URL analysis $0.50
Example builds: Build Type Sections Add-ons Total Portfolio 3 None $1.00 SaaS landing page 5 Lead capture $2.50 Full marketing site 7 Lead capture, source analysis $5.50
Updates to existing builds cost less. Store your request_id to iterate.
Browser Autonomous browser sessions for navigating websites, filling forms, and extracting data.
Component Cost Minimum per session $0.005 Per step $0.0006
Compute (Orchestrator) Compute goals deposit a budget upfront. The orchestrator draws from it as it calls tools. Unused budget is tracked in your ledger.
Component Cost Budget deposit LLM-estimated (varies by objective complexity) Tool calls Deducted at standard pricing above Soul hiring Soul service price
The orchestrator estimates a budget before you pay. Check the
Budget endpoint for remaining funds after execution.
Getting started
Fund your wallet Get USDC or ETH on Base and start making API calls.
SDK auto-payments The SDK handles x402 payments automatically.
Rate limits View API rate limits per endpoint type.
