---
title: "One index in full"
method: GET
path: "/indices/{ticker}"
tags: ["Index"]
---

# One index in full

`GET /indices/{ticker}`

## Request

- Base URL: `https://tickerz.com/api/v1`
- URL: `https://tickerz.com/api/v1/indices/{ticker}`
- Auth: none declared

Every period with its settlement value (the number as first published) and any later revision beside it, the open round and the newest proof.

## Path parameters

- `ticker` string, required

## Response `200`

One index

- IndexDetailResponse: One index as GET /indices serves it.
  - `ticker` string
  - `name` string
  - `counts` string
  - `unit` string
  - `cadence` string
  - `period` 'day' | 'week'
  - `source` object
    - `name` string
    - `url` string
    - `terms` string
    - `terms_url` string, nullable
    - `attribution` string, nullable
  - `latest` object, nullable: The newest period read, provisional or not
    - `period` string
    - `value` number, nullable
    - `provisional` boolean
    - `change_pct` number, nullable
    - `change_vs` string, nullable
    - `score` number, nullable
    - `z` number, nullable
  - `latest_complete` object, nullable: The newest complete period
    - `period` string
    - `value` number, nullable
    - `score` number, nullable
    - `z` number, nullable
    - `band` string, nullable
  - `settlement` object: The settlement rule; see_only is true where a count of harm is published and never called
    - `grade` 'candidate' | 'reference' | 'display'
    - `see_only` boolean
    - `version` string
  - `url` string, uri
  - `spark` object[]: The last 30 complete periods
    - `period` string
    - `value` number, nullable
    - `band` string, nullable
  - `first_print` object, nullable: The newest complete period as first recorded on-chain: final for settlement
    - `period` string
    - `value` number, nullable
    - `sealed_day` string, nullable
    - `digest_sha256` string, nullable
    - `bitcoin_height` integer, nullable
    - `proof_url` string, nullable
  - `days` object[]
    - `period` string
    - `value` number, nullable
    - `provisional` boolean
    - `change_pct` number, nullable
    - `band` string, nullable
    - `z` number, nullable
    - `settlement_value` number, nullable
    - `revised` string
    - `note` string: On jobs, unemp, cpi and corecpi only: set on a month loaded as history. Its value is the Bureau of Labor Statistics figure now, it is not the number as first published, and settlement_value is null.
  - `round` object, nullable: The open call, points only, no money
  - `seal` object, nullable
    - `day` string
    - `digest_sha256` string
    - `stamped_at` string
    - `bitcoin_height` integer, nullable
  - `forecast` object, nullable: Forecast v1: the next period's 80% range (p10 to p90) and its middle (p50), from the daily model run in tickerz-open. Display only, never a settled number. null when none.
    - `period` string
    - `p10` number
    - `p50` number
    - `p90` number
    - `model` string
    - `generated_at` string
    - `backtest` object
      - `periods` integer
      - `coverage_80` number
      - `skill_vs_last_number` number, nullable
    - `live` object
      - `scored` integer
      - `inside_80` integer
    - `display_only` boolean
    - `record_url` string

## Other responses

- `404`: not_found: no index with that ticker
- `429`: rate_limited: the address passed the limit named in RateLimit-Policy
- `500`: internal_error: the server failed to answer
- `503`: halted: the record could not be read

---

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