Graflume · Alpha

Candlestick

Display open, high, low, close, and price direction for each period.

Chart family · Default families

Candlestick

Display open, high, low, close, and price direction for each period.

Quick API
candlestick()
Browser snapshot
graflume
mark
candlestick
Presets
5

Basic implementation

The smallest runnable chart

Start with only the required data and family encoding. Expand the code to run the same example.

Basic example

Display open, high, low, close, and price direction for each period.

StatusLoading

  • minimal-implementation
Graflume.candlestick() Canvas 2D
Control help

Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.

Use Tab to reach a control and Enter or Space to activate it. With the chart focused, use plus and minus to zoom and arrow keys to pan.

Auto placement compares perimeter candidates and avoids the plot, legend, and other callouts when possible. Explicit placement is preserved with only necessary safety correction. Callout text wraps safely inside the bubble. Long unbroken tokens are visually shortened within the line budget, while the complete source text remains available to assistive technology.

Loading

Browser API · Portable schema

Browser API

Graflume.candlestick()

const data = [
  {
    "close": 95.1,
    "date": "2025-01-01",
    "high": 96.3,
    "low": 92.9,
    "open": 94,
    "value": 95.1,
    "volume": 1070
  },
  {
    "close": 96.4177,
    "date": "2025-01-02",
    "high": 97.6977,
    "low": 94.6097,
    "open": 95.7997,
    "value": 96.4177,
    "volume": 1144
  },
  {
    "close": 97.4641,
    "date": "2025-01-03",
    "high": 98.8241,
    "low": 96.0986,
    "open": 97.3786,
    "value": 97.4641,
    "volume": 1217
  },
  {
    "close": 98.1631,
    "date": "2025-01-04",
    "high": 100.0024,
    "low": 96.7931,
    "open": 98.5624,
    "value": 98.1631,
    "volume": 1287
  },
  {
    "close": 98.4747,
    "date": "2025-01-05",
    "high": 100.7522,
    "low": 97.3747,
    "open": 99.2322,
    "value": 98.4747,
    "volume": 1353
  },
  {
    "close": 98.3969,
    "date": "2025-01-06",
    "high": 100.5404,
    "low": 97.2069,
    "open": 99.3404,
    "value": 98.3969,
    "volume": 1415
  },
  {
    "close": 97.9643,
    "date": "2025-01-07",
    "high": 100.1938,
    "low": 96.6843,
    "open": 98.9138,
    "value": 97.9643,
    "volume": 1470
  },
  {
    "close": 97.2423,
    "date": "2025-01-08",
    "high": 99.4061,
    "low": 95.8723,
    "open": 98.0461,
    "value": 97.2423,
    "volume": 1519
  },
  {
    "close": 96.3192,
    "date": "2025-01-09",
    "high": 98.3193,
    "low": 95.2192,
    "open": 96.8793,
    "value": 96.3192,
    "volume": 1562
  },
  {
    "close": 95.296,
    "date": "2025-01-10",
    "high": 97.0993,
    "low": 94.106,
    "open": 95.5793,
    "value": 95.296,
    "volume": 1598
  },
  {
    "close": 94.2766,
    "date": "2025-01-11",
    "high": 95.5096,
    "low": 92.9966,
    "open": 94.3096,
    "value": 94.2766,
    "volume": 1629
  },
  {
    "close": 93.3576,
    "date": "2025-01-12",
    "high": 94.6376,
    "low": 91.8392,
    "open": 93.2092,
    "value": 93.3576,
    "volume": 1656
  },
  {
    "close": 92.62,
    "date": "2025-01-13",
    "high": 93.98,
    "low": 91.2761,
    "open": 92.3761,
    "value": 92.62,
    "volume": 1679
  },
  {
    "close": 92.1232,
    "date": "2025-01-14",
    "high": 93.5632,
    "low": 90.6709,
    "open": 91.8609,
    "value": 92.1232,
    "volume": 1699
  },
  {
    "close": 91.9016,
    "date": "2025-01-15",
    "high": 93.4216,
    "low": 90.389,
    "open": 91.669,
    "value": 91.9016,
    "volume": 1106
  },
  {
    "close": 91.9631,
    "date": "2025-01-16",
    "high": 93.1631,
    "low": 90.4003,
    "open": 91.7703,
    "value": 91.9631,
    "volume": 1126
  },
  {
    "close": 92.2911,
    "date": "2025-01-17",
    "high": 93.5711,
    "low": 91.0131,
    "open": 92.1131,
    "value": 92.2911,
    "volume": 1147
  },
  {
    "close": 92.8475,
    "date": "2025-01-18",
    "high": 94.2075,
    "low": 91.4492,
    "open": 92.6392,
    "value": 92.8475,
    "volume": 1173
  },
  {
    "close": 93.5779,
    "date": "2025-01-19",
    "high": 95.0179,
    "low": 92.0148,
    "open": 93.2948,
    "value": 93.5779,
    "volume": 1202
  },
  {
    "close": 94.4172,
    "date": "2025-01-20",
    "high": 95.9372,
    "low": 92.6673,
    "open": 94.0373,
    "value": 94.4172,
    "volume": 1237
  },
  {
    "close": 95.2956,
    "date": "2025-01-21",
    "high": 96.4956,
    "low": 93.7355,
    "open": 94.8355,
    "value": 95.2956,
    "volume": 1278
  },
  {
    "close": 96.1441,
    "date": "2025-01-22",
    "high": 97.4241,
    "low": 94.4743,
    "open": 95.6643,
    "value": 96.1441,
    "volume": 1325
  },
  {
    "close": 96.8995,
    "date": "2025-01-23",
    "high": 98.2595,
    "low": 95.2164,
    "open": 96.4964,
    "value": 96.8995,
    "volume": 1378
  },
  {
    "close": 97.5083,
    "date": "2025-01-24",
    "high": 98.9483,
    "low": 95.9247,
    "open": 97.2947,
    "value": 97.5083,
    "volume": 1437
  },
  {
    "close": 97.9299,
    "date": "2025-01-25",
    "high": 99.5269,
    "low": 96.8299,
    "open": 98.0069,
    "value": 97.9299,
    "volume": 1502
  },
  {
    "close": 98.1388,
    "date": "2025-01-26",
    "high": 99.7662,
    "low": 96.9488,
    "open": 98.5662,
    "value": 98.1388,
    "volume": 1571
  },
  {
    "close": 98.1252,
    "date": "2025-01-27",
    "high": 100.1787,
    "low": 96.8452,
    "open": 98.8987,
    "value": 98.1252,
    "volume": 1643
  },
  {
    "close": 97.8956,
    "date": "2025-01-28",
    "high": 100.2955,
    "low": 96.5256,
    "open": 98.9355,
    "value": 97.8956,
    "volume": 1104
  },
  {
    "close": 97.4723,
    "date": "2025-01-29",
    "high": 100.0688,
    "low": 96.3723,
    "open": 98.6288,
    "value": 97.4723,
    "volume": 1179
  },
  {
    "close": 96.8921,
    "date": "2025-01-30",
    "high": 99.4875,
    "low": 95.7021,
    "open": 97.9675,
    "value": 96.8921,
    "volume": 1252
  },
  {
    "close": 96.2043,
    "date": "2025-01-31",
    "high": 98.1891,
    "low": 94.9243,
    "open": 96.9891,
    "value": 96.2043,
    "volume": 1323
  },
  {
    "close": 95.4682,
    "date": "2025-02-01",
    "high": 97.0627,
    "low": 94.0982,
    "open": 95.7827,
    "value": 95.4682,
    "volume": 1391
  },
  {
    "close": 94.7495,
    "date": "2025-02-02",
    "high": 96.1095,
    "low": 93.3846,
    "open": 94.4846,
    "value": 94.7495,
    "volume": 1454
  },
  {
    "close": 94.1163,
    "date": "2025-02-03",
    "high": 95.5563,
    "low": 92.0724,
    "open": 93.2624,
    "value": 94.1163,
    "volume": 1511
  },
  {
    "close": 93.6345,
    "date": "2025-02-04",
    "high": 95.1545,
    "low": 91.0128,
    "open": 92.2928,
    "value": 93.6345,
    "volume": 1562
  },
  {
    "close": 93.3624,
    "date": "2025-02-05",
    "high": 94.5624,
    "low": 90.3642,
    "open": 91.7342,
    "value": 93.3624,
    "volume": 1607
  },
  {
    "close": 93.3458,
    "date": "2025-02-06",
    "high": 94.6258,
    "low": 90.6009,
    "open": 91.7009,
    "value": 93.3458,
    "volume": 1645
  },
  {
    "close": 93.6128,
    "date": "2025-02-07",
    "high": 94.9728,
    "low": 91.0527,
    "open": 92.2427,
    "value": 93.6128,
    "volume": 1678
  },
  {
    "close": 94.1706,
    "date": "2025-02-08",
    "high": 95.6106,
    "low": 92.0536,
    "open": 93.3336,
    "value": 94.1706,
    "volume": 1706
  },
  {
    "close": 95.0024,
    "date": "2025-02-09",
    "high": 96.5224,
    "low": 93.5031,
    "open": 94.8731,
    "value": 95.0024,
    "volume": 1730
  },
  {
    "close": 96.0672,
    "date": "2025-02-10",
    "high": 97.8995,
    "low": 94.9672,
    "open": 96.6995,
    "value": 96.0672,
    "volume": 1138
  },
  {
    "close": 97.3012,
    "date": "2025-02-11",
    "high": 99.8932,
    "low": 96.1112,
    "open": 98.6132,
    "value": 97.3012,
    "volume": 1157
  },
  {
    "close": 98.6223,
    "date": "2025-02-12",
    "high": 101.7664,
    "low": 97.3423,
    "open": 100.4064,
    "value": 98.6223,
    "volume": 1177
  },
  {
    "close": 99.9361,
    "date": "2025-02-13",
    "high": 103.3339,
    "low": 98.5661,
    "open": 101.8939,
    "value": 99.9361,
    "volume": 1198
  },
  {
    "close": 101.1441,
    "date": "2025-02-14",
    "high": 104.4588,
    "low": 100.0441,
    "open": 102.9388,
    "value": 101.1441,
    "volume": 1222
  },
  {
    "close": 102.1532,
    "date": "2025-02-15",
    "high": 104.671,
    "low": 100.9632,
    "open": 103.471,
    "value": 102.1532,
    "volume": 1250
  },
  {
    "close": 102.8851,
    "date": "2025-02-16",
    "high": 104.773,
    "low": 101.6051,
    "open": 103.493,
    "value": 102.8851,
    "volume": 1283
  },
  {
    "close": 103.2854,
    "date": "2025-02-17",
    "high": 104.6454,
    "low": 101.7045,
    "open": 103.0745,
    "value": 103.2854,
    "volume": 1322
  },
  {
    "close": 103.3306,
    "date": "2025-02-18",
    "high": 104.7706,
    "low": 101.2366,
    "open": 102.3366,
    "value": 103.3306,
    "volume": 1367
  },
  {
    "close": 103.0322,
    "date": "2025-02-19",
    "high": 104.5522,
    "low": 100.2392,
    "open": 101.4292,
    "value": 103.0322,
    "volume": 1418
  },
  {
    "close": 102.4378,
    "date": "2025-02-20",
    "high": 103.6378,
    "low": 99.226,
    "open": 100.506,
    "value": 102.4378,
    "volume": 1476
  },
  {
    "close": 101.6282,
    "date": "2025-02-21",
    "high": 102.9082,
    "low": 98.3323,
    "open": 99.7023,
    "value": 101.6282,
    "volume": 1539
  },
  {
    "close": 100.7105,
    "date": "2025-02-22",
    "high": 102.0705,
    "low": 98.0185,
    "open": 99.1185,
    "value": 100.7105,
    "volume": 1607
  },
  {
    "close": 99.8085,
    "date": "2025-02-23",
    "high": 101.2485,
    "low": 97.6227,
    "open": 98.8127,
    "value": 99.8085,
    "volume": 1065
  },
  {
    "close": 99.0497,
    "date": "2025-02-24",
    "high": 100.5697,
    "low": 97.521,
    "open": 98.801,
    "value": 99.0497,
    "volume": 1138
  },
  {
    "close": 98.5523,
    "date": "2025-02-25",
    "high": 100.2666,
    "low": 97.1823,
    "open": 99.0666,
    "value": 98.5523,
    "volume": 1213
  },
  {
    "close": 98.4121,
    "date": "2025-02-26",
    "high": 100.8514,
    "low": 97.3121,
    "open": 99.5714,
    "value": 98.4121,
    "volume": 1287
  },
  {
    "close": 98.6906,
    "date": "2025-02-27",
    "high": 101.63,
    "low": 97.5006,
    "open": 100.27,
    "value": 98.6906,
    "volume": 1359
  },
  {
    "close": 99.4076,
    "date": "2025-02-28",
    "high": 102.5602,
    "low": 98.1276,
    "open": 101.1202,
    "value": 99.4076,
    "volume": 1428
  },
  {
    "close": 100.5364,
    "date": "2025-03-01",
    "high": 103.6082,
    "low": 99.1664,
    "open": 102.0882,
    "value": 100.5364,
    "volume": 1492
  },
  {
    "close": 102.0054,
    "date": "2025-03-02",
    "high": 104.3483,
    "low": 100.9054,
    "open": 103.1483,
    "value": 102.0054,
    "volume": 1551
  },
  {
    "close": 103.704,
    "date": "2025-03-03",
    "high": 105.5579,
    "low": 102.514,
    "open": 104.2779,
    "value": 103.704,
    "volume": 1604
  },
  {
    "close": 105.4928,
    "date": "2025-03-04",
    "high": 106.8528,
    "low": 104.1683,
    "open": 105.4483,
    "value": 105.4928,
    "volume": 1651
  },
  {
    "close": 107.218,
    "date": "2025-03-05",
    "high": 108.658,
    "low": 105.247,
    "open": 106.617,
    "value": 107.218,
    "volume": 1692
  }
];

