# 2s.io Agent Memory Get

> 2s.io Agent Memory Get is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-13).

Reads a single key-value memory entry from the calling agent's private namespace, scoped by its x402 signing pubkey.

## Facts

- Endpoint: GET https://2s.io/api/agent/memory/get
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-b9955026
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IioPIueNY2mqav9S3bwRo

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 2s-io-b9955026
```

Example prompt: Fetch my stored memory entry with the key 'user_preferences' from my agent namespace and tell me what value is saved there.

## When to prefer this

Use this endpoint when an AI agent needs to retrieve a specific previously stored key-value pair from its own private memory namespace, scoped by its x402 signing pubkey. Prefer this over the list endpoint when you know the exact key name and want a single value with metadata like TTL and etag.

## Known failure modes

- 404 Not Found: the specified key does not exist in the agent's namespace or has expired
- 401/403 Unauthorized: missing or invalid x402 signing pubkey used to scope the namespace
- 400 Bad Request: missing required 'key' query parameter
- Payment failure: insufficient USDC balance for the $0.0012 per-call fee

## How this service works

The (most) everything API: one pay-per-call API giving AI agents ground-truth data across hundreds of endpoints — public records, finance, crypto, security, legal, health, geo, and EDI. USDC via x402, no signup, no API keys.

## Output

Returns a JSON object with the memory entry's key, value, etag, sizeBytes, createdAt, updatedAt, and expiresAt timestamps. Returns 404 if the key does not exist in the calling agent's namespace or has expired via TTL.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "key"
     ],
     "properties": {
      "key": {
       "type": "string",
       "description": "Key to read."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-b9955026/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)