---
title: "Agent wallet expense stats"
method: GET
path: "/v1/agent-wallets/expenses/stats"
tags: ["Agent Wallets"]
---

# Agent wallet expense stats

`GET /v1/agent-wallets/expenses/stats`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/agent-wallets/expenses/stats`
- Auth: one of:
  - API key in header `X-Api-Key`
  - `bearer` (a scheme the document does not define)

Spend summary across an application's agent wallets: the current calendar month, or the rolling window starting at `since`. Only the canonical USDC contract is counted; other assets are listed in `excludedAssets`.

## Query parameters

- `applicationId` string, uuid, required
- `agentId` string, uuid
- `ownerId` string, uuid
- `since` string, date-time

## Response `200`

- AgentWalletExpenseStatsDto
  - `month` string, required: Start of the window the stats cover: `since` when given, otherwise the first instant of the current month (UTC).
  - `currency` string, required: Display currency of the amounts: the app preferred currency (ISO 4217), or "USDC" when the rate oracle is unavailable.
  - `fiatAvailable` boolean, required: False when amounts fell back to USDC (oracle unavailable).
  - `totalSpentRef` string, required: Total outgoing this month. Unit depends on `fiatAvailable`: centi-units of the display currency when true (divide by 100); USDC base units (10^6) when false (divide by 10^6). Do not change one consumer path without the other.
  - `txCount` integer, required: Number of successful outgoing transfers counted in the total.
  - `averageTicketRef` string, required: totalSpentRef / txCount (integer division), same unit as totalSpentRef. Unit depends on `fiatAvailable`: centi-units of the display currency when true (divide by 100); USDC base units (10^6) when false (divide by 10^6). Do not change one consumer path without the other.
  - `excludedAssets` string[], required: Outgoing assets left out of the total: anything but the canonical USDC contract, native coin included. A token is labelled with its symbol and abbreviated contract address, e.g. "USDC (0x6c94…d28c)".

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)