budget

Get spending history

Returns paginated spend history from the ledger for the authenticated account. Entries are returned newest-first. Use before for cursor-based pagination. Amounts are in atomic USDC units (1,000,000 = 1.00 USDC).

get/v1/budget/history

Request

Base URL: https://agentlair.dev
URL: https://agentlair.dev/v1/budget/history
Auth: HTTP bearer

Query parameters

limitinteger

Number of entries to return (default 50, max 200)

beforestring date-time

ISO timestamp cursor for pagination — returns entries before this timestamp

Response

Spending history

agent_idstring

currencystring

atomic_unitstring

notestring

Example response

{
  "currency": "USDC",
  "atomic_unit": "1e-6 USDC (one millionth of one USDC)"
}

Changes

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