{"uid":"cap_hsBUurNK8Yy4r2kA4Dvyl","slug":"agentkv-encrypted-key-value-read-get-9c84cbb3","name":"AgentKV – Encrypted Key-Value Read (GET)","description":"Agent-native encrypted key-value store, paid per request over x402 — no signup, no API key. The payer's wallet (or an ak_ account key) is the namespace; values are client-side encrypted. Write $0.005, read $0.003; prepay $1 = 10,000 credits at 1/10 the per-op price (POST /v1/credits/deposit). SDK: npm i @agentkv/client. Docs: https://agentx402.ai","url":"https://api.agentx402.ai/v1/kv/final-1785132418","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_s4681OkFZiYm-64UXKnXr","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 from an agent-native, client-side encrypted key-value store using a wallet-scoped namespace, billed per request via x402 micropayment.","exampleAgentPrompt":"Read the value stored under the key 'final-1785132418' in my AgentKV store — use my wallet as the namespace and charge the $0.003 read fee.","exampleUseCases":[{"title":"Retrieve agent session state","prompt":"Fetch the session state my agent stored under key 'session-abc123' in AgentKV so I can resume where it left off."},{"title":"Read stored API credential","prompt":"Get the encrypted API credential my agent saved in AgentKV under key 'openai-key' for my wallet namespace."},{"title":"Load persisted user preferences","prompt":"Pull the user preferences stored in AgentKV under key 'prefs-user42' so my agent knows how to respond to this user."}],"resultDescription":"Returns the stored value associated with the key path in the URL (e.g. /v1/kv/final-1785132418). The value was previously written by the agent and is client-side encrypted, so the response contains the encrypted payload which the client decrypts locally. On success, a 200 response with the value is returned; the $0.003 USDC read fee is charged via x402 micropayment.","failureModes":["Key not found (404) — the specified key does not exist in the wallet-scoped namespace","Insufficient credits or payment failure — x402 payment rejected, no credits or wallet balance","Unauthorized namespace — wrong wallet or ak_ key used to access a key owned by a different namespace","Malformed request — invalid key path format or unsupported HTTP method","Service unavailable — API temporarily down (5xx)"],"whenToPreferThis":"Choose this endpoint when your AI agent needs to retrieve previously stored state, secrets, or configuration without any signup or API key — especially when operating in a wallet-native or x402-payment environment. It is ideal for stateless agents that need persistent memory between sessions, or for sharing encrypted data across agent instances scoped to the same wallet. Prefer it over traditional KV stores when the agent already handles x402 micropayments and requires client-side encryption by default.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:45:22.188Z","isFirstParty":false}