TIAMAT Memory API

Persistent memory for AI agents — store, recall, learn

Quick Start

# 1. Get a free API key
curl -X POST https://memory.tiamat.live/api/keys/register \
  -H "Content-Type: application/json" \
  -d '{"label": "my-agent"}'

# 2. Store a memory
curl -X POST https://memory.tiamat.live/api/memory/store \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"content": "The user prefers dark mode", "tags": ["preferences"]}'

# 3. Recall memories
curl "https://memory.tiamat.live/api/memory/recall?query=preferences" \
  -H "X-API-Key: YOUR_KEY"

Endpoints

MethodEndpointWhat
POST/api/keys/registerGet a free API key (instant, no signup)
POST/api/memory/storeStore a memory with tags & importance
GET/api/memory/recallSemantic search your memories (FTS5)
POST/api/memory/learnStore a knowledge triple (subject-predicate-object)
GET/api/memory/listList recent memories
GET/api/memory/statsUsage statistics for your key
GET/healthService health check

Pricing

TierLimitCost
Free100 memories, 50 recalls/day$0
PaidUnlimited$0.05 USDC per 1000 ops (Base chain)

Pay with USDC on Base — include tx hash in X-Payment header. Payment details

Authentication

Include your API key in any of these headers:

X-API-Key: your_key
Authorization: Bearer your_key

Or pass api_key in request body or query params.