Documentation Index
Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
Use this file to discover all available pages before exploring further.
Every tool execution generates a receipt — a transaction record with category, cost breakdown, optional value attribution, and the audit context (memo + decisionContext) the caller attached at call time. Receipts power spend tracking, RoCS computation, and supervisor-agent oversight.
Authentication
All analytics endpoints require the X-Agent-ID header with your wallet address. No x402 payment needed — these are free read endpoints (the value tag endpoint is also free).
-H "X-Agent-ID: 0xYourWalletAddress"
Endpoints
| Method | Path | Description |
|---|
GET | /v1/analytics/receipts | List receipts with filters |
GET | /v1/analytics/spend/breakdown | Spend by category |
GET | /v1/analytics/rocs | Return on Cognitive Spend |
PATCH | /v1/analytics/receipts/{receiptId}/value | Tag receipt value |
Receipt Categories
| Category | Tools | Description |
|---|
data | research, browser, analyze, enrich | Information gathering |
verification | verify_email | Data validation |
communication | email, voice, sms | Outbound messaging |
commerce | commerce_search, commerce_buy | Purchases |
infrastructure | build | Website/app creation |
agent_to_agent | soul | Inter-agent transactions |
Receipt Statuses
| Status | Meaning |
|---|
pending | Execution started, payment not yet settled |
settled | Payment verified on-chain (has settlement_tx) |
failed | Execution or payment failed |
disputed | Under review |
Return on Cognitive Spend (RoCS)
RoCS = total_value / total_spend
status: "confirmed" count toward total_value. Self-reported tags start as "pending" and must be validated by the judge service before they affect RoCS.
