---
title: "Get custom index history"
method: GET
path: "/v1/custom-index/history"
tags: ["Custom Index"]
---

# Get custom index history

`GET /v1/custom-index/history`

## Request

- Base URL: `https://api.liquidcompute.co`
- URL: `https://api.liquidcompute.co/v1/custom-index/history`
- Auth: API key in header `X-API-Key`

Returns custom index history with selectable resolution and pagination.

Intraday resolutions (`30m`, `1h`, and the omitted default, which is
the native 30-minute grid) require the `intraday` entitlement family on
top of the index authorization; requests without it return `404`
`not_found`. Daily history (`resolution=1d`) needs only the index.

## Query parameters

- `resolution` '30m' | '1h' | '1d'
- `start` string
- `end` string
- `limit` integer
- `offset` integer
- `index_id` string
- `region_group` 'US'
- `contract_type` 'combined'
- `vendor_category` 'neocloud'

## Response `200`

Custom index history.

- CustomIndexHistoryResponse
  - `data` CustomIndexPoint[], required
    - `timestamp` string, required: UTC interval start.
    - `index_id` string, required
    - `index_name` string, required
    - `gpu_family` string, required
    - `gpu_model` string, required
    - `region_group` string, required
    - `contract_type` string, required
    - `vendor_category` string, required
    - `index_value` number, required
    - `blended_value` number, required
    - `index_units` string, required
    - `p5` number, required
    - `p95` number, required
  - `total_count` integer, required
  - `filters` object, required
  - `index_name` string, nullable
  - `resolution` string
  - `returned_count` integer
  - `limit` integer
  - `offset` integer
  - `has_more` boolean
  - `next_offset` integer, nullable

## Other responses

- `400`: Invalid or unsupported query parameter.
- `401`: Missing or invalid API key.
- `404`: Unknown endpoint, unavailable resource, or an index or index family outside your authorization.
- `429`: Rate limit exceeded.
- `502`: Upstream service or gateway configuration failure.
- `503`: API-key validation is temporarily unavailable.

---

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