{"uid":"cap_vFrVNDOxxFHnD-Klv1HB6","slug":"agent-memory-key-value-store-read-list-keys-e5d6e8f4","name":"Agent Memory Key-Value Store — Read/List Keys","description":"Agent Memory: read a stored value by key, or omit key to list all keys in your namespace. Send { ns, token, key? }.","url":"https://x402-services-production.up.railway.app/api/memory/get","method":"POST","headers":{},"bodySchema":{"type":"object","required":["ns","token"],"properties":{"ns":{"type":"string","description":"Your namespace"},"key":{"type":"string","description":"Key to read; omit to list keys"},"token":{"type":"string","description":"Your secret token"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jUf8SkSxzjdQwarbz7_V9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads a value or lists all keys in a namespaced, token-protected key-value memory store for AI agents","exampleAgentPrompt":"Read the value stored under the key 'last_trade_result' in my namespace 'agent-alpha' using my secret token — or if no key is specified, just list all the keys in that namespace.","exampleUseCases":[{"title":"Retrieve cached trading signal","prompt":"Fetch the value stored under the key 'eth_signal_20240601' in my namespace 'trading-bot' using my token — I want to check what signal we cached earlier before placing the next trade."},{"title":"List all saved agent state keys","prompt":"List every key stored in my namespace 'defi-agent-session' so I can see what state data my agent has saved so far — use my secret token to authenticate."},{"title":"Restore agent context after restart","prompt":"Pull the value for the key 'last_portfolio_snapshot' from my namespace 'portfolio-tracker' using my secret token so I can restore where the agent left off."}],"resultDescription":"Returns the stored value associated with the given key in the specified namespace, or if no key is provided, returns a list of all keys present in that namespace.","failureModes":["Invalid or missing token returns 401 unauthorized","Namespace not found returns empty result or error","Key does not exist returns null or not-found response","Malformed request body (missing required fields) returns 400 bad request"],"whenToPreferThis":"Use this endpoint when an AI agent needs to retrieve previously stored state, cached data, or configuration values from a persistent namespaced key-value store — especially in agentic workflows where memory continuity across sessions or steps is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:53:56.369Z","isFirstParty":false}