Memory Namespace Statistics API

Return statistics for a memory namespace: total key count, total stored bytes, oldest entry timestamp, newest entry timestamp, number of keys with TTLs set, and breakdown by tag. Available as a simple REST API — POST your input, get structured JSON back. 1 credit per call, no rate limiting, works in any language with HTTP support.

How it works

POST a JSON object with your input data to /v1/memory-stats. The API processes your request server-side using real computation (not mocked data) and returns a structured JSON response with your results and metadata including credits used and processing time.

Use cases

• Use Memory Namespace Statistics in automated pipelines without installing a library
• Call Memory Namespace Statistics from AI agent workflows via MCP or REST
• Integrate Memory Namespace Statistics into serverless functions with zero dependencies
• Build Memory Namespace Statistics functionality into any language that supports HTTP

API Reference

POST https://slopshop.gg/v1/memory-stats
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Input parameters

Example response

{
  "data": {
    "key": "my-key",
    "value": "stored value",
    "updated_at": "2025-01-15T10:30:00Z"
  },
  "meta": {
    "credits_used": 1,
    "engine": "real",
    "ms": 4
  }
}

Examples

Three real-world scenarios showing how developers use Memory Namespace Statistics in production.

curl -X POST https://slopshop.gg/v1/memory-stats \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "my_key", "value": "hello world"}'

curl -X POST https://slopshop.gg/v1/memory-stats \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "user_preferences", "value": {"theme": "dark", "language": "en", "notifications": true}}'

curl -X POST https://slopshop.gg/v1/memory-stats \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "session_data", "value": {"step": 2, "completed": true}, "namespace": "agent:session:xyz"}'

Code examples

curl

curl -X POST https://slopshop.gg/v1/memory-stats \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "your data here"}'

Python

import requests

response = requests.post(
    "https://slopshop.gg/v1/memory-stats",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"input": "your data here"}
)
result = response.json()
print(result["data"])

Node.js

const response = await fetch("https://slopshop.gg/v1/memory-stats", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ input: "your data here" })
});
const { data } = await response.json();
console.log(data);

CLI

# Install the Slopshop CLI
npm install -g slopshop

# Set your API key
export SLOPSHOP_KEY=your_api_key

# Call memory-stats
slop memory-stats '{"input": "your data here"}'

Pricing

Credits are purchased in bundles starting at $1 for 1,000 credits. All compute APIs like this one use 1 credit per call — that's $0.001. See all pricing tiers.

Related APIs in Memory

• Store Memory API — Store a named memory with a string or JSON value, optional tags for organization, and an optional namespace for isolation. Persists across agent sessions. Returns confirmation with storage timestamp.
• Retrieve Memory API — Retrieve a stored memory by its key within an optional namespace. Returns the value, creation timestamp, last-updated timestamp, and associated tags. Returns null if key does not exist.
• Search Memories API — Search stored memories by tag match, key substring, or value substring within an optional namespace. Returns all matching key-value pairs with their metadata, sorted by last-updated date.
• List All Memories API — List all stored memory keys in a namespace, with optional filtering by tag. Returns key names, creation dates, value sizes, and tags. Does not return values themselves (use memory-get for that).
• Delete Memory API — Delete a stored memory by key within an optional namespace. Returns confirmation including the deleted key and a timestamp. Silently succeeds if key does not exist.

View the full API catalog · Try in playground · Documentation