---
title: "List it: a market on one index, ready to paste"
method: GET
path: "/indices/{ticker}/listing.json"
tags: ["Index"]
---

# List it: a market on one index, ready to paste

`GET /indices/{ticker}/listing.json`

## Request

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

A market on the index's next print, ready to paste: the question with {strike} left open, the strikes, when and on what it settles, the tie rule, and where the settlement file, its mirror, the proof and the recount live. Offered for LAYOFFS, MINTS, GIGS and WAGE. When the record cannot be read the kit is built from the public mirror's settlement file and the answer carries X-Tickerz-Source: mirror.

## Path parameters

- `ticker` string, required

## Response `200`

The listing kit

- ListingKit
  - `ticker` string, required: The index, without the $
  - `name` string, required: The index's name
  - `counts` string, required: What the number counts
  - `unit` string, required: The unit of the level, plural
  - `period` string, date, required: The period the market is written on: the next UTC day, or the Saturday a week ends on, that has not begun
  - `period_kind` 'day' | 'week', required
  - `question` string, required: One sentence to paste. {strike} is left to fill with one of strikes
  - `strikes` number[], nullable, required: The 10th, 30th, 50th, 70th and 90th percentiles of the last 30 numbers as first published, linear between ranks, two significant digits, ascending. Equal strikes are listed once. Null under 14 of them
  - `strikes_from` object, required
    - `prints` integer, required: Published numbers the strikes were read from, 30 at most
    - `through` string, date, nullable, required: The newest of them
  - `settle_time_utc` string, date-time, nullable, required: When the number for period is first published: the daily proof on the day after a daily period. Null for the weekly index, where settle_rule gives the window
  - `settle_rule` string, required: The number as first published, in column settlement_value of the settlement file settles the market. A later revision by the source never changes it
  - `tie_rule` string, required: A print equal to the strike resolves No
  - `fallback` string, required: What happens when the source is late or never lands, from the rulebook
  - `precision` string, required: The unit and the rounding, from the rulebook
  - `grade` 'candidate' | 'reference' | 'display', required
  - `rulebook` string, required: The rulebook version the words belong to
  - `source_url` string, uri, required: The source a reader can check
  - `settlement_file` string, uri, required: GET /indices/{ticker}/history.csv
  - `mirror_file` string, uri, required: The same settlement file on the public mirror
  - `proof` string, uri, required: GET /indices/proof, the newest daily proof
  - `recount` object, nullable, required: The commands that recount a print from the chain with the open repo. Null where no recount exists
    - `repo` string, uri, required: The open repo
    - `guide` string, uri, required: Its instructions for this index
    - `setup` string[], required
    - `this_period` string, required: The command for the market's period, to run once it is complete
    - `newest_print` string, nullable, required: The command for the newest published number on file
  - `next_print_at` string, date-time, nullable, required: The next daily proof run. Null while one is pending, and for the weekly index
  - `paste` string, required: The whole market as plain text, under 600 characters
  - `license` string, required: Showing the number is free. Settling real money on it is licensed, with the pricing page
  - `url` string, uri, required: The List it section on the index page

## Other responses

- `404`: no_kit: the index offers no listing kit, with the reason in detail. 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: neither the record nor the mirror could 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)