# Tabularium Key Read

> Tabularium Key Read is a paid API for AI agents from tabularium.matt-3e0.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-18).

Retrieves the latest value for a specified key in the paying wallet's private, hash-chained workspace, along with its chain entry metadata.

## Facts

- Endpoint: GET https://tabularium.matt-3e0.workers.dev/read?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tabularium-key-read-d8d348a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CH9oGmnjsm_wwO2gtL747

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 tabularium-key-read-d8d348a0
```

Example prompt: Fetch the latest value I stored under the key 'notes/today' from my Tabularium workspace, and include the chain entry so I can verify it.

## When to prefer this

Choose this endpoint when you need to read the current value of a specific key from a private, hash-chained workspace tied to a wallet identity, and you want the cryptographic chain entry alongside the value for auditability. It is the right choice when you know the exact key name and want point-in-time retrieval rather than a full workspace dump. Prefer this over the full history endpoint when you only need the latest value, not the complete write history.

## Known failure modes

- Key not found — returns an error if the specified key has never been written
- Invalid key format — key must match pattern ^[A-Za-z0-9._:/-]{1,128}$
- Payment failure — if the x402 micropayment of $0.002 USDC is not completed, access is denied
- Expired workspace — if the wallet's workspace subscription has lapsed, read may be rejected
- Unauthorized wallet — only the paying wallet's workspace is accessible

## How this service works

Agent memory: read the latest value for a key from the paying wallet's persistent key-value store, with its signed hash-chain entry. Reads keep working through the 90-day grace period after the term ends. A missing key returns 404 and is not charged.

## Output

Returns a JSON object containing: the key name, the latest stored value (as a string), the chain entry (including operation type, timestamp, sequence number, hash, previous hash, and value hash), the workspace state (e.g. 'active'), the wallet address that owns the workspace, and the workspace expiry timestamp.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "key"
     ],
     "properties": {
      "key": {
       "type": "string",
       "pattern": "^[A-Za-z0-9._:/-]{1,128}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "key": "notes/today",
  "entry": {
   "op": "write",
   "ts": 1790000000000,
   "key": "notes/today",
   "seq": 3,
   "hash": "<sha256 hex of this entry>",
   "prev": "<hash of entry 2>",
   "valueHash": "<sha256 hex of the value>"
  },
  "state": "active",
  "value": "Met the supplier; follow up Friday.",
  "wallet": "0x...",
  "expiresAt": 1792592000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tabularium-key-read-d8d348a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tabularium.matt-3e0.workers.dev](https://www.zero.xyz/host/tabularium.matt-3e0.workers.dev/llms.txt)