const options = {
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
};

Graflume.candlestick('#chart', data, options);

Portable schema

ChartSpec 0.1 · options

{
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
}

Common features

Features shared by every chart

Use the tabs to compare header, tooltip, theme, legend, highlight, callout, selection, view controls, and accessibility one feature at a time. Hover over a data mark. On supported charts, move the pointer along the axis to see the nearest value. All exact values are available in the table below.

Header

Add a chart title and supporting description inside the visualization.

StatusLoading

  • header
Graflume.candlestick() Canvas 2D
Control help

Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.

Use Tab to reach a control and Enter or Space to activate it. With the chart focused, use plus and minus to zoom and arrow keys to pan.

Auto placement compares perimeter candidates and avoids the plot, legend, and other callouts when possible. Explicit placement is preserved with only necessary safety correction. Callout text wraps safely inside the bubble. Long unbroken tokens are visually shortened within the line budget, while the complete source text remains available to assistive technology.

Loading

Browser API · Portable schema

Browser API

Graflume.candlestick()

const data = [
  {
    "close": 95.1,
    "date": "2025-01-01",
    "high": 96.3,
    "low": 92.9,
    "open": 94,
    "value": 95.1,
    "volume": 1070
  },
  {
    "close": 96.4177,
    "date": "2025-01-02",
    "high": 97.6977,
    "low": 94.6097,
    "open": 95.7997,
    "value": 96.4177,
    "volume": 1144
  },
  {
    "close": 97.4641,
    "date": "2025-01-03",
    "high": 98.8241,
    "low": 96.0986,
    "open": 97.3786,
    "value": 97.4641,
    "volume": 1217
  },
  {
    "close": 98.1631,
    "date": "2025-01-04",
    "high": 100.0024,
    "low": 96.7931,
    "open": 98.5624,
    "value": 98.1631,
    "volume": 1287
  },
  {
    "close": 98.4747,
    "date": "2025-01-05",
    "high": 100.7522,
    "low": 97.3747,
    "open": 99.2322,
    "value": 98.4747,
    "volume": 1353
  },
  {
    "close": 98.3969,
    "date": "2025-01-06",
    "high": 100.5404,
    "low": 97.2069,
    "open": 99.3404,
    "value": 98.3969,
    "volume": 1415
  },
  {
    "close": 97.9643,
    "date": "2025-01-07",
    "high": 100.1938,
    "low": 96.6843,
    "open": 98.9138,
    "value": 97.9643,
    "volume": 1470
  },
  {
    "close": 97.2423,
    "date": "2025-01-08",
    "high": 99.4061,
    "low": 95.8723,
    "open": 98.0461,
    "value": 97.2423,
    "volume": 1519
  },
  {
    "close": 96.3192,
    "date": "2025-01-09",
    "high": 98.3193,
    "low": 95.2192,
    "open": 96.8793,
    "value": 96.3192,
    "volume": 1562
  },
  {
    "close": 95.296,
    "date": "2025-01-10",
    "high": 97.0993,
    "low": 94.106,
    "open": 95.5793,
    "value": 95.296,
    "volume": 1598
  },
  {
    "close": 94.2766,
    "date": "2025-01-11",
    "high": 95.5096,
    "low": 92.9966,
    "open": 94.3096,
    "value": 94.2766,
    "volume": 1629
  },
  {
    "close": 93.3576,
    "date": "2025-01-12",
    "high": 94.6376,
    "low": 91.8392,
    "open": 93.2092,
    "value": 93.3576,
    "volume": 1656
  },
  {
    "close": 92.62,
    "date": "2025-01-13",
    "high": 93.98,
    "low": 91.2761,
    "open": 92.3761,
    "value": 92.62,
    "volume": 1679
  },
  {
    "close": 92.1232,
    "date": "2025-01-14",
    "high": 93.5632,
    "low": 90.6709,
    "open": 91.8609,
    "value": 92.1232,
    "volume": 1699
  },
  {
    "close": 91.9016,
    "date": "2025-01-15",
    "high": 93.4216,
    "low": 90.389,
    "open": 91.669,
    "value": 91.9016,
    "volume": 1106
  },
  {
    "close": 91.9631,
    "date": "2025-01-16",
    "high": 93.1631,
    "low": 90.4003,
    "open": 91.7703,
    "value": 91.9631,
    "volume": 1126
  },
  {
    "close": 92.2911,
    "date": "2025-01-17",
    "high": 93.5711,
    "low": 91.0131,
    "open": 92.1131,
    "value": 92.2911,
    "volume": 1147
  },
  {
    "close": 92.8475,
    "date": "2025-01-18",
    "high": 94.2075,
    "low": 91.4492,
    "open": 92.6392,
    "value": 92.8475,
    "volume": 1173
  },
  {
    "close": 93.5779,
    "date": "2025-01-19",
    "high": 95.0179,
    "low": 92.0148,
    "open": 93.2948,
    "value": 93.5779,
    "volume": 1202
  },
  {
    "close": 94.4172,
    "date": "2025-01-20",
    "high": 95.9372,
    "low": 92.6673,
    "open": 94.0373,
    "value": 94.4172,
    "volume": 1237
  },
  {
    "close": 95.2956,
    "date": "2025-01-21",
    "high": 96.4956,
    "low": 93.7355,
    "open": 94.8355,
    "value": 95.2956,
    "volume": 1278
  },
  {
    "close": 96.1441,
    "date": "2025-01-22",
    "high": 97.4241,
    "low": 94.4743,
    "open": 95.6643,
    "value": 96.1441,
    "volume": 1325
  },
  {
    "close": 96.8995,
    "date": "2025-01-23",
    "high": 98.2595,
    "low": 95.2164,
    "open": 96.4964,
    "value": 96.8995,
    "volume": 1378
  },
  {
    "close": 97.5083,
    "date": "2025-01-24",
    "high": 98.9483,
    "low": 95.9247,
    "open": 97.2947,
    "value": 97.5083,
    "volume": 1437
  },
  {
    "close": 97.9299,
    "date": "2025-01-25",
    "high": 99.5269,
    "low": 96.8299,
    "open": 98.0069,
    "value": 97.9299,
    "volume": 1502
  },
  {
    "close": 98.1388,
    "date": "2025-01-26",
    "high": 99.7662,
    "low": 96.9488,
    "open": 98.5662,
    "value": 98.1388,
    "volume": 1571
  },
  {
    "close": 98.1252,
    "date": "2025-01-27",
    "high": 100.1787,
    "low": 96.8452,
    "open": 98.8987,
    "value": 98.1252,
    "volume": 1643
  },
  {
    "close": 97.8956,
    "date": "2025-01-28",
    "high": 100.2955,
    "low": 96.5256,
    "open": 98.9355,
    "value": 97.8956,
    "volume": 1104
  },
  {
    "close": 97.4723,
    "date": "2025-01-29",
    "high": 100.0688,
    "low": 96.3723,
    "open": 98.6288,
    "value": 97.4723,
    "volume": 1179
  },
  {
    "close": 96.8921,
    "date": "2025-01-30",
    "high": 99.4875,
    "low": 95.7021,
    "open": 97.9675,
    "value": 96.8921,
    "volume": 1252
  },
  {
    "close": 96.2043,
    "date": "2025-01-31",
    "high": 98.1891,
    "low": 94.9243,
    "open": 96.9891,
    "value": 96.2043,
    "volume": 1323
  },
  {
    "close": 95.4682,
    "date": "2025-02-01",
    "high": 97.0627,
    "low": 94.0982,
    "open": 95.7827,
    "value": 95.4682,
    "volume": 1391
  },
  {
    "close": 94.7495,
    "date": "2025-02-02",
    "high": 96.1095,
    "low": 93.3846,
    "open": 94.4846,
    "value": 94.7495,
    "volume": 1454
  },
  {
    "close": 94.1163,
    "date": "2025-02-03",
    "high": 95.5563,
    "low": 92.0724,
    "open": 93.2624,
    "value": 94.1163,
    "volume": 1511
  },
  {
    "close": 93.6345,
    "date": "2025-02-04",
    "high": 95.1545,
    "low": 91.0128,
    "open": 92.2928,
    "value": 93.6345,
    "volume": 1562
  },
  {
    "close": 93.3624,
    "date": "2025-02-05",
    "high": 94.5624,
    "low": 90.3642,
    "open": 91.7342,
    "value": 93.3624,
    "volume": 1607
  },
  {
    "close": 93.3458,
    "date": "2025-02-06",
    "high": 94.6258,
    "low": 90.6009,
    "open": 91.7009,
    "value": 93.3458,
    "volume": 1645
  },
  {
    "close": 93.6128,
    "date": "2025-02-07",
    "high": 94.9728,
    "low": 91.0527,
    "open": 92.2427,
    "value": 93.6128,
    "volume": 1678
  },
  {
    "close": 94.1706,
    "date": "2025-02-08",
    "high": 95.6106,
    "low": 92.0536,
    "open": 93.3336,
    "value": 94.1706,
    "volume": 1706
  },
  {
    "close": 95.0024,
    "date": "2025-02-09",
    "high": 96.5224,
    "low": 93.5031,
    "open": 94.8731,
    "value": 95.0024,
    "volume": 1730
  },
  {
    "close": 96.0672,
    "date": "2025-02-10",
    "high": 97.8995,
    "low": 94.9672,
    "open": 96.6995,
    "value": 96.0672,
    "volume": 1138
  },
  {
    "close": 97.3012,
    "date": "2025-02-11",
    "high": 99.8932,
    "low": 96.1112,
    "open": 98.6132,
    "value": 97.3012,
    "volume": 1157
  },
  {
    "close": 98.6223,
    "date": "2025-02-12",
    "high": 101.7664,
    "low": 97.3423,
    "open": 100.4064,
    "value": 98.6223,
    "volume": 1177
  },
  {
    "close": 99.9361,
    "date": "2025-02-13",
    "high": 103.3339,
    "low": 98.5661,
    "open": 101.8939,
    "value": 99.9361,
    "volume": 1198
  },
  {
    "close": 101.1441,
    "date": "2025-02-14",
    "high": 104.4588,
    "low": 100.0441,
    "open": 102.9388,
    "value": 101.1441,
    "volume": 1222
  },
  {
    "close": 102.1532,
    "date": "2025-02-15",
    "high": 104.671,
    "low": 100.9632,
    "open": 103.471,
    "value": 102.1532,
    "volume": 1250
  },
  {
    "close": 102.8851,
    "date": "2025-02-16",
    "high": 104.773,
    "low": 101.6051,
    "open": 103.493,
    "value": 102.8851,
    "volume": 1283
  },
  {
    "close": 103.2854,
    "date": "2025-02-17",
    "high": 104.6454,
    "low": 101.7045,
    "open": 103.0745,
    "value": 103.2854,
    "volume": 1322
  },
  {
    "close": 103.3306,
    "date": "2025-02-18",
    "high": 104.7706,
    "low": 101.2366,
    "open": 102.3366,
    "value": 103.3306,
    "volume": 1367
  },
  {
    "close": 103.0322,
    "date": "2025-02-19",
    "high": 104.5522,
    "low": 100.2392,
    "open": 101.4292,
    "value": 103.0322,
    "volume": 1418
  },
  {
    "close": 102.4378,
    "date": "2025-02-20",
    "high": 103.6378,
    "low": 99.226,
    "open": 100.506,
    "value": 102.4378,
    "volume": 1476
  },
  {
    "close": 101.6282,
    "date": "2025-02-21",
    "high": 102.9082,
    "low": 98.3323,
    "open": 99.7023,
    "value": 101.6282,
    "volume": 1539
  },
  {
    "close": 100.7105,
    "date": "2025-02-22",
    "high": 102.0705,
    "low": 98.0185,
    "open": 99.1185,
    "value": 100.7105,
    "volume": 1607
  },
  {
    "close": 99.8085,
    "date": "2025-02-23",
    "high": 101.2485,
    "low": 97.6227,
    "open": 98.8127,
    "value": 99.8085,
    "volume": 1065
  },
  {
    "close": 99.0497,
    "date": "2025-02-24",
    "high": 100.5697,
    "low": 97.521,
    "open": 98.801,
    "value": 99.0497,
    "volume": 1138
  },
  {
    "close": 98.5523,
    "date": "2025-02-25",
    "high": 100.2666,
    "low": 97.1823,
    "open": 99.0666,
    "value": 98.5523,
    "volume": 1213
  },
  {
    "close": 98.4121,
    "date": "2025-02-26",
    "high": 100.8514,
    "low": 97.3121,
    "open": 99.5714,
    "value": 98.4121,
    "volume": 1287
  },
  {
    "close": 98.6906,
    "date": "2025-02-27",
    "high": 101.63,
    "low": 97.5006,
    "open": 100.27,
    "value": 98.6906,
    "volume": 1359
  },
  {
    "close": 99.4076,
    "date": "2025-02-28",
    "high": 102.5602,
    "low": 98.1276,
    "open": 101.1202,
    "value": 99.4076,
    "volume": 1428
  },
  {
    "close": 100.5364,
    "date": "2025-03-01",
    "high": 103.6082,
    "low": 99.1664,
    "open": 102.0882,
    "value": 100.5364,
    "volume": 1492
  },
  {
    "close": 102.0054,
    "date": "2025-03-02",
    "high": 104.3483,
    "low": 100.9054,
    "open": 103.1483,
    "value": 102.0054,
    "volume": 1551
  },
  {
    "close": 103.704,
    "date": "2025-03-03",
    "high": 105.5579,
    "low": 102.514,
    "open": 104.2779,
    "value": 103.704,
    "volume": 1604
  },
  {
    "close": 105.4928,
    "date": "2025-03-04",
    "high": 106.8528,
    "low": 104.1683,
    "open": 105.4483,
    "value": 105.4928,
    "volume": 1651
  },
  {
    "close": 107.218,
    "date": "2025-03-05",
    "high": 108.658,
    "low": 105.247,
    "open": 106.617,
    "value": 107.218,
    "volume": 1692
  }
];

