Agent Wallets

Agent wallet expense stats

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.

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)

Query parameters

applicationIdstring uuid required
agentIdstring uuid
ownerIdstring uuid
sincestring date-time
Example:2026-08-30T00:00:00.000Z

Start of a rolling window ending now (RFC 3339), at most 366 days back. Omit for the current calendar month (UTC).

Response

monthstring required

Start of the window the stats cover: since when given, otherwise the first instant of the current month (UTC).

currencystring required

Display currency of the amounts: the app preferred currency (ISO 4217), or "USDC" when the rate oracle is unavailable.

fiatAvailableboolean required

False when amounts fell back to USDC (oracle unavailable).

totalSpentRefstring 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.

txCountinteger required

Number of successful outgoing transfers counted in the total.

averageTicketRefstring 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.

excludedAssetsstring[] 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)".

Example response

{
  "month": "2026-06-01T00:00:00.000Z",
  "currency": "EUR",
  "fiatAvailable": true,
  "totalSpentRef": "11875000",
  "txCount": 42,
  "averageTicketRef": "283000"
}

Changes

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