{"uid":"cap_MWrXlqVO4GyGQKNMmB66t","slug":"agentkv-read-key-get-f58982f6","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-1785245249","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__SLJTulOyRxi_FD-8WIz2","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 and returns the client-side encrypted value stored under a specific key in the caller's wallet-namespaced key-value store, paid per request via x402.","exampleAgentPrompt":"Read the value stored under the key 'canary-kv-1785245249' in my AgentKV store and return whatever's there — pay the $0.003 read fee from my wallet.","exampleUseCases":[{"title":"Agent retrieves persisted session state","prompt":"Fetch the value stored under my 'session-context' key in AgentKV — I need my agent to pick up where it left off from the last run."},{"title":"Reading a stored API credential","prompt":"Look up the value I saved under 'openai-key' in my AgentKV namespace and use it to make the next call — my wallet will cover the read fee."},{"title":"Checking a cached computation result","prompt":"Check AgentKV for whatever I stored under 'price-snapshot-2024-06-01' — if it's there, use that value instead of re-fetching."}],"resultDescription":"Returns the stored (client-side encrypted) value associated with the requested key within the caller's wallet-namespaced store. The response includes the raw stored payload which the client SDK decrypts locally. If the key does not exist or the namespace does not match, an error response is returned. The $0.003 USDC fee is deducted via x402 payment on each successful call.","failureModes":["Key not found — returns 404 if the key has never been written or was deleted","Payment failure — x402 payment header missing, insufficient funds, or rejected wallet returns 402","Namespace mismatch — reading a key that belongs to a different wallet/account returns 403","Rate limiting or credit exhaustion — returns 429 or equivalent if credits are depleted","Malformed key path — invalid key name in URL returns 400"],"whenToPreferThis":"Use this endpoint when an AI agent needs to retrieve a previously stored, encrypted value from a persistent key-value store without requiring any signup or API key — authentication is handled entirely via the caller's crypto wallet or ak_ account key. Prefer AgentKV over generic KV APIs when you need agent-native x402 micropayment billing, client-side encryption by default, and wallet-scoped namespacing. Choose the GET (read) operation when you need to look up state, cached data, credentials, or configuration that was written in a prior session.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:42:46.663Z","isFirstParty":false}