{"uid":"cap_DesxoKIrkwaV7AkUcpXof","slug":"agent402-tools-memory-read-9772d1b4","name":"agent402.tools Memory Read","description":"Persistent key-value memory scoped to the paying wallet: the x402 payment is the authentication, the wallet owns the namespace. Write any JSON value (up to 64KB) under a key, with an optional TTL, or delete it; read it back on any later session with the matching read route. Use it when an agent needs state that survives the session or crosses runs without an account or API key.","url":"https://agent402.tools/api/memory","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-09-14T19:14:04.384Z","isFirstParty":false}