> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compute-desk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intraday Index: Index Reference

> A private API reference scoped to the indices this key may access.

<Info>
  The Intraday Index is available to authorized clients. Your API token must have the required permissions added — contact [david@compute-index.com](mailto:david@compute-index.com) to request access.
</Info>

## Example

Fetch a self-contained reference scoped to your token:

```bash theme={null}
curl -H "Authorization: Bearer $TOKEN" \
  "https://data-api.compute-index.com/v1/custom-index/reference"
```


## OpenAPI

````yaml pricing/openapi.json GET /v1/custom-index/reference
openapi: 3.1.0
info:
  title: GPU Pricing API
  description: |2-

        **GPU Pricing API** provides real-time and historical pricing data
        for GPU compute across 50+ cloud providers and GPU marketplaces.

        ## Features
        - Search current prices across vendors
        - Historical price trends
        - GPU transaction data
        - **Informational Price Index** — EWMA-smoothed composite indices by GPU family, region, and contract type
        - **Transaction Price Index** — smoothed indices derived from verified GPU transactions
        - **Custom Index** — EWMA-smoothed H100 sub-model indices by region, contract type, and vendor category
        - Global region coverage (US, EU, APAC)
        - GPU availability tracking
        - Scope-based API key access control

        ## Authentication
        Send your token as a Bearer token in the `Authorization` header on every request:
        ```
        Authorization: Bearer YOUR_TOKEN
        ```
        Example:
        ```bash
        curl -H "Authorization: Bearer $TOKEN" "https://data-api.compute-index.com/v1/vendors"
        ```
        Tokens are issued by Compute Index (david@compute-index.com); long-lived, treat as secrets.

        > The legacy `X-API-Key` header is deprecated — use the `Authorization: Bearer` header above.

        ## Rate Limits
        - **Free tier**: 100 requests/minute, 10,000/day
        - **Pro tier**: 1,000 requests/minute, 100,000/day
        - **Enterprise**: Custom limits

        ## Data Coverage
        - 50+ vendors (AWS, Azure, GCP, Oracle, CoreWeave, Lambda, RunPod, Vast.AI, FluidStack, Vultr, etc.)
        - 30M+ historical pricing records
        - Updated multiple times daily

        ## Support
        - Support: david@compute-index.com
        
  contact:
    name: API Support
    email: david@compute-index.com
  license:
    name: Commercial License
    url: https://compute-desk.com/license
  version: 1.0.0
servers:
  - url: https://data-api.compute-index.com
