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.variantsare 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
monogramwhile the image loads, and keep it if the image fails. - Use
labelas 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 nothingpending 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.
