# Agent Memory Key-Value Store — Read/List Keys

> Agent Memory Key-Value Store — Read/List Keys is a paid API for AI agents from x402-services-production.up.railway.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Reads a value or lists all keys in a namespaced, token-protected key-value memory store for AI agents

## Facts

- Endpoint: POST https://x402-services-production.up.railway.app/api/memory/get
- 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/agent-memory-key-value-store-read-list-keys-e5d6e8f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vFrVNDOxxFHnD-Klv1HB6

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 agent-memory-key-value-store-read-list-keys-e5d6e8f4 -d '<json body>'
```

Example prompt: Read the value stored under the key 'last_trade_result' in my namespace 'agent-alpha' using my secret token — or if no key is specified, just list all the keys in that namespace.

## When to prefer this

Use this endpoint when an AI agent needs to retrieve previously stored state, cached data, or configuration values from a persistent namespaced key-value store — especially in agentic workflows where memory continuity across sessions or steps is required.

## Known failure modes

- Invalid or missing token returns 401 unauthorized
- Namespace not found returns empty result or error
- Key does not exist returns null or not-found response
- Malformed request body (missing required fields) returns 400 bad request

## How this service works

Agent Memory: read a stored value by key, or omit key to list all keys in your namespace. Send { ns, token, key? }.

## Output

Returns the stored value associated with the given key in the specified namespace, or if no key is provided, returns a list of all keys present in that namespace.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ns",
  "token"
 ],
 "properties": {
  "ns": {
   "type": "string",
   "description": "Your namespace"
  },
  "key": {
   "type": "string",
   "description": "Key to read; omit to list keys"
  },
  "token": {
   "type": "string",
   "description": "Your secret token"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-memory-key-value-store-read-list-keys-e5d6e8f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-services-production.up.railway.app](https://www.zero.xyz/host/x402-services-production.up.railway.app/llms.txt)