---
title: "Get wallet spend and token usage summary"
method: GET
path: "/wallets/stats"
---

# Get wallet spend and token usage summary

`GET /wallets/stats`

## Request

- Base URL: `https://getsanction.com/api/v1`
- URL: `https://getsanction.com/api/v1/wallets/stats`
- Auth: API key in header `x-api-key`

Returns today and month-to-date token cost, real-money spend, and count of pending approvals for a wallet. ?scope=subtree (management key only) rolls the numbers up across every pool beneath the wallet.

## Query parameters

- `wallet_id` string
- `scope` 'wallet' | 'subtree'

## Response `200`

Wallet stats

- WalletStatsResponse
  - `today` object
    - `token_cost_usd` number
    - `tokens_in` integer
    - `tokens_out` integer
    - `spend_usd` number
    - `spend_budget_usd` number, nullable
    - `projected_spend_usd` number, nullable: Linear end-of-day projection; null while the day is too young to extrapolate.
    - `will_exhaust` boolean
    - `exhaust_at` string, date-time, nullable
  - `month` object
    - `decisions` integer: Fresh engine decisions rendered this month across the scope (spend, tool, capability, provision — approve/escalate/deny alike; replays and grant redemptions never count).
    - `token_cost_usd` number
    - `spend_usd` number
    - `spend_budget_usd` number, nullable
    - `projected_spend_usd` number, nullable: Linear month-end projection; null early in the month.
    - `will_exhaust` boolean
    - `exhaust_at` string, date-time, nullable
  - `pending_approvals` integer

---

[API](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api.md) · [All operations](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/revisions/c645a9e4b72d?raw)