> ## 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.

# Return on Cognitive Spend

> Compute RoCS — value generated per dollar of cognitive spend

RoCS measures the value generated per dollar of cognitive spend.

```
RoCS = total_value / total_spend
```

Only value tags with `status: "confirmed"` count toward `total_value`. Self-reported tags start as `"pending"` and must be validated by the judge service before they affect RoCS — see [Tag Receipt Value](/api-reference/analytics/value).

## Query Parameters

<ParamField query="period" type="number" default="30">
  Period in days (1–365)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://win.oneshotagent.com/v1/analytics/rocs?period=30" \
    -H "X-Agent-ID: 0xYourWalletAddress"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "rocs": 2.4,
    "total_spend": "10.000000",
    "total_value": "24.000000",
    "period_days": 30
  }
  ```
</ResponseExample>