Skip to main content
GET
/
stats
Graph Statistics
curl --request GET \
  --url https://api.example.com/stats
{
  "401": {},
  "500": {},
  "total_nodes": 123,
  "total_edges": 123,
  "layer_counts": {},
  "edge_type_counts": {},
  "source_type_counts": {}
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/timepoint-ai/timepoint-clockchain/llms.txt

Use this file to discover all available pages before exploring further.

Endpoint

GET /stats
Returns aggregate statistics about the entire knowledge graph, including total counts and breakdowns by layer, edge type, and source type.

Authentication

Requires service key authentication via X-Service-Key header.

Response

total_nodes
integer
Total number of nodes in the graph
total_edges
integer
Total number of edges in the graph
layer_counts
object
Node count grouped by layer level
edge_type_counts
object
Edge count grouped by relationship type
source_type_counts
object
Node count grouped by data source type

Example Request

curl -X GET "https://api.timepointclockchain.com/stats" \
  -H "X-Service-Key: your_service_key"

Example Response

{
  "total_nodes": 8790,
  "total_edges": 25050,
  "layer_counts": {
    "0": 1250,
    "1": 5200,
    "2": 1890,
    "3": 450
  },
  "edge_type_counts": {
    "causes": 450,
    "contemporaneous": 15600,
    "same_location": 4200,
    "thematic": 4800
  },
  "source_type_counts": {
    "historical": 6200,
    "wikipedia": 1800,
    "flash": 790
  }
}

Use Cases

Error Responses

401
error
Missing or invalid service key
{
  "detail": "Unauthorized"
}
500
error
Database error
{
  "detail": "Internal server error"
}

Notes

  • Statistics are computed in real-time from the database
  • All counts reflect the current state of the graph
  • Layer counts use string keys for consistency with JSON serialization
  • Source types default to "historical" if not explicitly set on nodes

Build docs developers (and LLMs) love