Skip to main content

​
Clockchain API

Base URL: https://timepoint-clockchain-deploy-private-production.up.railway.app Public endpoints require no authentication. Write/admin endpoints require X-Service-Key.

​
Public Endpoints

​
GET /api/v1/stats

Graph statistics. 
curl https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/stats
Response: 
{
  "total_nodes": 196,
  "total_edges": 671,
  "layer_counts": {"2": 196},
  "edge_type_counts": {
    "causes": 73,
    "same_location": 42,
    "contemporaneous": 474,
    "thematic": 82
  },
  "source_type_counts": {"historical": 196},
  "date_range": {"min_year": -133, "max_year": 2019},
  "avg_confidence": null,
  "last_updated": "2026-03-07T04:35:49Z"
}

​
GET /api/v1/moments

Paginated list of moments with filtering. Query Parameters:
ParameterTypeDescription
limitintMax results (default 20)
offsetintPagination offset
qstringFull-text search
year_fromintFilter: minimum year
year_tointFilter: maximum year
entitystringFilter by historical figure
sortstringSort order
# Search for events in Rome
curl "https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/moments?q=rome&limit=5"

# Events between 1900-2000
curl "https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/moments?year_from=1900&year_to=2000"
Response: 
{
  "items": [
    {
      "path": "/1969/july/20/2056/united-states/florida/cape-canaveral/apollo-11-moon-landing",
      "event_name": "Apollo 11 Moon Landing",
      "year": 1969,
      "layer": 2,
      "figures": ["Neil Armstrong", "Buzz Aldrin"],
      "tags": ["space", "nasa", "cold-war"]
    }
  ],
  "total": 196,
  "limit": 5,
  "offset": 0
}

​
GET /api/v1/moments/

Get a specific moment by canonical path, including its edges. 
curl "https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/moments/-44/march/15/1030/italy/lazio/rome/assassination-of-julius-caesar"

​
Authenticated Endpoints

These require X-Service-Key header:
EndpointMethodDescription
/browseGETBrowse graph with full metadata
/searchGETSearch with advanced filters
/randomGETRandom moment
/todayGETToday in history
/generatePOSTGenerate new moment via Flash
/ingest/tdfPOSTIngest TDF record

​
TDF Export

Add ?format=tdf to any moment endpoint to get TDF-formatted output: 
curl "https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/moments/{path}?format=tdf" \
  -H "X-Service-Key: YOUR_KEY"