OneShot Agent API
externalTools, payments, and compute orchestration for autonomous AI agents. ## Authentication - **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io). First call returns `402 Payment Required` with a quote; sign and resend the request with `Authorization: <signed payment header>` and `X-Quote-ID: <quote_id>`. - **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address). - **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…` (issued by `POST /v1/soul/register`). - **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the `API-Version: 2026-01-30` header. ## Async tools & polling Most tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll `GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result. A WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`. ## Pricing See [docs.oneshotagent.com/pricing]
Price
from $0.0010
up to $0.5000 per request
Network
base
Category
ai
On-chain txns
1,092
Uptime
100%
Avg latency
641ms
Checks
81
Status
Healthy
Base URL
Endpoints (32)
Discovered from on-chain x402 payment activity. Prices shown are per-call in USDC.
Compute orchestrator - autonomous multi-step goal execution
Execute a Soul marketplace service
AI browser automation - quote-based pricing
Build a website
Purchase a product
Product search across e-commerce
Send email with provisioned domain
Company enrichment from domain, name, LinkedIn URL, or ticker
Email enrichment and validation
Profile enrichment from LinkedIn URL
Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought and Presolicitation notices with the contracting officer's published contact. Flat price per search.
Send a LinkedIn invitation. Requires the invite grant and Idempotency-Key.
Withdraw a tracked LinkedIn invitation. Requires the invite grant and Idempotency-Key.
View a LinkedIn profile through a human-connected account that granted `view_profile`, returning a public-safe summary (name, headline, location, network distance). `notify: true` shows the human as having viewed the profile (cannot be undone). Flat price; per-account daily cap (default 100).
React to a LinkedIn post through a human-connected account that granted `react` (like, celebrate, support, love, insightful, funny). Flat price; per-account daily cap (default 50). Re-sending the same reaction is idempotent upstream.
Send a reply in an existing LinkedIn conversation through a human-connected account that granted `reply`. Flat price per message. Requires an Idempotency-Key header. Per-account daily cap (default 50) shared across all callers, randomized spacing; a message LinkedIn accepted cannot be recalled.
Resolve a local business name + address to its website domain, phone, category, and operating status with a match confidence
Local business discovery by category and location (restaurants, contractors, practices). Flat price per search.
Deep web research on any topic
Find articles written by or mentioning a person
Company search and discovery
Get a person's social interactions — followers, following, and replies
Analyze a person's interests and topics from their digital footprint
Get recent social media posts from a person
People and contact discovery
Deep person research — returns enrichment, social profiles, articles, and dossier
Discover social media profiles for a person by email or URL
Web search returning URLs, titles, and descriptions
Send SMS message
Email deliverability verification
AI voice call - quote-based pricing
Read a web page and extract content as markdown with screenshot
Payment
How to call
# one-time setup
npx @apihubio/cli register
npx @apihubio/cli topup 10
# call it
npx @apihubio/cli call https://win.oneshotagent.com \
-X POST \
-d '{ /* check provider docs for input */ }'
# or save it to Claude/Cursor/Codex
npx @apihubio/cli install
npx @apihubio/cli add https://win.oneshotagent.comVia direct x402 (advanced)Bring your own wallet
import { wrapFetchWithPayment } from "@x402/fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
const account = privateKeyToAccount("0xYOUR_PRIVATE_KEY");
const client = createWalletClient({ account, chain: base, transport: http() });
const x402Fetch = wrapFetchWithPayment(client);
const res = await x402Fetch("https://win.oneshotagent.com", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ /* check provider docs for input */ }),
});
const data = await res.json();This is an external service not operated by APIHub. Listing data is sourced from public on-chain records and third-party indexes. Payment goes directly to the service provider via the x402 protocol. APIHub does not guarantee availability, accuracy, or quality of external services.