{"uid":"cap_DesxoKIrkwaV7AkUcpXof","slug":"agent402-tools-memory-read-9772d1b4","name":"agent402.tools Memory Read","description":"Read from a wallet-scoped namespace.","url":"https://agent402.tools/api/memory?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"key":{"type":"string","description":"Key to read; omit to list all keys"},"owner":{"type":"string","description":"Optional 0x namespace to read (requires a grant)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["keys","owner","persistent"],"properties":{"keys":{"type":"array","items":{"type":"object","properties":{"k":{"type":"string"},"exp":{},"updated":{"type":"integer"}}}},"owner":{"type":"string"},"persistent":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"key":"research/task-42","bytes":42,"owner":"0x…","updated":1760000000000,"expiresAt":1760086400,"persistent":true}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"keys":[],"owner":"0x9cc42f3d9245b867acccd630b43f906c1665b176","persistent":false}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"1.00","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XWo1tRRqygali6trywAEo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Read a value by key (or list all keys) from a wallet-scoped persistent namespace, optionally reading a namespace you've been granted access to.","exampleAgentPrompt":"Retrieve the value stored under the key 'user_preferences' from my wallet namespace — or if I don't specify a key, just list all the keys I've stored.","exampleUseCases":null,"resultDescription":"If a key is provided, returns the stored value associated with that key in the wallet-scoped namespace. If no key is provided, returns a list of all stored keys in the namespace. If an owner address is provided, reads from that granted namespace instead.","failureModes":["Key not found — returns empty or 404-style response if the key does not exist in the namespace","Unauthorized access — attempting to read a namespace without a valid grant returns a permission error","Invalid owner address — malformed 0x address returns a validation error","Payment failure — insufficient USDC balance or x402 payment not processed results in a 402 error","Empty namespace — listing keys on a namespace with nothing stored returns an empty list"],"whenToPreferThis":"Use this endpoint when an agent needs to retrieve previously stored state or configuration from its wallet-scoped persistent memory. Prefer this over generic KV stores when the storage is already tied to the agent402 ecosystem and you need wallet-scoped access control with grant-based sharing between wallets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-18T00:22:28.599Z","lastSuccessfullyRanAt":"2026-07-18T00:22:28.599Z","lastHealthCheckAt":"2026-10-30T06:51:36.018Z","isFirstParty":false,"canonicalSlug":"agent402-tools-memory-read-9772d1b4"}