---
title: "An agent's inference spend since 00:00 UTC"
method: GET
path: "/v1/shroud/activity/today"
tags: ["Shroud"]
---

# An agent's inference spend since 00:00 UTC

`GET /v1/shroud/activity/today`

## Request

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

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.

## Query parameters

- `agent_id` string, uuid, required

## Response `200`

Today's spend

- object
  - `agent_id` string, uuid
  - `day` string
  - `cost_usd` number
  - `requests` integer
  - `tokens` integer
  - `blocked_by_budget` integer

## Other responses

- `403`: Insufficient permissions

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)