const options = {
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "title": {
    "subtitle": "Candlestick chart uses runnable data and options to demonstrate session and timezone calendar.",
    "text": "Candlestick"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
};

Graflume.candlestick('#chart', data, options);

Portable schema

ChartSpec 0.1 · options

{
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "title": {
    "subtitle": "Candlestick chart uses runnable data and options to demonstrate session and timezone calendar.",
    "text": "Candlestick"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
}

Chart-specific features

Every executable mode in this family

These tabs come from Graflume's public catalog. Every mode owns runnable data, options, a Quick API, and source-backed feature claims.

Candlestick chart

Candlestick chart uses runnable data and options to demonstrate session and timezone calendar.

StatusLoading

  • candlestick
  • session and timezone calendar
Graflume.candlestick() Canvas 2D
Control help

Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.

Use Tab to reach a control and Enter or Space to activate it. With the chart focused, use plus and minus to zoom and arrow keys to pan.

Auto placement compares perimeter candidates and avoids the plot, legend, and other callouts when possible. Explicit placement is preserved with only necessary safety correction. Callout text wraps safely inside the bubble. Long unbroken tokens are visually shortened within the line budget, while the complete source text remains available to assistive technology.

Loading

Browser API · Portable schema

Browser API

Graflume.candlestick()

const data = [
  {
    "close": 95.1,
    "date": "2025-01-01",
    "high": 96.3,
    "low": 92.9,
    "open": 94,
    "value": 95.1,
    "volume": 1070
  },
  {
    "close": 96.4177,
    "date": "2025-01-02",
    "high": 97.6977,
    "low": 94.6097,
    "open": 95.7997,
    "value": 96.4177,
    "volume": 1144
  },
  {
    "close": 97.4641,
    "date": "2025-01-03",
    "high": 98.8241,
    "low": 96.0986,
    "open": 97.3786,
    "value": 97.4641,
    "volume": 1217
  },
  {
    "close": 98.1631,
    "date": "2025-01-04",
    "high": 100.0024,
    "low": 96.7931,
    "open": 98.5624,
    "value": 98.1631,
    "volume": 1287
  },
  {
    "close": 98.4747,
    "date": "2025-01-05",
    "high": 100.7522,
    "low": 97.3747,
    "open": 99.2322,
    "value": 98.4747,
    "volume": 1353
  },
  {
    "close": 98.3969,
    "date": "2025-01-06",
    "high": 100.5404,
    "low": 97.2069,
    "open": 99.3404,
    "value": 98.3969,
    "volume": 1415
  },
  {
    "close": 97.9643,
    "date": "2025-01-07",
    "high": 100.1938,
    "low": 96.6843,
    "open": 98.9138,
    "value": 97.9643,
    "volume": 1470
  },
  {
    "close": 97.2423,
    "date": "2025-01-08",
    "high": 99.4061,
    "low": 95.8723,
    "open": 98.0461,
    "value": 97.2423,
    "volume": 1519
  },
  {
    "close": 96.3192,
    "date": "2025-01-09",
    "high": 98.3193,
    "low": 95.2192,
    "open": 96.8793,
    "value": 96.3192,
    "volume": 1562
  },
  {
    "close": 95.296,
    "date": "2025-01-10",
    "high": 97.0993,
    "low": 94.106,
    "open": 95.5793,
    "value": 95.296,
    "volume": 1598
  },
  {
    "close": 94.2766,
    "date": "2025-01-11",
    "high": 95.5096,
    "low": 92.9966,
    "open": 94.3096,
    "value": 94.2766,
    "volume": 1629
  },
  {
    "close": 93.3576,
    "date": "2025-01-12",
    "high": 94.6376,
    "low": 91.8392,
    "open": 93.2092,
    "value": 93.3576,
    "volume": 1656
  },
  {
    "close": 92.62,
    "date": "2025-01-13",
    "high": 93.98,
    "low": 91.2761,
    "open": 92.3761,
    "value": 92.62,
    "volume": 1679
  },
  {
    "close": 92.1232,
    "date": "2025-01-14",
    "high": 93.5632,
    "low": 90.6709,
    "open": 91.8609,
    "value": 92.1232,
    "volume": 1699
  },
  {
    "close": 91.9016,
    "date": "2025-01-15",
    "high": 93.4216,
    "low": 90.389,
    "open": 91.669,
    "value": 91.9016,
    "volume": 1106
  },
  {
    "close": 91.9631,
    "date": "2025-01-16",
    "high": 93.1631,
    "low": 90.4003,
    "open": 91.7703,
    "value": 91.9631,
    "volume": 1126
  },
  {
    "close": 92.2911,
    "date": "2025-01-17",
    "high": 93.5711,
    "low": 91.0131,
    "open": 92.1131,
    "value": 92.2911,
    "volume": 1147
  },
  {
    "close": 92.8475,
    "date": "2025-01-18",
    "high": 94.2075,
    "low": 91.4492,
    "open": 92.6392,
    "value": 92.8475,
    "volume": 1173
  },
  {
    "close": 93.5779,
    "date": "2025-01-19",
    "high": 95.0179,
    "low": 92.0148,
    "open": 93.2948,
    "value": 93.5779,
    "volume": 1202
  },
  {
    "close": 94.4172,
    "date": "2025-01-20",
    "high": 95.9372,
    "low": 92.6673,
    "open": 94.0373,
    "value": 94.4172,
    "volume": 1237
  },
  {
    "close": 95.2956,
    "date": "2025-01-21",
    "high": 96.4956,
    "low": 93.7355,
    "open": 94.8355,
    "value": 95.2956,
    "volume": 1278
  },
  {
    "close": 96.1441,
    "date": "2025-01-22",
    "high": 97.4241,
    "low": 94.4743,
    "open": 95.6643,
    "value": 96.1441,
    "volume": 1325
  },
  {
    "close": 96.8995,
    "date": "2025-01-23",
    "high": 98.2595,
    "low": 95.2164,
    "open": 96.4964,
    "value": 96.8995,
    "volume": 1378
  },
  {
    "close": 97.5083,
    "date": "2025-01-24",
    "high": 98.9483,
    "low": 95.9247,
    "open": 97.2947,
    "value": 97.5083,
    "volume": 1437
  },
  {
    "close": 97.9299,
    "date": "2025-01-25",
    "high": 99.5269,
    "low": 96.8299,
    "open": 98.0069,
    "value": 97.9299,
    "volume": 1502
  },
  {
    "close": 98.1388,
    "date": "2025-01-26",
    "high": 99.7662,
    "low": 96.9488,
    "open": 98.5662,
    "value": 98.1388,
    "volume": 1571
  },
  {
    "close": 98.1252,
    "date": "2025-01-27",
    "high": 100.1787,
    "low": 96.8452,
    "open": 98.8987,
    "value": 98.1252,
    "volume": 1643
  },
  {
    "close": 97.8956,
    "date": "2025-01-28",
    "high": 100.2955,
    "low": 96.5256,
    "open": 98.9355,
    "value": 97.8956,
    "volume": 1104
  },
  {
    "close": 97.4723,
    "date": "2025-01-29",
    "high": 100.0688,
    "low": 96.3723,
    "open": 98.6288,
    "value": 97.4723,
    "volume": 1179
  },
  {
    "close": 96.8921,
    "date": "2025-01-30",
    "high": 99.4875,
    "low": 95.7021,
    "open": 97.9675,
    "value": 96.8921,
    "volume": 1252
  },
  {
    "close": 96.2043,
    "date": "2025-01-31",
    "high": 98.1891,
    "low": 94.9243,
    "open": 96.9891,
    "value": 96.2043,
    "volume": 1323
  },
  {
    "close": 95.4682,
    "date": "2025-02-01",
    "high": 97.0627,
    "low": 94.0982,
    "open": 95.7827,
    "value": 95.4682,
    "volume": 1391
  },
  {
    "close": 94.7495,
    "date": "2025-02-02",
    "high": 96.1095,
    "low": 93.3846,
    "open": 94.4846,
    "value": 94.7495,
    "volume": 1454
  },
  {
    "close": 94.1163,
    "date": "2025-02-03",
    "high": 95.5563,
    "low": 92.0724,
    "open": 93.2624,
    "value": 94.1163,
    "volume": 1511
  },
  {
    "close": 93.6345,
    "date": "2025-02-04",
    "high": 95.1545,
    "low": 91.0128,
    "open": 92.2928,
    "value": 93.6345,
    "volume": 1562
  },
  {
    "close": 93.3624,
    "date": "2025-02-05",
    "high": 94.5624,
    "low": 90.3642,
    "open": 91.7342,
    "value": 93.3624,
    "volume": 1607
  },
  {
    "close": 93.3458,
    "date": "2025-02-06",
    "high": 94.6258,
    "low": 90.6009,
    "open": 91.7009,
    "value": 93.3458,
    "volume": 1645
  },
  {
    "close": 93.6128,
    "date": "2025-02-07",
    "high": 94.9728,
    "low": 91.0527,
    "open": 92.2427,
    "value": 93.6128,
    "volume": 1678
  },
  {
    "close": 94.1706,
    "date": "2025-02-08",
    "high": 95.6106,
    "low": 92.0536,
    "open": 93.3336,
    "value": 94.1706,
    "volume": 1706
  },
  {
    "close": 95.0024,
    "date": "2025-02-09",
    "high": 96.5224,
    "low": 93.5031,
    "open": 94.8731,
    "value": 95.0024,
    "volume": 1730
  },
  {
    "close": 96.0672,
    "date": "2025-02-10",
    "high": 97.8995,
    "low": 94.9672,
    "open": 96.6995,
    "value": 96.0672,
    "volume": 1138
  },
  {
    "close": 97.3012,
    "date": "2025-02-11",
    "high": 99.8932,
    "low": 96.1112,
    "open": 98.6132,
    "value": 97.3012,
    "volume": 1157
  },
  {
    "close": 98.6223,
    "date": "2025-02-12",
    "high": 101.7664,
    "low": 97.3423,
    "open": 100.4064,
    "value": 98.6223,
    "volume": 1177
  },
  {
    "close": 99.9361,
    "date": "2025-02-13",
    "high": 103.3339,
    "low": 98.5661,
    "open": 101.8939,
    "value": 99.9361,
    "volume": 1198
  },
  {
    "close": 101.1441,
    "date": "2025-02-14",
    "high": 104.4588,
    "low": 100.0441,
    "open": 102.9388,
    "value": 101.1441,
    "volume": 1222
  },
  {
    "close": 102.1532,
    "date": "2025-02-15",
    "high": 104.671,
    "low": 100.9632,
    "open": 103.471,
    "value": 102.1532,
    "volume": 1250
  },
  {
    "close": 102.8851,
    "date": "2025-02-16",
    "high": 104.773,
    "low": 101.6051,
    "open": 103.493,
    "value": 102.8851,
    "volume": 1283
  },
  {
    "close": 103.2854,
    "date": "2025-02-17",
    "high": 104.6454,
    "low": 101.7045,
    "open": 103.0745,
    "value": 103.2854,
    "volume": 1322
  },
  {
    "close": 103.3306,
    "date": "2025-02-18",
    "high": 104.7706,
    "low": 101.2366,
    "open": 102.3366,
    "value": 103.3306,
    "volume": 1367
  },
  {
    "close": 103.0322,
    "date": "2025-02-19",
    "high": 104.5522,
    "low": 100.2392,
    "open": 101.4292,
    "value": 103.0322,
    "volume": 1418
  },
  {
    "close": 102.4378,
    "date": "2025-02-20",
    "high": 103.6378,
    "low": 99.226,
    "open": 100.506,
    "value": 102.4378,
    "volume": 1476
  },
  {
    "close": 101.6282,
    "date": "2025-02-21",
    "high": 102.9082,
    "low": 98.3323,
    "open": 99.7023,
    "value": 101.6282,
    "volume": 1539
  },
  {
    "close": 100.7105,
    "date": "2025-02-22",
    "high": 102.0705,
    "low": 98.0185,
    "open": 99.1185,
    "value": 100.7105,
    "volume": 1607
  },
  {
    "close": 99.8085,
    "date": "2025-02-23",
    "high": 101.2485,
    "low": 97.6227,
    "open": 98.8127,
    "value": 99.8085,
    "volume": 1065
  },
  {
    "close": 99.0497,
    "date": "2025-02-24",
    "high": 100.5697,
    "low": 97.521,
    "open": 98.801,
    "value": 99.0497,
    "volume": 1138
  },
  {
    "close": 98.5523,
    "date": "2025-02-25",
    "high": 100.2666,
    "low": 97.1823,
    "open": 99.0666,
    "value": 98.5523,
    "volume": 1213
  },
  {
    "close": 98.4121,
    "date": "2025-02-26",
    "high": 100.8514,
    "low": 97.3121,
    "open": 99.5714,
    "value": 98.4121,
    "volume": 1287
  },
  {
    "close": 98.6906,
    "date": "2025-02-27",
    "high": 101.63,
    "low": 97.5006,
    "open": 100.27,
    "value": 98.6906,
    "volume": 1359
  },
  {
    "close": 99.4076,
    "date": "2025-02-28",
    "high": 102.5602,
    "low": 98.1276,
    "open": 101.1202,
    "value": 99.4076,
    "volume": 1428
  },
  {
    "close": 100.5364,
    "date": "2025-03-01",
    "high": 103.6082,
    "low": 99.1664,
    "open": 102.0882,
    "value": 100.5364,
    "volume": 1492
  },
  {
    "close": 102.0054,
    "date": "2025-03-02",
    "high": 104.3483,
    "low": 100.9054,
    "open": 103.1483,
    "value": 102.0054,
    "volume": 1551
  },
  {
    "close": 103.704,
    "date": "2025-03-03",
    "high": 105.5579,
    "low": 102.514,
    "open": 104.2779,
    "value": 103.704,
    "volume": 1604
  },
  {
    "close": 105.4928,
    "date": "2025-03-04",
    "high": 106.8528,
    "low": 104.1683,
    "open": 105.4483,
    "value": 105.4928,
    "volume": 1651
  },
  {
    "close": 107.218,
    "date": "2025-03-05",
    "high": 108.658,
    "low": 105.247,
    "open": 106.617,
    "value": 107.218,
    "volume": 1692
  }
];

const options = {
  "accessibility": {
    "description": "Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.",
    "label": "Candlestick example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "short",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 4,
        "spacing": 8
      }
    },
    "y": {
      "format": {
        "currency": "USD",
        "currencyDisplay": "narrowSymbol",
        "fractionDigits": 0,
        "type": "currency"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "Date",
          "timeZone": "UTC"
        },
        {
          "field": "close",
          "format": "number",
          "label": "Close"
        },
        {
          "field": "open",
          "format": "number",
          "label": "Open"
        },
        {
          "field": "high",
          "format": "number",
          "label": "High"
        },
        {
          "field": "low",
          "format": "number",
          "label": "Low"
        }
      ],
      "title": "Candlestick",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Candlestick chart uses runnable data and options to demonstrate session and timezone calendar.",
    "text": "Candlestick"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
};

Graflume.candlestick('#chart', data, options);

Portable schema

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.",
    "label": "Candlestick example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "short",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 4,
        "spacing": 8
      }
    },
    "y": {
      "format": {
        "currency": "USD",
        "currencyDisplay": "narrowSymbol",
        "fractionDigits": 0,
        "type": "currency"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "Date",
          "timeZone": "UTC"
        },
        {
          "field": "close",
          "format": "number",
          "label": "Close"
        },
        {
          "field": "open",
          "format": "number",
          "label": "Open"
        },
        {
          "field": "high",
          "format": "number",
          "label": "High"
        },
        {
          "field": "low",
          "format": "number",
          "label": "Low"
        }
      ],
      "title": "Candlestick",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Candlestick chart uses runnable data and options to demonstrate session and timezone calendar.",
    "text": "Candlestick"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
}

