# AgentKV Encrypted Key-Value Read (v3 Verify)

> AgentKV Encrypted Key-Value Read (v3 Verify) is a paid API for AI agents from api.agentx402.ai, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Reads (GET) a stored encrypted key-value entry from the agent-native AgentKV store using the x402 micropayment protocol, specifically at the v3/verify path

## Facts

- Endpoint: GET https://api.agentx402.ai/v1/kv/u3%3Averify
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentkv-encrypted-key-value-read-v3-verify-a95fa728
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fUrhDW4UCc--kbNI2XgkF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentkv-encrypted-key-value-read-v3-verify-a95fa728
```

Example prompt: Can you fetch the value I stored under the 'u3:verify' key in my AgentKV encrypted store — use my wallet as the namespace and pay the $0.003 read fee automatically.

## When to prefer this

Choose this endpoint when an AI agent needs to retrieve previously stored persistent state, configuration, or memory without any prior signup or API key management. Ideal for agent workflows that use the x402 micropayment protocol natively and need per-request-billed encrypted storage namespaced to a wallet identity. Prefer over traditional KV stores when the agent already holds a wallet or ak_ account key and wants zero-friction, pay-as-you-go read access.

## Known failure modes

- Key not found — returns 404 if the key has never been written or has expired
- Insufficient credits — returns 402 Payment Required if the wallet/account has no balance and no valid x402 payment header
- Invalid namespace — returns 403 if the wallet address or ak_ key is malformed or unauthorized
- Decryption failure — client-side issue if the wrong key is used to decrypt the returned ciphertext
- Network timeout — transient 503 if the backing store is temporarily unavailable

## How this service works

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

## Output

Returns the encrypted value stored at the requested key path within the caller's wallet-namespaced partition of the AgentKV store. The value is client-side encrypted and must be decrypted locally. Response includes the stored payload or a not-found indicator if the key doesn't exist.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentkv-encrypted-key-value-read-v3-verify-a95fa728/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentx402.ai](https://www.zero.xyz/host/api.agentx402.ai/llms.txt)