security: []
paths:
  /v1/custom-index/reference:
    get:
      tags:
        - Custom Index
      summary: Get Custom Index Reference
      description: A private API reference scoped to the indices this key may access.
      operationId: get_custom_index_reference_v1_custom_index_reference_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomIndexReference'
              example:
                endpoints:
                  GET /v1/custom-index/as-of: >-
                    Value as of a UTC time (capped at now). Params: as_of,
                    index_id.
                  GET /v1/custom-index/available: >-
                    List the indices your key can access + their interval
                    ranges.
                  GET /v1/custom-index/current: 'Latest realized value. Params: index_id.'
                  GET /v1/custom-index/history: >-
                    Time series. Params: index_id, start, end, resolution,
                    limit, offset.
                fields:
                  blended_value: Raw (unsmoothed) blended index ($/GPU/hr).
                  index_units: usd_per_gpu_per_hr.
                  index_value: >-
                    EWMA-smoothed blended index ($/GPU/hr) — the headline
                    (half-life ~1.94d).
                  p5 / p95: Blended envelope band (unsmoothed).
                  timestamp: Interval start, UTC ISO-8601 (30-min grid).
                indices:
                  - contract_type: combined
                    description: >-
                      NVIDIA H100 · US · neocloud · combined
                      (on-demand+reserved) — intraday blended index
                    first_timestamp: '2024-04-01T00:00:00+00:00'
                    gpu_family: hopper
                    gpu_model: h100
                    index_id: h100-us
                    index_name: h100
                    index_units: usd_per_gpu_per_hr
                    last_timestamp: '2026-07-16T07:00:00+00:00'
                    region_group: US
                    total_intervals: 40143
                    vendor_category: neocloud
                notes:
                  - All timestamps are UTC.
                  - >-
                    Only realized intervals are returned (interval_start <=
                    now); future buffer is never exposed.
                  - >-
                    history is paginated: use total_count / has_more /
                    next_offset to page through.
                  - >-
                    Unsupported filter values or an index_id you are not
                    authorized for return an error.
        '401':
          description: Unauthorized — missing or invalid credentials
          content:
            application/json:
              schema:
                title: ErrorResponse
                type: object
                properties:
                  detail:
                    type: string
                required:
                  - detail
              examples:
                missing_credentials:
                  summary: No credentials supplied
                  value:
                    detail: >-
                      Authentication required. Provide an X-API-Key header or an
                      Authorization: Bearer token.
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    detail: Invalid or expired token
        '403':
          description: Forbidden — key lacks the required scope
          content:
            application/json:
              schema:
                title: ErrorResponse
                type: object
                properties:
                  detail:
                    type: string
                required:
                  - detail
              examples:
                missing_scope:
                  summary: Key lacks the required scope
                  value:
                    detail: >-
                      Access denied. Your API key does not have permission to
                      access this resource.
        '429':
          description: >-
            Too Many Requests — limit and reset are returned in X-RateLimit-*
            headers; the limit reflects your key's tier
          content:
            application/json:
              schema:
                title: ErrorResponse
                type: object
                properties:
                  detail:
                    type: string
                required:
                  - detail
              examples:
                minute_limit:
                  summary: Per-minute limit exceeded (figure reflects your key's tier)
                  value:
                    detail: 'Rate limit exceeded: 100 requests per minute'
      security:
        - HTTPBearer: []
components:
  schemas:
    CustomIndexReference:
      properties:
        indices:
          items:
            $ref: '#/components/schemas/AvailableCustomIndex'
          type: array
          title: Indices
          description: Indices this key is authorized for
        endpoints:
          additionalProperties: true
          type: object
          title: Endpoints
          description: Endpoint usage summary
        fields:
          additionalProperties: true
          type: object
          title: Fields
          description: Field descriptions for each data point
        notes:
          items:
            type: string
          type: array
          title: Notes
          description: Methodology / behavior notes
      type: object
      required:
        - indices
        - endpoints
        - fields
        - notes
      title: CustomIndexReference
      description: >-
        Private, per-caller API reference for the custom-index section.


        Returned by the auth-gated /v1/custom-index/reference endpoint; lists
        only the

        indices the caller's key is authorized for (the public /docs hides this
        section).
    AvailableCustomIndex:
      properties:
        index_id:
          type: string
          title: Index Id
          description: Index identifier (e.g., h100-us)
        description:
          type: string
          title: Description
          description: Human-readable index description
        index_name:
          type: string
          title: Index Name
          description: Index name (e.g., h100)
        gpu_family:
          type: string
          title: Gpu Family
          description: GPU family (hopper)
        gpu_model:
          type: string
          title: Gpu Model
          description: GPU group (h100)
        region_group:
          type: string
          title: Region Group
          description: Region group
        contract_type:
          type: string
          title: Contract Type
          description: Contract type
        vendor_category:
          type: string
          title: Vendor Category
          description: Vendor category
        index_units:
          type: string
          title: Index Units
          description: Units of the index value
          default: usd_per_gpu_per_hr
        first_timestamp:
          type: string
          title: First Timestamp
          description: Earliest available interval, UTC ISO-8601
        last_timestamp:
          type: string
          title: Last Timestamp
          description: Latest realized interval (<= now), UTC ISO-8601
        total_intervals:
          type: integer
          title: Total Intervals
          description: Number of 30-min intervals with a blended value (<= now)
      type: object
      required:
        - index_id
        - description
        - index_name
        - gpu_family
        - gpu_model
        - region_group
        - contract_type
        - vendor_category
        - first_timestamp
        - last_timestamp
        - total_intervals
      title: AvailableCustomIndex
      description: Available custom index series metadata
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````