# GET /api/v1/rates — Memory Service Pricing Rates

> GET /api/v1/rates — Memory Service Pricing Rates is a paid API for AI agents from memory.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-09-13, last successful call 2026-07-29).

Returns current pricing rates for embedding (remember) and dreaming (consolidation) operations, plus a list of free operations and pricing notes for the memory.withzero.xyz service.

## Facts

- Endpoint: GET https://memory.withzero.xyz/api/v1/rates
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Last successful call: 2026-07-29
- Success rate: 100% of calls made through Zero
- Activations on Zero: 3
- Provider: memory.withzero.xyz
- Website: https://memory.withzero.xyz
- Canonical page: https://www.zero.xyz/c/memory-withzero-xyz-get-api-v1-rates-memory-service-pricing-rates-6f26cdf7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oi8OoObCNd5eYIFA1_V7N

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 memory-withzero-xyz-get-api-v1-rates-memory-service-pricing-rates-6f26cdf7
```

Example prompt: What are the current pricing rates for the memory.withzero.xyz service — specifically the embedding cost per million tokens, which dreaming models are available and their rates, and which operations like recall are completely free?

## When to prefer this

Use this endpoint before depositing USDC or calling remember() to understand current costs and avoid unexpected charges. Prefer this over hardcoded assumptions about pricing, especially before large-scale memory write operations or when auditing agent spend. This is the canonical source of truth for all memory.withzero.xyz operation costs.

## Known failure modes

- Service unavailable (5xx) if the memory backend is down
- Unexpected response structure if the pricing schema changes without notice
- Rate structure may be empty or partial if new models are being onboarded

## Output

Returns a JSON object with: (1) embedding object containing the model name and input cost in micros per million tokens (e.g. a typical 75-token fact costs ~10 micros); (2) dreaming object keyed by model name, each with input and output micros per million tokens for server-managed memory consolidation; (3) free_operations array listing which operations cost nothing (e.g. recall, expand); (4) pricing_notes string explaining the prepaid refundable escrow model where write margins fund free reads and permanent encrypted storage.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "embedding",
  "dreaming",
  "free_operations",
  "pricing_notes"
 ],
 "properties": {
  "dreaming": {
   "type": "object",
   "description": "Per-model rates for the server-managed consolidation (\"dreaming\") lifecycle, billed reserve→settle at actual usage.",
   "propertyNames": {
    "type": "string"
   },
   "additionalProperties": {
    "type": "object",
    "required": [
     "input_micros_per_mtokens",
     "output_micros_per_mtokens"
    ],
    "properties": {
     "input_micros_per_mtokens": {
      "type": "string"
     },
     "output_micros_per_mtokens": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "embedding": {
   "type": "object",
   "required": [
    "model",
    "input_micros_per_mtokens"
   ],
   "properties": {
    "model": {
     "type": "string"
    },
    "input_micros_per_mtokens": {
     "type": "string",
     "description": "What a remember() debits per 1M input tokens of content. A typical fact (~75 tokens) costs ~10 micros."
    }
   },
   "additionalProperties": false
  },
  "pricing_notes": {
   "type": "string",
   "description": "How direct refundable escrow and ZeroClick per-write usage fund writes, free reads, key management, storage, and managed lifecycle."
  },
  "free_operations": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Operations that debit nothing."
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/memory-withzero-xyz-get-api-v1-rates-memory-service-pricing-rates-6f26cdf7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from memory.withzero.xyz](https://www.zero.xyz/host/memory.withzero.xyz/llms.txt)