> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memoclaw.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> Per-request USDC pricing for MemoClaw endpoints.

MemoClaw uses pay-per-request pricing. No subscriptions, no API keys, no monthly minimums. Pay with USDC on Base.

Only endpoints that use OpenAI (embeddings or GPT-4o-mini) are charged. Everything else is free.

## Paid endpoints

These endpoints consume OpenAI resources and are charged per request.

### Embedding endpoints (\$0.005)

| Endpoint                   | Operation                | Price   |
| -------------------------- | ------------------------ | ------- |
| `POST /v1/store`           | Store a memory           | \$0.005 |
| `POST /v1/store/batch`     | Store up to 100 memories | \$0.04  |
| `POST /v1/recall`          | Semantic search          | \$0.005 |
| `PATCH /v1/memories/:id`   | Update a memory          | \$0.005 |
| `PATCH /v1/memories/batch` | Batch update             | \$0.005 |

### LLM + embedding endpoints (\$0.01)

| Endpoint                        | Operation              | Price  |
| ------------------------------- | ---------------------- | ------ |
| `POST /v1/memories/extract`     | Extract facts via LLM  | \$0.01 |
| `POST /v1/memories/consolidate` | Merge similar memories | \$0.01 |
| `POST /v1/ingest`               | Zero-effort ingestion  | \$0.01 |
| `POST /v1/context`              | Assemble context block | \$0.01 |
| `POST /v1/migrate`              | Import markdown files  | \$0.01 |

## Free endpoints

These endpoints don't use OpenAI and are always free — no credits consumed.

| Endpoint                                        | Operation                  |
| ----------------------------------------------- | -------------------------- |
| `GET /v1/memories`                              | List memories              |
| `GET /v1/memories/:id`                          | Get a single memory        |
| `DELETE /v1/memories/:id`                       | Delete a memory            |
| `DELETE /v1/memories`                           | Bulk delete                |
| `POST /v1/search`                               | Full-text keyword search   |
| `GET /v1/suggested`                             | Proactive suggestions      |
| `GET /v1/memories/core`                         | Get core memories          |
| `POST /v1/memories/core`                        | Pin a core memory          |
| `DELETE /v1/memories/core/:id`                  | Unpin a core memory        |
| `GET /v1/memories/:id/history`                  | Memory change history      |
| `POST /v1/memories/:id/relations`               | Create a relation          |
| `GET /v1/memories/:id/relations`                | List relations             |
| `DELETE /v1/memories/:id/relations/:relationId` | Delete a relation          |
| `GET /v1/memories/:id/graph`                    | Traverse memory graph      |
| `GET /v1/export`                                | Export memories            |
| `GET /v1/namespaces`                            | List namespaces            |
| `GET /v1/stats`                                 | Usage statistics           |
| `POST /auth/session`                            | Exchange signature for JWT |
| `GET /v1/free-tier/status`                      | Check free tier            |
| `GET /v1/free-tier/info`                        | Free tier policy           |
| `GET /health`                                   | Health check               |

## Free tier

Every wallet gets **100 free paid-endpoint calls**. No payment required to start. Free endpoints are always free regardless.

<Info>
  After the free tier, pay per call with x402 (USDC on Base). A typical agent doing 150 store/recall calls per day costs about **\$0.75/day** or **\~\$22.50/month**.
</Info>

## Cost example

| Usage pattern                              | Daily cost | Monthly cost |
| ------------------------------------------ | ---------- | ------------ |
| Light (50 store + 50 recall)               | \$0.50     | \~\$15       |
| Medium (100 store + 200 recall)            | \$1.50     | \~\$45       |
| Heavy (200 store + 400 recall + 20 ingest) | \$3.20     | \~\$96       |

<Tip>
  List, get, delete, search, and stats are all free. Only store, recall, and AI-powered endpoints cost money.
</Tip>