{"uid":"cap_6jhm8TUh_VzjRrxP-Ti-L","slug":"agentkv-read-key-get-0a8e8a2a","name":"AgentKV – Read Key (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/canary-kv-1785218442","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_7iy9B85ehkq0lp7ulSy3N","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 an encrypted value from the AgentKV key-value store at a specific key path, billed per request via x402 micropayment with no signup required.","exampleAgentPrompt":"Read the value stored at key 'canary-kv-1785218442' in my AgentKV namespace and return its decrypted contents.","exampleUseCases":[{"title":"Retrieve agent configuration at runtime","prompt":"Pull the config blob I stored in AgentKV under the key 'agent-config-prod' so I can initialize today's run."},{"title":"Load persistent agent memory","prompt":"Fetch the value stored at key 'session-memory-user-42' in my AgentKV store — I need to resume from where the last conversation left off."},{"title":"Check stored secret or credential","prompt":"Read the encrypted value I saved at 'api-creds-openai' in AgentKV and give me the decrypted content."}],"resultDescription":"Returns the decrypted value stored at the specified key in the caller's AgentKV namespace. If the key exists, the response contains the stored payload (object, string, or blob). If the key does not exist, a 404-equivalent response is returned. Billing of $0.003 USDC is deducted via x402 on each successful read.","failureModes":["Key not found (404) — no value exists at that path in the namespace","Insufficient credits or payment failure — x402 payment rejected, read blocked","Unauthorized namespace access — wallet or ak_ key does not match namespace","Decryption failure — client-side key mismatch or corrupted value","Rate limiting — too many requests in a short window","Network/server error — 5xx response from api.agentx402.ai"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to retrieve a previously stored encrypted value without any account signup or API key, billing only for what it reads. It is ideal for stateless agents that persist memory, secrets, or configuration keyed to a wallet address across sessions. Prefer this over traditional KV stores when the agent operates in a trustless, pay-per-use environment and namespace isolation by wallet is desirable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:29.413Z","isFirstParty":false}