# Read Account Balance, Ledger, and Dreaming Audit

> Read Account Balance, Ledger, and Dreaming Audit is a paid API for AI agents from memory.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-14, last successful call 2026-07-29).

Returns the current prepaid USDC balance, full transaction ledger, and a dreaming/maintenance audit log for the authenticated agent memory account.

## Facts

- Endpoint: GET https://memory.withzero.xyz/api/v1/account
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-07-29
- Success rate: 100% of calls made through Zero
- Activations on Zero: 5
- Provider: memory.withzero.xyz
- Website: https://memory.withzero.xyz
- Canonical page: https://www.zero.xyz/c/memory-withzero-xyz-read-account-balance-ledger-and-dreaming-audit-c126a607
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OZlzJ1FGHuETUa1kzgWe5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability memory-withzero-xyz-read-account-balance-ledger-and-dreaming-audit-c126a607
```

Example prompt: Show me my current memory.withzero.xyz account balance, the full ledger of deposits and debits, and what the last dreaming maintenance cycle did — how many memories were consolidated, decayed, or flagged as contradictions.

## When to prefer this

Use this endpoint when an agent needs to check its remaining USDC balance before writing new memories, audit past charges to understand cost drivers, or inspect what the automated dreaming/consolidation lifecycle has done — particularly to diagnose why certain memories were merged, decayed, or flagged as contradictory. Prefer this over external billing dashboards since it provides memory-system-specific maintenance telemetry alongside financial data.

## Known failure modes

- Unauthorized (401/403) if authentication credentials are missing or invalid
- Account not found if no account has been created yet
- Empty ledger array if no transactions have occurred
- maintenance.last_run_at is null if dreaming has not yet run
- Service unavailable (503) if the memory backend is temporarily down

## How this service works

Read balance + ledger + dreaming audit.

## Output

Returns a JSON object containing: the account owner identifier, current balance in micros (USDC), an array of ledger entries each with a kind (deposit/debit), signed amount_micros, and created_at timestamp, plus a maintenance object summarizing the last dreaming lifecycle run — including consolidations_made, contradicts_edges_found, memories_decayed, and last_run_at.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "owner",
  "balance_micros",
  "ledger",
  "maintenance"
 ],
 "properties": {
  "owner": {
   "type": "string"
  },
  "ledger": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "kind",
     "amount_micros",
     "created_at"
    ],
    "properties": {
     "kind": {
      "type": "string"
     },
     "created_at": {
      "type": "string"
     },
     "amount_micros": {
      "type": "string",
      "description": "Signed: + deposit, − debit/withdrawal."
     }
    },
    "additionalProperties": false
   }
  },
  "maintenance": {
   "type": "object",
   "required": [
    "consolidations_made",
    "contradicts_edges_found",
    "memories_decayed",
    "last_run_at"
   ],
   "properties": {
    "last_run_at": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "memories_decayed": {
     "type": "number"
    },
    "consolidations_made": {
     "type": "number"
    },
    "contradicts_edges_found": {
     "type": "number"
    }
   },
   "description": "What the server-managed dreaming lifecycle last did for this owner — the value behind the LLM debits.",
   "additionalProperties": false
  },
  "balance_micros": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/memory-withzero-xyz-read-account-balance-ledger-and-dreaming-audit-c126a607/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from memory.withzero.xyz](https://www.zero.xyz/host/memory.withzero.xyz/llms.txt)