Infra-Index Logo

Infra-Index Platform
v1.0.0
Foundation Live App GitHub Founder CV

API Reference & Schema Specification

Complete endpoint definitions, request parameters, response headers, and data transfer object (DTO) models.

Base URL

Production ASGI Base: https://infraindex-platform.vercel.app/api/v1

1. GET /data/list

Fetches paginated, sorted compute and hardware offering lists with multi-cloud aggregation.

Parameter Type Required Description
menu_id string Yes Resource category: gpu, cpu, storage, baremetal
limit integer No (Default: 50) Number of records to return (1 to 100).
offset integer | string No (Default: 0) Pagination offset index or base64 cursor.
sort string No Sorting rule: PROVIDERS_DESC, PRICE_ASC, VRAM_DESC
search_tags list[string] No Search keyword or alias (e.g. H100, 4090, EPYC).

Response Schema (JSON)

{
  "items": [
    {
      "id": "A100-SXM4-80GB",
      "name": "NVIDIA A100 SXM4 80GB",
      "vram_gb": 80,
      "popularity_score": 98.4,
      "offers": [
        {
          "provider": "runpod",
          "price_per_hour": 1.64,
          "availability_status": "AVAILABLE",
          "region": "US-EAST"
        },
        {
          "provider": "vast-ai",
          "price_per_hour": 1.39,
          "availability_status": "AVAILABLE",
          "region": "EU-CENTRAL"
        }
      ]
    }
  ],
  "meta": {
    "hw_type": "gpu",
    "item_count": 159,
    "cache_status": "ok",
    "source": "redis",
    "generated_at": "2026-08-26T08:15:01Z"
  }
}

2. GET /data/chart

Returns unified historical price time-series and OHLC candlestick aggregates.

Parameter Type Required Description
menu_id string Yes Chart type: gpu, candlestick, retail
target_ids list[string] Yes Model identifiers (e.g., target_ids=H100&target_ids=A100)
timeframe string No (Default: 30d) Timeframe duration: 7d, 30d, 90d, 1y

3. GET /health/ping

Sub-millisecond liveness probe for monitoring agent uptime and CDN edge health.

{
  "status": "healthy",
  "database": "connected",
  "redis": "connected",
  "timestamp": "2026-08-26T08:26:00Z"
}