{"uid":"cap_OZlzJ1FGHuETUa1kzgWe5","slug":"memory-withzero-xyz-read-account-balance-ledger-and-dreaming-audit-c126a607","name":"Read Account Balance, Ledger, and Dreaming Audit","description":"Read balance + ledger + dreaming audit.","url":"https://memory.withzero.xyz/api/v1/account","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_OcnmDSBscueR97PrYzCLT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"memory.account:1"}],"brandName":"memory.withzero.xyz","brandSlug":"memory-withzero-xyz-mpp","brandBaseUrl":"https://memory.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns the current prepaid USDC balance, full transaction ledger, and a dreaming/maintenance audit log for the authenticated agent memory account.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Check remaining memory credit balance","prompt":"How much USDC credit do I have left in my agent memory account, and am I running low enough that I should top it up before writing more memories?"},{"title":"Audit past memory storage charges","prompt":"Pull up the full ledger of deposits and debits on my memory account so I can see exactly what's been charged and figure out what's driving my costs."},{"title":"Inspect last dreaming maintenance run","prompt":"What did the dreaming maintenance cycle do on its last run — how many memories got consolidated or decayed, and were any flagged as contradictions?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-07-29T00:21:24.681Z","lastSuccessfullyRanAt":"2026-07-29T00:21:24.681Z","lastHealthCheckAt":"2026-09-14T00:41:15.791Z","isFirstParty":true}