Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.darkbloom.dev/llms.txt

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

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

​
total_requests
integer
Cumulative number of inference requests served across the network lifetime.
​
total_prompt_tokens
integer
Cumulative input tokens consumed across all requests.
​
total_completion_tokens
integer
Cumulative output tokens generated across all requests.
​
total_tokens
integer
Sum of prompt and completion tokens.
​
avg_tokens_per_request
number
Average token count per request.
​
active_providers
integer
Number of providers currently connected.
​
total_gpu_cores
integer
Total GPU cores across all connected providers.
​
total_cpu_cores
integer
Total CPU cores across all connected providers.
​
total_memory_gb
integer
Total unified memory in GB across all connected providers.
​
total_bandwidth_gbs
number
Total memory bandwidth in GB/s across all connected providers.
​
providers
object[]
Array of per-provider hardware and stats snapshots.
​
models
object[]
Aggregated per-model provider counts.
​
time_series
object[]
Per-minute request and token counts for the last 30 minutes.

​
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

​
metric
string
default:"earnings"
The ranking metric. One of "earnings", "tokens", or "jobs".
​
window
string
default:"all"
The time window for rankings. One of "24h", "7d", "30d", or "all".
​
limit
integer
default:"50"
Maximum number of entries to return. Between 1 and 200.

​
Response

​
metric
string
The metric used for ranking.
​
window
string
The time window used.
​
entries
object[]
Ranked list of providers.
​
updated_at
string
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

​
window
string
default:"all"
The time window. One of "24h", "7d", "30d", or "all".

​
Response

​
window
string
The time window used.
​
earnings_micro_usd
integer
Total provider earnings in micro-USD for the window.
​
tokens
integer
Total tokens generated for the window.
​
jobs
integer
Total inference jobs completed for the window.
​
active_accounts
integer
Number of distinct accounts active in the window.
​
updated_at
string
ISO 8601 timestamp of when this response was generated.

​
Examples

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"
}