Sprite sheet manifest (JSON) for a token list
const url = 'https://gib.show/sprite/example/example?size=32&cols=25&limit=500&content=mixed&scale=1&gap=0&bg=ffffff&shape=circle&contrast=dark';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://gib.show/sprite/example/example?size=32&cols=25&limit=500&content=mixed&scale=1&gap=0&bg=ffffff&shape=circle&contrast=dark'Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Provider slug (e.g. pulsex, coingecko, trustwallet; user submissions are prefixed user-).
Provider’s list slug (e.g. extended).
Query Parameters
Section titled “Query Parameters”Cell size in CSS pixels.
Grid columns.
Maximum tokens. A request with a plate is cut to 500.
Content=mixed inlines vector images as data addresses instead of placing them on the grid.
Filter to one chain.
Sheet pixels per CSS pixel. 2 draws the sheet at twice the resolution for dense screens; positions and sizes stay in CSS pixels. Any value other than 2 means 1.
Space between cells, in CSS pixels, so neighbouring logos do not touch and a scaled page cannot bleed one into another. Scaled with the sheet. Any value outside 0 to 32 answers 400.
Paint a plate of this colour behind the logo: 3, 6 or 8 hex digits without #, the last two of eight being alpha (for example ffffff, f80, 00000080). Any other value answers 400. A vector image stays a vector (image/svg+xml) unless as asks for pixels. With as=svg, a vector image that has no usable viewBox cannot take a plate as a vector, and the answer is 404 and not a png. A plate drawn to pixels is never wider than 2048 pixels: a larger logo is shrunk to fit. With contrast as well, bg is the plate colour and contrast decides whether the plate appears.
The outline of the plate. Only used together with bg or contrast; on its own it is checked and then ignored. Any other value answers 400.
Say whether your page is dark or light. Gib looks at what share of the visible pixels of the logo have at least 3:1 contrast with that page, and adds a plate in the opposite tone (light on dark, dark on light) only when that share is under 25 percent, so a logo with some strong parts is left alone. Otherwise the image is served as if the parameter were absent. If the logo cannot be measured, the plain image is sent with cache-control: no-store. Any other value answers 400.
Responses
Section titled “Responses”Manifest mapping token keys to grid coordinates (or inline data addresses). Its spriteUrl and stylesheetUrl both carry the layout version. Kept five minutes.
object
Sheet address, pinned to the layout version.
Stylesheet address for the same layout.
Layout version. Changes when a token moves or the gap or plate changes.
Space between cells, in CSS pixels.
The plate behind each cell, or null.
ChainId-address → [col, row] grid coordinates, or an inline SVG data URI when content=mixed.
object
Example
{ "scale": 1}A gap, plate colour, shape or tone that is not valid.
object
Example generated
{ "error": "example"}Unknown provider or list.
object
Example generated
{ "error": "example"}