Shroud

An agent's inference spend since 00:00 UTC

What the agent has spent today per the vault's priced activity rows, plus requests and tokens and how many requests Shroud blocked for budget. Shroud syncs its daily-budget counter from this so daily_budget_usd holds across Shroud instances and restarts. Callable by the agent itself (its own id) or the platform service key — the same gate as activity ingest.

get/v1/shroud/activity/today

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/shroud/activity/today
  • Auth: HTTP bearer

Query parameters

agent_idstring uuid required

Response

Today's spend

agent_idstring uuid
daystring
cost_usdnumber
requestsinteger
tokensinteger
blocked_by_budgetinteger

Example response

{
  "day": "2026-09-21"
}

Changes

No recorded changes to this operation across all 1 revision of this API.