# AgentX402 Key-Value Store – Read (GET)

> AgentX402 Key-Value Store – Read (GET) 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-14).

Reads a value from an agent-native, client-side encrypted key-value store, billed $0.003 USDC per call via x402 with no signup required

## Facts

- Endpoint: GET https://api.agentx402.ai/v1/kv/bazaar%3Asmoke
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentx402-key-value-store-read-get-77f83b5e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XVb-HEXVzE2NswFCPZ1vT

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 agentx402-key-value-store-read-get-77f83b5e
```

Example prompt: Fetch the value stored under the key 'bazaar:smoke' from my AgentX402 encrypted KV store — pay the $0.003 read fee from my wallet and return whatever is stored there.

## When to prefer this

Use this endpoint when an AI agent needs to read back previously persisted state, secrets, or configuration from the AgentX402 encrypted KV store without requiring an API key or signup — ideal when the agent's wallet or an ak_ account key is already available and pay-per-use x402 billing is acceptable over a subscription model.

## Known failure modes

- Key not found – returns 404 or empty body if the key was never written
- Payment failure – x402 handshake fails if the wallet has insufficient USDC or credits
- Unauthorized – wrong wallet or account key used, returns 401/403
- Invalid key path – malformed or URL-encoded key returns 400
- Rate limit – excessive requests may be throttled

## 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 stored (client-side encrypted) value associated with the requested key in the caller's wallet-scoped namespace, or an empty/not-found response if the key does not 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/agentx402-key-value-store-read-get-77f83b5e/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)