Skip to main content
GET /v1/market-display returns the name and pictures of up to 100 markets, given their outcome IDs. It needs no key and allows every origin, so your page can call it from the browser. Live, resolved and delisted markets all answer, so a position’s legs and an old fill keep their pictures. These are the pictures the Totalis app draws, picked by the same rules, so a market looks the same on your page as in the app.

Ask

outcome_ids holds the IDs comma-separated, in ascending order, with no repeats. Anything else is 400 INVALID_QUERY. Ask once per screen with every market it shows. With the SDK:

Read the answer

Which picture where

Draw a picture

A picture is one of three things: For a subject with an image:
  • fit: "ICON" is a logo on a transparent square. Draw it whole, inset in its circle.
  • fit: "PHOTO" covers the whole square, such as a portrait or a flag. Let it fill the circle.
  • variants are square WebP files at 64, 128 and 256 pixels. Pick the smallest one at least as large as the rendered size times the device pixel ratio. A URL never changes content, so cache it forever.
  • Show the coin with its monogram while the image loads, and keep it if the image fails.
  • Use label as alternative text.
palette, when present, lists up to three of the image’s colors in Oklch, most used first, such as oklch(0.5718 0.2124 22.2142) in CSS. Color a chart line with its side’s own subject’s first color. A chart with one line and no own image takes market’s colors. A side whose pick is a glyph, or whose image has no palette, keeps your default color. Pictures are decoration. They never carry prices, state or results.

Caching

An answer with nothing pending and an imagery_publication is Cache-Control: public, max-age=60. Any other answer is no-store. A browser caches by these headers on its own. From a server, send an answer’s ETag back as If-None-Match to get 304 when nothing changed. Picture files are immutable. List markets and List questions give you the outcome IDs to ask for. The full schema is on Get market display.