{"uid":"cap_AVv48flz3tPKZ9jQT9Ksg","slug":"oneshot-agent-api-benchmark-tool-95fdabce","name":"OneShot Agent API – Benchmark Tool","description":"Tools, payments, and compute orchestration for autonomous AI agents.\n\n## Authentication\n\n- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).\n  First call returns `402 Payment Required` with a quote; sign and resend the request\n  with `payment-signature: <base64 x402 payment>` and `X-Quote-ID: <quote_id>`.\n- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).\n- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`\n  (issued by `POST /v1/soul/register`).\n- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the\n  `API-Version: 2026-01-30` header.\n\n## Async tools & polling\n\nMost tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll\n`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.\nA WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.\n\n## Pricing\n\nSee [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full\ntable. Per-call prices for this environment:\n\n| Tool | Cost |\n|---|---|\n| Web search | $0.001 |\n| Web read | $0.002 |\n| Research | $0.01 |\n| Person profile | $0.005 |\n| Person email status | $0.001 |\n| Person dossier | $0.10 |\n| Person social accounts | $0.50 |\n| Business search | $0.01 |\n| Commerce search | $0.002 |\n| LinkedIn history sync | $0.02 per bounded run |\n| LinkedIn reply | $0.02 per message |\n| LinkedIn message to a connection | $0.02 per message |\n| LinkedIn profile view | $0.01 per view |\n| LinkedIn post reaction | $0.01 per reaction |\n| Email send | quote-based; service fee from $0.005 per send |\n| SMS send | $0.0035 per segment per recipient |\n| Voice call | $0.35/minute + $5.00 number registration on the first call |\n| Browser task | quote-based; minimum $0.005 |\n| Website build | quote-based; from $1.00 |\n| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |\n\n## Error format\n\n`{ \"error\": \"<machine_code>\", \"message\": \"<human readable>\", \"details\": <optional> }`.\nValidation errors include a `details` field with the failing field paths.","url":"https://win.oneshotagent.com/v1/tools/benchmark?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"key":{"type":"string","description":"Entity key of an entity in the peer set, to place its value. Give at most one of key and value"},"field":{"type":"string","description":"Numeric field to compare, one the data tool declares for Benchmark, e.g. total"},"peers":{"type":"object","description":"Filters that define the peer set: fields the data tool declares for grouping, e.g. {\"model_year\": 2019}"},"value":{"type":"number","description":"A value to place in the distribution. Give at most one of key and value"},"source":{"type":"string","description":"Source to read when the attribute has several"},"attribute":{"type":"string","description":"Name of a data tool whose facts can be benchmarked, e.g. vehicle_complaints"}}},"responseSchema":{"type":"json","example":{"max":311,"min":0,"p25":6,"p75":52.5,"as_of":"2026-09-30T12:00:00.000Z","count":42,"field":"total","peers":{"model_year":2019},"value":37,"median":19,"source":null,"coverage":"Vehicles sold in the United States","attribute":"vehicle_complaints","percentile":66.67,"population":"looked_up","population_detail":{"scope":null,"state":null,"reason":"the peers are only entities that someone has looked up","dataset":null,"published_at":null,"source_version":null,"historical_start":null}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WlxkwRv5-f-1BqJYei-5e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes percentile rankings and distribution statistics for a named data attribute, placing a key entity or numeric value within a filtered peer set.","exampleAgentPrompt":"How does a 2019 Toyota Camry with 37 total vehicle complaints rank among all 2019 model-year vehicles in the U.S.? Give me its percentile, median, and the p25/p75 range for that peer group.","exampleUseCases":[{"title":"Vehicle complaint percentile ranking","prompt":"I'm looking at a 2019 sedan that has 37 reported complaints — how does that compare to other 2019 vehicles in the U.S.? What percentile is it in, and what's the median complaint count for that year?"},{"title":"Entity benchmark by lookup key","prompt":"Look up where the Ford F-150 2019 sits in the distribution of total vehicle complaints for its model year — I want to see its percentile, the p25, p75, and the max in that peer group."},{"title":"Custom value placement in distribution","prompt":"If a vehicle had 100 complaints, what percentile would that put it in among all 2019 model-year vehicles in the U.S.? Show me the full distribution — min, max, median, and quartiles."}],"resultDescription":"Returns a JSON object containing the percentile of the queried entity or value within its peer set, along with full distribution statistics: min, max, median, p25, p75, count, coverage description, as-of date, the field and attribute benchmarked, and the peer filters applied.","failureModes":["Invalid attribute name returns an error — only attributes declared as supporting Benchmark are valid","Unknown entity key returns null or error if the key doesn't exist in the dataset","Missing both key and value causes a validation error — exactly one must be provided","Providing both key and value simultaneously is rejected","Peer filter fields not supported by the data tool cause an error","Unsupported field name for the chosen attribute returns an error","Payment failure via x402 (insufficient USDC balance) blocks the call before execution"],"whenToPreferThis":"Use this endpoint when you need to understand where a specific entity or raw value sits within a distribution of peers — e.g. ranking a vehicle, company, or data point against a filtered cohort. Prefer it over raw data lookups when the goal is comparative context (percentile, quartiles) rather than absolute values. It is uniquely suited for agentic workflows that require benchmarking without a separate analytics backend, paid per-call in USDC with no API key required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:37:55.810Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-benchmark-tool-95fdabce"}