GET /v1/pictures/strata/{widget}.webp
#GET /v1/pictures/strata/{widget}.webpgetStrataPictureWebp
A Strata widget as a WebP picture (lossy, about 8 times smaller)
Answers the image, not the JSON envelope (errors stay JSON). The widget is drawn by the Strata page's own code from the same data, in a headless browser, and photographed (each widget takes the controls the page offers it: 400 not_applicable for others). layout=frame (the default since 1.3.10 for the widgets that have a frame: levels, heatmap, netpos, replay, hl, realized, screener, calibration, blocks, oi, terrain, whales, funding, fundclock, context, divergence and the cross-coin widgets) is a picture made for posting: a fixed 16:9 frame (the table-like widgets: as tall as their content), 1600 x 900 CSS px at scale 2 (3200 x 1800 pixels) by default, with no buttons or small print, in two looks: style=flat (default: a flat black frame, the chart edge to edge in crisp rows with a color scale bar, the key numbers as text lines above it) or style=glass (a title line and the key numbers in glass blocks inside the chart). Both name the widget, coin, venue, window and the draw time in UTC. layout=page is the card exactly as a member sees it on the page. A widget with nothing to draw for the request (an unknown coin, no data for the venue or window) answers 404 no_data, never a picture of an empty card. The sources of the data it shows are in X-Attribution (show them yourself: Terms Section 9); attribution=strip also prints them in the picture (the default is header, a clean picture, since 1.3.10). One render per parameter set and data version per 45 s, shared by every caller: Cache-Control: private, max-age=<seconds left>; a cached picture costs the same. Pictures per key per minute: Starter 20, Developer 60, Business 120 (429 picture_rate_limited); since 1.3.10 a picture counts toward the monthly units only, not against the units-per-minute limit. Under load or while the renderer is down: 503 with Retry-After, never a wrong picture. WebP = lossy, quality 90: about 8 times smaller than the PNG, not pixel-exact.
| Scope | charts:read |
|---|---|
| Lowest tier | sandbox |
| Weight (units) | 20 at any size and scale; +5 for window=30d |
| SDK | Python client.pictures.strata_webp · JavaScript cd.pictures.strataWebp |
Parameters
| Parameter | In | Type | Description |
|---|---|---|---|
widget required | path | "levels" | "heatmap" | "replay" | "hl" | "realized" | "netpos" | "whales" | "funding" | "screener" | "context" | "calibration" | "blocks" | "oi" | "series" | "expertgrid" | "terrain" | "fundclock" | "rankmap" | "quadrant" | "correlation" | "paircorr" | "spaghetti" | "distribution" | "profiles" | "coinmatrix" | "stacker" | "timegrid" | "coinpulse" | "divergence" | The Strata widget, as the card is named on the page. |
coin | query | stringdefault "BTC" | Base coin of the USDT perpetual (BTC, ETH, 1000PEPE); symbol=BTCUSDT is read the same. Widgets: levels, heatmap, replay, hl, realized, netpos, funding, context, calibration, series, terrain, fundclock, rankmap, quadrant, correlation, paircorr, spaghetti, distribution, profiles, coinmatrix, stacker, timegrid, coinpulse, divergence. |
venue | query | "all" | "binance" | "bybit" | "okx" | "bitget" | "blofin" | "hyperliquid" | "mexc" | "gate" | "kucoin" | "krakenfutures" | "dydx" | "woox" | "backpack" | "coinbase" | "bingx" | "aster"default "all" | All venues (guarded) or one venue: the page’s Venue select. Widgets: levels, heatmap, replay, realized, netpos, calibration, terrain. |
window | query | "7d" | "30d"default "7d" | History: 7D, or 30D where the tier has it. Widgets: levels, heatmap, replay, realized, netpos, funding, calibration, series, terrain. |
half_life | query | integerdefault 48 | Half-life in hours (the Half-life slider). Widgets: levels, heatmap, replay, terrain. Whole number 6 to 168 in steps of 6. |
threshold | query | integerdefault 0 | Hide cells below this % of the peak (the Threshold slider). Widgets: levels, heatmap, replay, terrain. Whole number 0 to 60 in steps of 2. |
side | query | "both" | "long" | "short"default "both" | Which side of the book (the Side buttons). Widgets: levels, heatmap, replay, realized, terrain. |
theme | query | "dark" | "light"default "dark" | The page’s dark or light theme. |
lang | query | "en" | "es" | "pt-BR" | "fr" | "de" | "it" | "tr" | "ru" | "uk" | "zh-CN" | "zh-TW" | "ja" | "ko" | "hi" | "ar" | "id" | "vi"default "en" | Language of the card’s words (the page’s 17 languages). |
layout | query | "frame" | "page"default "frame" | frame (default since 1.3.10) = the share picture: a fixed frame with a title line, the stat blocks inside the chart and no controls or small print; page = the card exactly as the Strata page draws it. A widget that has no frame picture yet is drawn as page. |
style | query | "flat" | "glass"default "flat" | layout=frame only (a page card reads it and changes nothing; a widget that has only the flat look answers flat for either value): flat (default) = a flat black frame, the chart edge to edge with crisp rows, a color scale bar at the left and the key numbers as text lines above the chart; glass = a title line and the key numbers in glass blocks inside the chart. |
width | query | integer | Picture width in CSS pixels. layout=frame: the frame’s width (default 1600; the same composition at any width, only larger or smaller). layout=page: the card’s width on the page (default 1200; the browser window is 32 px wider) and the height follows the card. Whole number 360 to 2400. |
height | query | integer | layout=frame only: the frame’s height in CSS pixels (default: 16:9 of the width, 900 at 1600). The width must be 1 to 3 times the height. Refused by the table-like widgets (realized, screener, calibration, blocks, oi, context, expertgrid), whose picture is as tall as its content. Whole number 240 to 2400. |
scale | query | "1" | "2" | Device pixel ratio: 2 doubles every pixel dimension (sharper text), at the same price. Default: 2 for layout=frame (3200 x 1800 pixels at the default size), 1 for layout=page. |
attribution | query | "strip" | "header"default "header" | Sources only in the X-Attribution header (header, default since 1.3.10: you show them yourself, Terms Section 9) or also printed under the card (strip). |
span | query | "wide" | "half" | layout=page only (a frame picture reads it and changes nothing): the card’s width class on the page (Edit layout): wide = a full row, half = half a row (smaller charts). Default = the widget’s own default. |
bands | query | "6" | "10" | "16"default "10" | Bands drawn. Widget: stacker. |
bars | query | "12" | "24" | "36"default "24" | Rolling window in bars. Widget: paircorr. |
color | query | "distance" | "cohort"default "distance" | Level colors: distance from price, or leverage cohort (where the venues export it). Default: distance; cohort in a style=flat frame picture. Widget: levels. |
estimate | query | booleandefault false | Scale sizes by the sweep coverage estimate. Widget: hl. |
field | query | "net" | "long" | "short" | "chg"default "net" | Net, longs, shorts or change. Widget: whales. |
hours | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: rankmap, quadrant, correlation, paircorr, spaghetti, distribution, profiles, coinmatrix, stacker, timegrid, coinpulse, divergence. |
indicator | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: rankmap, correlation, paircorr, spaghetti, distribution, profiles, stacker. |
metric | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: netpos, divergence. |
mode | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: realized, rankmap, quadrant, distribution, coinmatrix, timegrid. |
model | query | booleandefault true | Show the model overlay. Widget: hl. |
order | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: rankmap, correlation. |
pair | query | string | The second coin (default: the biggest other book). 1.2.9: named pair, not with (a keyword in Python). Widget: paircorr. |
period | query | "0" | "12" | "24"default "0" | Last 12 h, 24 h, or everything in the window (0). Widget: realized. |
ramp | query | "heat" | "viridis"default "heat" | Color ramp: the heatmap’s, or Viridis. Widget: terrain. |
range | query | "full" | "25" | "10"default "full" | Price range: full book, ±25 %, ±10 %. Widget: hl. |
rows | query | "24" | "40" | "60"default "40" | Price rows (capped by the data). Widget: profiles. |
scope | query | "sym" | "all"default "all" | This coin, or all tracked coins. Widget: realized. |
show | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: spaghetti, stacker. |
sort | query | "oi" | "oi24h" | "px24h" | "fund" | "lsr" | "liq" | Sort column (default: the page’s, open interest). Widget: screener. |
split | query | "auto" | "zero" | "median" | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: quadrant, coinmatrix. |
step | query | integerdefault -1 | Replay column (0 = oldest, -1 = now). Widget: replay. Whole number -1 to 10000. |
third_as | query | "size" | "color" | "both"default "both" | The third reading as dot size, color or both. Widget: coinmatrix. |
unit | query | "apr" | "8h" | "raw"default "apr" | APR, per 8 h, or the venue’s raw rate. Widget: funding. |
value_area | query | "60" | "70" | "80"default "70" | Value area, % of the mass. Widget: profiles. |
view | query | "rate" | "cum"default "rate" | Rate, or the accrual over the window. Widget: funding. |
x | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: quadrant, coinmatrix. |
y | query | string | A widget's own control; its values and default depend on the widget (see the widget table). Widgets: quadrant, coinmatrix. |
z | query | stringdefault "oi" | Third (in the dots): any of the 34 indicators, optionally @1h (flows, and the levels open interest, price, L/S ratios, OI share, funding, taker buy ratio, basis, premium, sentiment gap, whale dominance, net L/S, net OI) / @4h / @1d / @1w / @1M anchored. Widget: coinmatrix. |
Errors
400invalid_param, unknown_param, not_applicable401unauthorized: missing, unknown, revoked or expired key403insufficient_scope, tier_required404unknown_widget, no_data (nothing to draw for this coin, venue or window), pictures_unavailable, not_in_sandbox422window_too_large429picture_rate_limited (pictures per key per minute) or quota_exhausted (month); see Retry-After503api_disabled, overloaded, render_busy, render_timeout, renderer_unavailable, upstream_unavailable (502 picture_failed)
Example
curl "https://api.chartdeck.trade/v1/pictures/strata/levels.webp" \
-H "Authorization: Bearer $CHARTDECK_API_KEY"from chartdeck import Client
client = Client() # reads CHARTDECK_API_KEY
r = client.pictures.strata_webp("<widget>")
print(r.data, r.meta["attribution"])import { ChartDeck } from '@chartdeck/api';
const cd = new ChartDeck(); // reads CHARTDECK_API_KEY
const r = await cd.pictures.strataWebp("<widget>");
console.log(r.data, r.meta.attribution);