Edge cases

Numeric range, irregular structure, and data volume

Exercise numeric range, sparse structure, and large inputs with valid data. Each tab materializes data only when needed and never silently repairs invalid values.

Wide numeric range

Mix zero, very small finite values, and very large finite values to verify automatic domains, precision, and stable geometry. NaN and Infinity remain intentionally invalid. It applies 2 data-integrity rules that preserve finite values and axis domains.

StatusLoading

  • extreme-range
  • extreme-small
  • extreme-large
  • positive-domain
  • budget:marks<=6
Graflume.candlestick() Canvas 2D
Control help

Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.

Use Tab to reach a control and Enter or Space to activate it. With the chart focused, use plus and minus to zoom and arrow keys to pan.

Auto placement compares perimeter candidates and avoids the plot, legend, and other callouts when possible. Explicit placement is preserved with only necessary safety correction. Callout text wraps safely inside the bubble. Long unbroken tokens are visually shortened within the line budget, while the complete source text remains available to assistive technology.

Loading

Browser API · Portable schema

Browser API

Graflume.candlestick()

const data = [
  {
    "close": 5.150000000000001e-10,
    "date": "2026-01-01",
    "high": 5.253000000000001e-10,
    "low": 4.949e-10,
    "open": 5.05e-10,
    "value": 5.150000000000001e-10,
    "volume": 0
  },
  {
    "close": 9.9e-7,
    "date": "2026-02-01",
    "high": 0.0000010302,
    "low": 9.702e-7,
    "open": 0.0000010099999999999999,
    "value": 9.9e-7,
    "volume": 1
  },
  {
    "close": 1.03,
    "date": "2026-03-01",
    "high": 1.0506,
    "low": 0.9898,
    "open": 1.01,
    "value": 1.03,
    "volume": 1000
  },
  {
    "close": 990,
    "date": "2026-04-01",
    "high": 1030.2,
    "low": 970.1999999999999,
    "open": 1010,
    "value": 990,
    "volume": 1000000
  },
  {
    "close": 1030000,
    "date": "2026-05-01",
    "high": 1050600,
    "low": 989800,
    "open": 1010000,
    "value": 1030000,
    "volume": 1000000000
  },
  {
    "close": 1980000000,
    "date": "2026-06-01",
    "high": 2060400000,
    "low": 1940400000,
    "open": 2020000000,
    "value": 1980000000,
    "volume": 1000000000000
  }
];

