Lium Public stats feed API
The Public stats feed API from Lium — 1 operation(s) for public stats feed.
The Public stats feed API from Lium — 1 operation(s) for public stats feed.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/lium-io:lium-io-public-stats-feed-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Lium Backend Public stats feed API
description: '## 🚀 Lium Backend API
A comprehensive compute platform that enables users to rent GPU resources from a network of providers/nodes.
*Built with FastAPI, PostgreSQL and Redis.*'
contact:
name: Lium
url: https://lium.io/
email: support@lium.io
license:
name: MIT
url: https://opensource.org/licenses/MIT
version: 1.0.0
servers:
- url: /api
description: Production API
tags:
- name: Public stats feed
paths:
/public/v1/stats:
get:
tags:
- Public stats feed
summary: Public network stats
description: '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.'
operationId: get_public_stats_public_v1_stats_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PublicStatsResponse'
components:
schemas:
DailyThroughput:
properties:
day:
type: string
format: date
title: Day
gmv_usd:
type: number
title: Gmv Usd
description: USD billed to renters that UTC day.
gpu_hours:
type: number
title: Gpu Hours
description: GPU-hours rented that UTC day.
rentals:
type: integer
title: Rentals
description: Rentals started that UTC day, failed starts excluded.
type: object
required:
- day
- gmv_usd
- gpu_hours
- rentals
title: DailyThroughput
DailyUtilisation:
properties:
day:
type: string
format: date
title: Day
utilisation:
type: number
title: Utilisation
description: Share of the fleet's offered GPU-hours rented that UTC day, 0-1.
type: object
required:
- day
- utilisation
title: DailyUtilisation
FleetStats:
properties:
gpus_listed:
type: integer
title: Gpus Listed
description: GPUs on verified, active nodes that take new rentals.
gpus_rented:
type: integer
title: Gpus Rented
description: Of those, GPUs inside a running pod right now.
gpu_models:
type: integer
title: Gpu Models
countries:
type: integer
title: Countries
description: Countries with at least one listed node, rented or not.
providers:
type: integer
title: Providers
description: Providers with at least one listed node, rented or not.
utilisation_30d:
anyOf:
- type: number
- type: 'null'
title: Utilisation 30D
description: Share of offered GPU-hours rented over 30 days, 0-1, models past the floor only.
type: object
required:
- gpus_listed
- gpus_rented
- gpu_models
- countries
- providers
title: FleetStats
CountryStats:
properties:
country:
type: string
title: Country
nodes:
type: integer
title: Nodes
type: object
required:
- country
- nodes
title: CountryStats
ModelStats:
properties:
gpu_model:
type: string
title: Gpu Model
gpus_listed:
type: integer
title: Gpus Listed
gpus_rented:
type: integer
title: Gpus Rented
from_price:
anyOf:
- type: number
- type: 'null'
title: From Price
description: Lowest USD per GPU-hour among nodes available now.
utilisation_30d:
anyOf:
- type: number
- type: 'null'
title: Utilisation 30D
description: null below one GPU-month on offer.
median_price_30d:
anyOf:
- type: number
- type: 'null'
title: Median Price 30D
description: GPU-hour-weighted median paid USD per GPU-hour, 30 days; null on a thin sample.
type: object
required:
- gpu_model
- gpus_listed
- gpus_rented
title: ModelStats
ReliabilityStats:
properties:
scored_nodes:
type: integer
title: Scored Nodes
description: Listed nodes (rented or not) whose provider has a 14-day reliability score.
median_score:
anyOf:
- type: number
- type: 'null'
title: Median Score
share_at_least_95:
anyOf:
- type: number
- type: 'null'
title: Share At Least 95
description: Share of scored nodes at 95 or above, 0-1.
type: object
required:
- scored_nodes
title: ReliabilityStats
PublicStatsResponse:
properties:
generated_at:
type: string
format: date-time
title: Generated At
fleet:
$ref: '#/components/schemas/FleetStats'
models:
items:
$ref: '#/components/schemas/ModelStats'
type: array
title: Models
countries:
items:
$ref: '#/components/schemas/CountryStats'
type: array
title: Countries
reliability:
$ref: '#/components/schemas/ReliabilityStats'
utilisation_daily:
items:
$ref: '#/components/schemas/DailyUtilisation'
type: array
title: Utilisation Daily
default: []
throughput:
anyOf:
- $ref: '#/components/schemas/ThroughputStats'
- type: 'null'
type: object
required:
- generated_at
- fleet
- models
- countries
- reliability
title: PublicStatsResponse
ThroughputStats:
properties:
days:
type: integer
title: Days
description: Complete UTC days the totals cover, ending yesterday.
gmv_usd:
type: number
title: Gmv Usd
gpu_hours:
type: number
title: Gpu Hours
rentals:
type: integer
title: Rentals
daily:
items:
$ref: '#/components/schemas/DailyThroughput'
type: array
title: Daily
type: object
required:
- days
- gmv_usd
- gpu_hours
- rentals
- daily
title: ThroughputStats
securitySchemes:
JwtAccessBearer:
type: http
scheme: bearer
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key