These three endpoints expose public, read-only statistics about the Darkbloom network. No authentication is required. They power the network dashboard on darkbloom.dev and are suitable for building external monitoring tools or status pages.
GET /v1/stats Returns aggregate platform statistics for all currently connected providers, including hardware totals, token counts, and a 30-minute time series. Cached for 60 seconds.
Response Cumulative number of inference requests served across the network lifetime.
Cumulative input tokens consumed across all requests.
Cumulative output tokens generated across all requests.
Sum of prompt and completion tokens.
Average token count per request.
Number of providers currently connected.
Total GPU cores across all connected providers.
Total CPU cores across all connected providers.
Total unified memory in GB across all connected providers.
Total memory bandwidth in GB/s across all connected providers.
Array of per-provider hardware and stats snapshots. Internal provider identifier.
Apple Silicon chip name, e.g. "Apple M3 Max".
Unified memory size in GB.
Provider status. "online" when available for requests.
Attestation trust level: "self_signed" or "hardware".
Most recently observed decode throughput in tokens per second.
providers[].requests_served
Requests served by this provider in the current session.
providers[].tokens_generated
Tokens generated by this provider in the current session.
Model IDs this provider is serving.
providers[].current_model
The model currently loaded on this provider.
Aggregated per-model provider counts. Number of providers currently serving this model.
Per-minute request and token counts for the last 30 minutes. ISO 8601 UTC timestamp for the minute bucket.
Requests completed in this minute.
time_series[].prompt_tokens
Input tokens consumed in this minute.
time_series[].completion_tokens
Output tokens generated in this minute.
time_series[].total_tokens
Total tokens in this minute.
GET /v1/leaderboard Returns the top providers ranked by earnings, tokens generated, or jobs completed. Provider identities are pseudonymized — raw account IDs are never exposed. Cached for 5 minutes.
Query parameters The ranking metric. One of "earnings", "tokens", or "jobs".
The time window for rankings. One of "24h", "7d", "30d", or "all".
Maximum number of entries to return. Between 1 and 200.
Response The metric used for ranking.
Ranked list of providers. Position in the leaderboard (1-indexed).
Pseudonymized provider identifier derived deterministically from the account ID.
entries[].earnings_micro_usd
Total earnings in micro-USD for the selected window.
Total tokens generated for the selected window.
Total inference jobs completed for the selected window.
ISO 8601 timestamp of when this response was generated.
GET /v1/network/totals Returns aggregate network metrics (earnings, tokens, jobs, active accounts) for a given time window. Cached for 1 minute.
Query parameters The time window. One of "24h", "7d", "30d", or "all".
Response Total provider earnings in micro-USD for the window.
Total tokens generated for the window.
Total inference jobs completed for the window.
Number of distinct accounts active in the window.
ISO 8601 timestamp of when this response was generated.
Examples GET /v1/stats
GET /v1/leaderboard
GET /v1/network/totals
curl https://api.darkbloom.dev/v1/stats
Example /v1/stats response { "total_requests" : 142893 , "total_prompt_tokens" : 89234120 , "total_completion_tokens" : 31047880 , "total_tokens" : 120282000 , "avg_tokens_per_request" : 841.7 , "active_providers" : 12 , "total_gpu_cores" : 480 , "total_cpu_cores" : 192 , "total_memory_gb" : 768 , "total_bandwidth_gbs" : 9828.0 , "providers" : [ ... ], "models" : [ { "id" : "qwen3.5-27b-claude-opus-8bit" , "providers" : 4 }, { "id" : "mlx-community/gemma-4-26b-a4b-it-8bit" , "providers" : 5 } ], "time_series" : [ ... ] }
Example /v1/leaderboard response { "metric" : "earnings" , "window" : "7d" , "entries" : [ { "rank" : 1 , "pseudonym" : "SwiftFalcon" , "earnings_micro_usd" : 8420000 , "tokens" : 91234567 , "jobs" : 4821 }, { "rank" : 2 , "pseudonym" : "IronHawk" , "earnings_micro_usd" : 6150000 , "tokens" : 67012345 , "jobs" : 3640 } ], "updated_at" : "2025-04-30T15:00:00Z" }
Example /v1/network/totals response { "window" : "24h" , "earnings_micro_usd" : 12480000 , "tokens" : 148203450 , "jobs" : 7923 , "active_accounts" : 38 , "updated_at" : "2025-04-30T15:01:00Z" }