const options = {
  "accessibility": {
    "description": "A coherent daily market path with open, high, low, close, and volume. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
    "label": "Candlestick"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "hover": true,
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "Date",
          "timeZone": "UTC"
        },
        {
          "field": "close",
          "format": "number",
          "label": "Close"
        },
        {
          "field": "open",
          "format": "number",
          "label": "Open"
        },
        {
          "field": "high",
          "format": "number",
          "label": "High"
        },
        {
          "field": "low",
          "format": "number",
          "label": "Low"
        },
        {
          "field": "value",
          "format": "number",
          "label": "Value"
        },
        {
          "field": "volume",
          "format": "number",
          "label": "Volume"
        }
      ],
      "title": "Candlestick",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "title": {
    "subtitle": "edge case · range",
    "text": "Candlestick"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
};

Graflume.candlestick('#chart', data, options);

Portable schema

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "A coherent daily market path with open, high, low, close, and volume. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
    "label": "Candlestick"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "hover": true,
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "Date",
          "timeZone": "UTC"
        },
        {
          "field": "close",
          "format": "number",
          "label": "Close"
        },
        {
          "field": "open",
          "format": "number",
          "label": "Open"
        },
        {
          "field": "high",
          "format": "number",
          "label": "High"
        },
        {
          "field": "low",
          "format": "number",
          "label": "Low"
        },
        {
          "field": "value",
          "format": "number",
          "label": "Value"
        },
        {
          "field": "volume",
          "format": "number",
          "label": "Volume"
        }
      ],
      "title": "Candlestick",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "title": {
    "subtitle": "edge case · range",
    "text": "Candlestick"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "title": "Price",
    "type": "quantitative"
  }
}

