Lium Public stats feed API

The Public stats feed API from Lium — 1 operation(s) for public stats feed.

GitHub OpenAPI

Operations 1

GET /public/v1/stats Public network stats #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/lium-io:lium-io-public-stats-feed-api"
All apis
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.

Get an API 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 Specification

lium-io-public-stats-feed-api-openapi.yml Raw ↑
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