---
title: "Public network stats"
method: GET
path: "/public/v1/stats"
tags: ["Public stats feed"]
---

# Public network stats

`GET /public/v1/stats`

## Request

- Base URL: `https://lium.io/api`
- URL: `https://lium.io/api/public/v1/stats`
- Auth: none declared

The figures on lium.io/stats: GPUs listed and rented per model, the cheapest ask and the 30-day median paid price per model, 30-day utilisation, GMV billed, GPU-hours and rentals per day, countries and provider reliability. Aggregates only. No authentication. The feed refreshes every 5 minutes; the 30-day figures (paid prices, utilisation) update daily. Fields are only ever added; a breaking change ships as /public/v2.

## Response `200`

Successful Response

- PublicStatsResponse
  - `generated_at` string, date-time, required
  - `fleet` FleetStats, required
    - `gpus_listed` integer, required: GPUs on verified, active nodes that take new rentals.
    - `gpus_rented` integer, required: Of those, GPUs inside a running pod right now.
    - `gpu_models` integer, required
    - `countries` integer, required: Countries with at least one listed node, rented or not.
    - `providers` integer, required: Providers with at least one listed node, rented or not.
    - `utilisation_30d` number, nullable: Share of offered GPU-hours rented over 30 days, 0-1, models past the floor only.
  - `models` ModelStats[], required
    - `gpu_model` string, required
    - `gpus_listed` integer, required
    - `gpus_rented` integer, required
    - `from_price` number, nullable: Lowest USD per GPU-hour among nodes available now.
    - `utilisation_30d` number, nullable: null below one GPU-month on offer.
    - `median_price_30d` number, nullable: GPU-hour-weighted median paid USD per GPU-hour, 30 days; null on a thin sample.
  - `countries` CountryStats[], required
    - `country` string, required
    - `nodes` integer, required
  - `reliability` ReliabilityStats, required
    - `scored_nodes` integer, required: Listed nodes (rented or not) whose provider has a 14-day reliability score.
    - `median_score` number, nullable
    - `share_at_least_95` number, nullable: Share of scored nodes at 95 or above, 0-1.
  - `utilisation_daily` DailyUtilisation[]
    - `day` string, date, required
    - `utilisation` number, required: Share of the fleet's offered GPU-hours rented that UTC day, 0-1.
  - `throughput` ThroughputStats
    - `days` integer, required: Complete UTC days the totals cover, ending yesterday.
    - `gmv_usd` number, required
    - `gpu_hours` number, required
    - `rentals` integer, required
    - `daily` DailyThroughput[], required
      - `day` string, date, required
      - `gmv_usd` number, required: USD billed to renters that UTC day.
      - `gpu_hours` number, required: GPU-hours rented that UTC day.
      - `rentals` integer, required: Rentals started that UTC day, failed starts excluded.

## Changes

- **2026-10-19** `2db821006eba`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lium/apis/lium-backend-api/changes/public/v1/stats/get.md)

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lium/apis/lium-backend-api/revisions/a682d3ef1e07?raw)