Extreme environments

Reconfigure for display, input, and device capability

Combine container size, input method, display capability, and user preference instead of guessing a device name. Compare mobile, watch, e-paper, monochrome, dot-matrix, and standards-based extreme environments on the same chart.

Fluid responsive

Reflow axes, legends, descriptions, and controls from the available container size.

960×540 · adaptive.profiles=responsive-fluid
  • zoom-reflow
  • shape-rectangle
  • display-color
  • input-fine
  • motion-full
  • renderer-canvas-spatial

Extreme environment preview

Choose a profile above to preserve the same data and ChartSpec while reconfiguring the chart for display size, input method, display capability, and user preference.

StatusLoading

  • adaptive
  • capability-driven
  • no-user-agent-branching
  • Legend: legend · explicit · 2 channels
  • Point and range highlights: highlights[] · datum · date
  • Custom callouts: annotations[] · datum · date · callout · placement:auto
  • Interactive selection: selection · multiple · toggle
Graflume.candlestick() Canvas 2D
Control help

Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.

Use Tab to reach a control and Enter or Space to activate it. With the chart focused, use plus and minus to zoom and arrow keys to pan.

Auto placement compares perimeter candidates and avoids the plot, legend, and other callouts when possible. Explicit placement is preserved with only necessary safety correction. Callout text wraps safely inside the bubble. Long unbroken tokens are visually shortened within the line budget, while the complete source text remains available to assistive technology.

Playback smoothly interpolates matching stable keys for 600 ms with ease-in-out. Entering or exiting marks fade, incompatible shapes crossfade, and reduced-motion jumps directly to the final state.

playback · cumulative · date · key=date · transition=600ms/ease-in-out · fade/crossfade

Loading

Browser API · Portable schema

Browser API

Graflume.candlestick()

