Analytics API
Track your memory usage, session performance, and token savings. Use analytics to understand the value FatHippo provides.
Quick Summary
GET
/v1/analytics/summaryGet a quick overview of key metrics.
Example Request
curl "https://fathippo.ai/api/v1/analytics/summary" \
-H "Authorization: Bearer mem_your_api_key"Response
{
"totalMemories": 247,
"memoriesByTier": {
"critical": 12,
"high": 45,
"normal": 190
},
"totalSessions": 156,
"sessionsLast7Days": 23,
"averageSessionLength": 342,
"successRate": 0.87,
"totalSearches": 1247,
"searchesLast7Days": 189,
"tokensEstimated": {
"withoutFatHippo": 45000,
"withFatHippo": 12000,
"savings": 0.73
}
}Full Analytics
POST
/v1/analyticsGet detailed analytics with time-series data and breakdowns.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
period | string | No | 7d | 30d | 90d (default: 30d) |
namespace | string | No | Filter by namespace |
includeTimeSeries | boolean | No | Include daily data points |
Example Request
curl -X POST "https://fathippo.ai/api/v1/analytics" \
-H "Authorization: Bearer mem_your_api_key" \
-H "Content-Type: application/json" \
-d '{"period": "30d", "includeTimeSeries": true}'Response
{
"period": "30d",
"memories": {
"total": 247,
"created": 34,
"deleted": 5,
"archived": 12,
"byType": {
"preference": 45,
"fact": 89,
"decision": 23,
"identity": 12,
"constraint": 8,
"event": 70
},
"byTier": {
"critical": 12,
"high": 45,
"normal": 190
}
},
"sessions": {
"total": 156,
"thisMonth": 48,
"averageDuration": 342,
"averageTurns": 6.2,
"outcomes": {
"success": 135,
"partial": 12,
"failure": 4,
"abandoned": 5
}
},
"searches": {
"total": 1247,
"thisMonth": 412,
"averageResultsReturned": 4.3,
"topQueries": [
{"query": "user preferences", "count": 45},
{"query": "project decisions", "count": 32}
]
},
"tokens": {
"estimatedWithoutFatHippo": 45000,
"estimatedWithFatHippo": 12000,
"savingsPercent": 73,
"costSavingsEstimate": 1.65
},
"reinforcement": {
"positive": 78,
"negative": 12,
"promotions": 8,
"demotions": 2
},
"timeSeries": [
{
"date": "2026-03-01",
"memoriesCreated": 3,
"searches": 15,
"sessions": 2
},
{
"date": "2026-03-02",
"memoriesCreated": 5,
"searches": 22,
"sessions": 4
}
]
}Token Savings Calculation
FatHippo estimates token savings by comparing:
- Without FatHippo: Loading all memories into every session
- With FatHippo: Loading only critical + relevant memories
Savings = 1 - (tokensWithFatHippo / tokensWithoutFatHippo)
Example:
- Total memory tokens: 15,000
- Critical tier: 500 tokens
- Average high tier per session: 300 tokens
- Sessions this month: 50
Without FatHippo: 15,000 × 50 = 750,000 tokens
With FatHippo: (500 + 300) × 50 = 40,000 tokens
Savings: 94.7%Tip
At $3/million tokens, saving 710,000 tokens saves ~$2.13/month. For high-volume agents, this adds up quickly.
Misses Analysis
Use the misses endpoint to identify gaps in your memory coverage:
# Get recent misses
curl "https://fathippo.ai/api/v1/memories/misses?limit=20" \
-H "Authorization: Bearer mem_your_api_key"Common miss patterns indicate topics you should proactively store memories about.