Skip to main content
GET
/
v1
/
analytics
/
rocs
curl "https://win.oneshotagent.com/v1/analytics/rocs?period=30" \
  -H "X-Agent-ID: 0xYourWalletAddress"

{
  "rocs": 2.4,
  "total_spend": "10.000000",
  "total_value": "24.000000",
  "period_days": 30
}
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.

​
Query Parameters

​
period
number
default:"30"
Period in days (1–365)
curl "https://win.oneshotagent.com/v1/analytics/rocs?period=30" \
  -H "X-Agent-ID: 0xYourWalletAddress"

{
  "rocs": 2.4,
  "total_spend": "10.000000",
  "total_value": "24.000000",
  "period_days": 30
}