const data = [
  {
    "close": 95.1,
    "date": "2025-01-01",
    "high": 96.3,
    "low": 92.9,
    "open": 94,
    "value": 95.1,
    "volume": 1070
  },
  {
    "close": 96.4177,
    "date": "2025-01-02",
    "high": 97.6977,
    "low": 94.6097,
    "open": 95.7997,
    "value": 96.4177,
    "volume": 1144
  },
  {
    "close": 97.4641,
    "date": "2025-01-03",
    "high": 98.8241,
    "low": 96.0986,
    "open": 97.3786,
    "value": 97.4641,
    "volume": 1217
  },
  {
    "close": 98.1631,
    "date": "2025-01-04",
    "high": 100.0024,
    "low": 96.7931,
    "open": 98.5624,
    "value": 98.1631,
    "volume": 1287
  },
  {
    "close": 98.4747,
    "date": "2025-01-05",
    "high": 100.7522,
    "low": 97.3747,
    "open": 99.2322,
    "value": 98.4747,
    "volume": 1353
  },
  {
    "close": 98.3969,
    "date": "2025-01-06",
    "high": 100.5404,
    "low": 97.2069,
    "open": 99.3404,
    "value": 98.3969,
    "volume": 1415
  },
  {
    "close": 97.9643,
    "date": "2025-01-07",
    "high": 100.1938,
    "low": 96.6843,
    "open": 98.9138,
    "value": 97.9643,
    "volume": 1470
  },
  {
    "close": 97.2423,
    "date": "2025-01-08",
    "high": 99.4061,
    "low": 95.8723,
    "open": 98.0461,
    "value": 97.2423,
    "volume": 1519
  },
  {
    "close": 96.3192,
    "date": "2025-01-09",
    "high": 98.3193,
    "low": 95.2192,
    "open": 96.8793,
    "value": 96.3192,
    "volume": 1562
  },
  {
    "close": 95.296,
    "date": "2025-01-10",
    "high": 97.0993,
    "low": 94.106,
    "open": 95.5793,
    "value": 95.296,
    "volume": 1598
  },
  {
    "close": 94.2766,
    "date": "2025-01-11",
    "high": 95.5096,
    "low": 92.9966,
    "open": 94.3096,
    "value": 94.2766,
    "volume": 1629
  },
  {
    "close": 93.3576,
    "date": "2025-01-12",
    "high": 94.6376,
    "low": 91.8392,
    "open": 93.2092,
    "value": 93.3576,
    "volume": 1656
  },
  {
    "close": 92.62,
    "date": "2025-01-13",
    "high": 93.98,
    "low": 91.2761,
    "open": 92.3761,
    "value": 92.62,
    "volume": 1679
  },
  {
    "close": 92.1232,
    "date": "2025-01-14",
    "high": 93.5632,
    "low": 90.6709,
    "open": 91.8609,
    "value": 92.1232,
    "volume": 1699
  },
  {
    "close": 91.9016,
    "date": "2025-01-15",
    "high": 93.4216,
    "low": 90.389,
    "open": 91.669,
    "value": 91.9016,
    "volume": 1106
  },
  {
    "close": 91.9631,
    "date": "2025-01-16",
    "high": 93.1631,
    "low": 90.4003,
    "open": 91.7703,
    "value": 91.9631,
    "volume": 1126
  },
  {
    "close": 92.2911,
    "date": "2025-01-17",
    "high": 93.5711,
    "low": 91.0131,
    "open": 92.1131,
    "value": 92.2911,
    "volume": 1147
  },
  {
    "close": 92.8475,
    "date": "2025-01-18",
    "high": 94.2075,
    "low": 91.4492,
    "open": 92.6392,
    "value": 92.8475,
    "volume": 1173
  },
  {
    "close": 93.5779,
    "date": "2025-01-19",
    "high": 95.0179,
    "low": 92.0148,
    "open": 93.2948,
    "value": 93.5779,
    "volume": 1202
  },
  {
    "close": 94.4172,
    "date": "2025-01-20",
    "high": 95.9372,
    "low": 92.6673,
    "open": 94.0373,
    "value": 94.4172,
    "volume": 1237
  },
  {
    "close": 95.2956,
    "date": "2025-01-21",
    "high": 96.4956,
    "low": 93.7355,
    "open": 94.8355,
    "value": 95.2956,
    "volume": 1278
  },
  {
    "close": 96.1441,
    "date": "2025-01-22",
    "high": 97.4241,
    "low": 94.4743,
    "open": 95.6643,
    "value": 96.1441,
    "volume": 1325
  },
  {
    "close": 96.8995,
    "date": "2025-01-23",
    "high": 98.2595,
    "low": 95.2164,
    "open": 96.4964,
    "value": 96.8995,
    "volume": 1378
  },
  {
    "close": 97.5083,
    "date": "2025-01-24",
    "high": 98.9483,
    "low": 95.9247,
    "open": 97.2947,
    "value": 97.5083,
    "volume": 1437
  },
  {
    "close": 97.9299,
    "date": "2025-01-25",
    "high": 99.5269,
    "low": 96.8299,
    "open": 98.0069,
    "value": 97.9299,
    "volume": 1502
  },
  {
    "close": 98.1388,
    "date": "2025-01-26",
    "high": 99.7662,
    "low": 96.9488,
    "open": 98.5662,
    "value": 98.1388,
    "volume": 1571
  },
  {
    "close": 98.1252,
    "date": "2025-01-27",
    "high": 100.1787,
    "low": 96.8452,
    "open": 98.8987,
    "value": 98.1252,
    "volume": 1643
  },
  {
    "close": 97.8956,
    "date": "2025-01-28",
    "high": 100.2955,
    "low": 96.5256,
    "open": 98.9355,
    "value": 97.8956,
    "volume": 1104
  },
  {
    "close": 97.4723,
    "date": "2025-01-29",
    "high": 100.0688,
    "low": 96.3723,
    "open": 98.6288,
    "value": 97.4723,
    "volume": 1179
  },
  {
    "close": 96.8921,
    "date": "2025-01-30",
    "high": 99.4875,
    "low": 95.7021,
    "open": 97.9675,
    "value": 96.8921,
    "volume": 1252
  },
  {
    "close": 96.2043,
    "date": "2025-01-31",
    "high": 98.1891,
    "low": 94.9243,
    "open": 96.9891,
    "value": 96.2043,
    "volume": 1323
  },
  {
    "close": 95.4682,
    "date": "2025-02-01",
    "high": 97.0627,
    "low": 94.0982,
    "open": 95.7827,
    "value": 95.4682,
    "volume": 1391
  },
  {
    "close": 94.7495,
    "date": "2025-02-02",
    "high": 96.1095,
    "low": 93.3846,
    "open": 94.4846,
    "value": 94.7495,
    "volume": 1454
  },
  {
    "close": 94.1163,
    "date": "2025-02-03",
    "high": 95.5563,
    "low": 92.0724,
    "open": 93.2624,
    "value": 94.1163,
    "volume": 1511
  },
  {
    "close": 93.6345,
    "date": "2025-02-04",
    "high": 95.1545,
    "low": 91.0128,
    "open": 92.2928,
    "value": 93.6345,
    "volume": 1562
  },
  {
    "close": 93.3624,
    "date": "2025-02-05",
    "high": 94.5624,
    "low": 90.3642,
    "open": 91.7342,
    "value": 93.3624,
    "volume": 1607
  },
  {
    "close": 93.3458,
    "date": "2025-02-06",
    "high": 94.6258,
    "low": 90.6009,
    "open": 91.7009,
    "value": 93.3458,
    "volume": 1645
  },
  {
    "close": 93.6128,
    "date": "2025-02-07",
    "high": 94.9728,
    "low": 91.0527,
    "open": 92.2427,
    "value": 93.6128,
    "volume": 1678
  },
  {
    "close": 94.1706,
    "date": "2025-02-08",
    "high": 95.6106,
    "low": 92.0536,
    "open": 93.3336,
    "value": 94.1706,
    "volume": 1706
  },
  {
    "close": 95.0024,
    "date": "2025-02-09",
    "high": 96.5224,
    "low": 93.5031,
    "open": 94.8731,
    "value": 95.0024,
    "volume": 1730
  },
  {
    "close": 96.0672,
    "date": "2025-02-10",
    "high": 97.8995,
    "low": 94.9672,
    "open": 96.6995,
    "value": 96.0672,
    "volume": 1138
  },
  {
    "close": 97.3012,
    "date": "2025-02-11",
    "high": 99.8932,
    "low": 96.1112,
    "open": 98.6132,
    "value": 97.3012,
    "volume": 1157
  },
  {
    "close": 98.6223,
    "date": "2025-02-12",
    "high": 101.7664,
    "low": 97.3423,
    "open": 100.4064,
    "value": 98.6223,
    "volume": 1177
  },
  {
    "close": 99.9361,
    "date": "2025-02-13",
    "high": 103.3339,
    "low": 98.5661,
    "open": 101.8939,
    "value": 99.9361,
    "volume": 1198
  },
  {
    "close": 101.1441,
    "date": "2025-02-14",
    "high": 104.4588,
    "low": 100.0441,
    "open": 102.9388,
    "value": 101.1441,
    "volume": 1222
  },
  {
    "close": 102.1532,
    "date": "2025-02-15",
    "high": 104.671,
    "low": 100.9632,
    "open": 103.471,
    "value": 102.1532,
    "volume": 1250
  },
  {
    "close": 102.8851,
    "date": "2025-02-16",
    "high": 104.773,
    "low": 101.6051,
    "open": 103.493,
    "value": 102.8851,
    "volume": 1283
  },
  {
    "close": 103.2854,
    "date": "2025-02-17",
    "high": 104.6454,
    "low": 101.7045,
    "open": 103.0745,
    "value": 103.2854,
    "volume": 1322
  },
  {
    "close": 103.3306,
    "date": "2025-02-18",
    "high": 104.7706,
    "low": 101.2366,
    "open": 102.3366,
    "value": 103.3306,
    "volume": 1367
  },
  {
    "close": 103.0322,
    "date": "2025-02-19",
    "high": 104.5522,
    "low": 100.2392,
    "open": 101.4292,
    "value": 103.0322,
    "volume": 1418
  },
  {
    "close": 102.4378,
    "date": "2025-02-20",
    "high": 103.6378,
    "low": 99.226,
    "open": 100.506,
    "value": 102.4378,
    "volume": 1476
  },
  {
    "close": 101.6282,
    "date": "2025-02-21",
    "high": 102.9082,
    "low": 98.3323,
    "open": 99.7023,
    "value": 101.6282,
    "volume": 1539
  },
  {
    "close": 100.7105,
    "date": "2025-02-22",
    "high": 102.0705,
    "low": 98.0185,
    "open": 99.1185,
    "value": 100.7105,
    "volume": 1607
  },
  {
    "close": 99.8085,
    "date": "2025-02-23",
    "high": 101.2485,
    "low": 97.6227,
    "open": 98.8127,
    "value": 99.8085,
    "volume": 1065
  },
  {
    "close": 99.0497,
    "date": "2025-02-24",
    "high": 100.5697,
    "low": 97.521,
    "open": 98.801,
    "value": 99.0497,
    "volume": 1138
  },
  {
    "close": 98.5523,
    "date": "2025-02-25",
    "high": 100.2666,
    "low": 97.1823,
    "open": 99.0666,
    "value": 98.5523,
    "volume": 1213
  },
  {
    "close": 98.4121,
    "date": "2025-02-26",
    "high": 100.8514,
    "low": 97.3121,
    "open": 99.5714,
    "value": 98.4121,
    "volume": 1287
  },
  {
    "close": 98.6906,
    "date": "2025-02-27",
    "high": 101.63,
    "low": 97.5006,
    "open": 100.27,
    "value": 98.6906,
    "volume": 1359
  },
  {
    "close": 99.4076,
    "date": "2025-02-28",
    "high": 102.5602,
    "low": 98.1276,
    "open": 101.1202,
    "value": 99.4076,
    "volume": 1428
  },
  {
    "close": 100.5364,
    "date": "2025-03-01",
    "high": 103.6082,
    "low": 99.1664,
    "open": 102.0882,
    "value": 100.5364,
    "volume": 1492
  },
  {
    "close": 102.0054,
    "date": "2025-03-02",
    "high": 104.3483,
    "low": 100.9054,
    "open": 103.1483,
    "value": 102.0054,
    "volume": 1551
  },
  {
    "close": 103.704,
    "date": "2025-03-03",
    "high": 105.5579,
    "low": 102.514,
    "open": 104.2779,
    "value": 103.704,
    "volume": 1604
  },
  {
    "close": 105.4928,
    "date": "2025-03-04",
    "high": 106.8528,
    "low": 104.1683,
    "open": 105.4483,
    "value": 105.4928,
    "volume": 1651
  },
  {
    "close": 107.218,
    "date": "2025-03-05",
    "high": 108.658,
    "low": 105.247,
    "open": 106.617,
    "value": 107.218,
    "volume": 1692
  }
];

