Skip to main content

​
API Overview

The Timepoint ecosystem exposes three HTTP APIs. The Clockchain public endpoints require no authentication. Flash and Pro require service keys.

​
Base URLs

ServiceBase URLAuth Required
Flashhttps://api.timepointai.comYes (X-Service-Key)
Clockchain (public)https://timepoint-clockchain-deploy-private-production.up.railway.appNo
Clockchain (write)Same as aboveYes (X-Service-Key)
Pro Cloudhttps://timepoint-pro-cloud-private-production.up.railway.appYes (PRO_API_KEY)

​
Quick Examples

​
Clockchain — No Auth Needed

# Get graph stats
curl https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/stats

# Search moments
curl "https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/moments?q=rome&limit=5"

​
Flash — Render a Moment

curl -X POST https://api.timepointai.com/api/v1/timepoints/generate/sync \
  -H "Content-Type: application/json" \
  -H "X-Service-Key: YOUR_KEY" \
  -d '{"query": "Moon landing, July 20 1969", "generate_image": true}'

​
Response Format

All APIs return JSON. Clockchain public endpoints return paginated results: 
{
  "items": [...],
  "total": 196,
  "limit": 10,
  "offset": 0
}

​
Rate Limits

TierLimitApplies To
Public60/minClockchain unauthenticated reads
Auth reads300/minAuthenticated GET requests
Auth writes30/minPOST/PUT/DELETE with service key
Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

​
CORS

Clockchain public endpoints allow all origins (CORS_ORIGINS=*). Rate limit headers are exposed for browser clients.