# 2s.io Agent Memory List

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

Lists keys in the calling agent's memory namespace with cursor pagination, returning metadata only (key, etag, size, timestamps) newest-first.

## Facts

- Endpoint: GET https://2s.io/api/agent/memory/list
- Price: $0.001200/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Success rate: 0% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-c2b2d293
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f_SuOzBAh6Umgm3opd-zc

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-c2b2d293
```

Example prompt: Show me all the keys currently saved in my agent memory namespace, filtering to ones that start with 'session_', and give me up to 50 per page.

## When to prefer this

Use this endpoint when an agent needs to enumerate or discover what keys exist in its own memory namespace before deciding which entries to fetch, delete, or update. Prefer this over agent.memory.get when you don't know the exact key name and need to search or browse by prefix.

## Known failure modes

- Invalid cursor returns 400 bad request
- limit out of range (1-100) returns 400
- Unauthorized if x402 signing key does not match namespace
- Empty result set with no nextCursor when namespace has no keys or prefix matches nothing
- Network timeout on large namespaces

## 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 paginated list of memory key metadata objects (key name, etag, sizeBytes, createdAt, updatedAt) sorted newest-first, plus a nextCursor string to fetch the next page. Does not return the stored values themselves — use agent.memory.get for values.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 50,
   "prefix": "session_"
  }
 }
}
```

## 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": {
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max items per page (1-100). Default 25."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque cursor from previous response."
      },
      "prefix": {
       "type": "string",
       "description": "Optional key prefix filter."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-c2b2d293/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)