const options = {
  "accessibility": {
    "description": "A coherent daily market path with open, high, low, close, and volume. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
    "label": "Candlestick chart: A coherent daily market path with open, high, low, close, and volume"
  },
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "date",
        "type": "datum",
        "value": "2025-02-02"
      },
      "text": "Point and range highlights · 2025-02-02"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "short",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 4,
        "spacing": 8
      }
    },
    "y": {
      "format": {
        "currency": "USD",
        "currencyDisplay": "narrowSymbol",
        "fractionDigits": 0,
        "type": "currency"
      }
    }
  },
  "create": {
    "adaptive": {
      "profiles": "auto"
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "date",
        "type": "datum",
        "value": "2025-02-02"
      }
    }
  ],
  "interaction": {
    "controls": {
      "annotations": true,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": true,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "playback": {
      "autoplay": false,
      "field": "date",
      "filter": true,
      "interval": 1000,
      "key": "date",
      "loop": false,
      "mode": "cumulative",
      "rate": 1,
      "transition": {
        "duration": 600,
        "easing": "ease-in-out"
      },
      "windowSize": 1
    },
    "selection": {
      "ariaLabel": "Interactive selection",
      "clearOnBackground": true,
      "clearOnEscape": true,
      "highlight": {
        "padding": 5
      },
      "key": "date",
      "mode": "multiple",
      "toggle": true
    },
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "Date",
          "timeZone": "UTC"
        },
        {
          "field": "close",
          "format": "number",
          "label": "Close"
        },
        {
          "field": "open",
          "format": "number",
          "label": "Open"
        },
        {
          "field": "high",
          "format": "number",
          "label": "High"
        },
        {
          "field": "low",
          "format": "number",
          "label": "Low"
        }
      ],
      "title": "Candlestick",
      "trigger": "axis"
    }
  },
  "legend": {
    "interactive": false,
    "items": [
      {
        "id": "semantic-0",
        "label": "Rising"
      },
      {
        "id": "semantic-1",
        "label": "Falling"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Candlestick",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "A coherent daily market path with open, high, low, close, and volume",
    "text": "Candlestick chart"
  },
  "width": "container",
  "x": {
    "field": "date",
    "scale": {
      "domain": [
        "2026-01-01",
        "2026-04-01"
      ]
    },
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "scale": {
      "domain": [
        18,
        38
      ]
    },
    "title": "Price",
    "type": "quantitative"
  }
};

Graflume.candlestick('#chart', data, options);

Portable schema

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "A coherent daily market path with open, high, low, close, and volume. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
    "label": "Candlestick chart: A coherent daily market path with open, high, low, close, and volume"
  },
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "date",
        "type": "datum",
        "value": "2025-02-02"
      },
      "text": "Point and range highlights · 2025-02-02"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "short",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 4,
        "spacing": 8
      }
    },
    "y": {
      "format": {
        "currency": "USD",
        "currencyDisplay": "narrowSymbol",
        "fractionDigits": 0,
        "type": "currency"
      }
    }
  },
  "create": {
    "adaptive": {
      "profiles": "auto"
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "date",
        "type": "datum",
        "value": "2025-02-02"
      }
    }
  ],
  "interaction": {
    "controls": {
      "annotations": true,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": true,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "playback": {
      "autoplay": false,
      "field": "date",
      "filter": true,
      "interval": 1000,
      "key": "date",
      "loop": false,
      "mode": "cumulative",
      "rate": 1,
      "transition": {
        "duration": 600,
        "easing": "ease-in-out"
      },
      "windowSize": 1
    },
    "selection": {
      "ariaLabel": "Interactive selection",
      "clearOnBackground": true,
      "clearOnEscape": true,
      "highlight": {
        "padding": 5
      },
      "key": "date",
      "mode": "multiple",
      "toggle": true
    },
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "Date",
          "timeZone": "UTC"
        },
        {
          "field": "close",
          "format": "number",
          "label": "Close"
        },
        {
          "field": "open",
          "format": "number",
          "label": "Open"
        },
        {
          "field": "high",
          "format": "number",
          "label": "High"
        },
        {
          "field": "low",
          "format": "number",
          "label": "Low"
        }
      ],
      "title": "Candlestick",
      "trigger": "axis"
    }
  },
  "legend": {
    "interactive": false,
    "items": [
      {
        "id": "semantic-0",
        "label": "Rising"
      },
      {
        "id": "semantic-1",
        "label": "Falling"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Candlestick",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "close": "close",
      "high": "high",
      "low": "low",
      "open": "open"
    }
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "A coherent daily market path with open, high, low, close, and volume",
    "text": "Candlestick chart"
  },
  "width": "container",
  "x": {
    "field": "date",
    "scale": {
      "domain": [
        "2026-01-01",
        "2026-04-01"
      ]
    },
    "title": "Trading day",
    "type": "temporal"
  },
  "y": {
    "field": "close",
    "scale": {
      "domain": [
        18,
        38
      ]
    },
    "title": "Price",
    "type": "quantitative"
  }
}

Catalog

Modes · compatibility identifiers

The source-controlled catalog maps callable modes in this family and compatibility identifiers to their canonical modes. This table contains executable entries only.

5 modes · 5 compatibility identifiers

Candlestick · supported modes · representative candlestick
IDNameQuick APImodemarkrenderer
candlestickCandlestick chartcandlestick()defaultcandlestickcanvas
heikin-ashiHeikin-Ashi chartheikinAshi()heikin-ashifinancialcanvas
high-low-closeHigh-low-close charthighLowClose()high-low-closefinancialcanvas
hollow-candlestickHollow candlestick charthollowCandlestick()hollow-candlestickfinancialcanvas
open-high-low-closeOpen-high-low-close chartopenHighLowClose()open-high-low-closefinancialcanvas
Candlestick · compatibility identifiers
IdentifierCanonical mode ID
candlestickcandlestick
heikinashiheikin-ashi
hlchigh-low-close
hollowcandlestickhollow-candlestick
ohlcopen-high-low-close

Manual

Integration checklist

ARIA · table fallback

Accessibility

Canvas ARIA metadata is paired with a text summary and table fallback.

standard · large · ultra

Performance

Standard, large, and ultra profiles bound rendering work.

Chart catalog