Kumo Charts

Chart types

The chart type menu of the top bar is arranged in groups, each type with a name in Chinese, English, Japanese and Korean, followed by a few kinds of bars of our own; methods and the state use the names in the left column:

Type Description
ohlc, candles, hollow-candles, volume-candles Bars, Candles, Hollow candles, Volume candles (as wide as their volume)
line, line-markers, step-line Line, Line with markers, Step line
area, hlc-area, baseline Area, HLC area, Baseline
columns, high-low Columns (rising from the bottom of the pane, colored by whether they are up or down from the bar before), High-low
footprint, tpo Volume footprint and Time Price Opportunity (the order flow of the commercial edition, see "Volume footprint and Time Price Opportunity" below): the volumes bought and sold by aggressors at each price of each bar; and a market profile of each trading day, with a letter for every 30 minutes
heikin-ashi, range Heikin Ashi and Range, built from the bars of the current timeframe; the range of each Range bar is set automatically by the average true range of the last 14 closed bars, rounded as for Renko
renko Renko: bricks aligned to multiples of the brick size, a new brick when the price goes one brick size beyond the last, and two for a reversal. Settings: method is "Size by", atr (the default, the ATR of the last atrLength bars, 14 by default), traditional (a fixed box) or percentage (percentage% of the latest price, 1 by default); source is close (the default, the closing price) or ohlc (open, high, low, close); wicks are the wicks (on by default; in the settings, the "Wick" row of the colors)
line-break Line break: a new line when the close goes beyond the high or the low of the last lines lines (3 by default)
kagi Kagi: a line by the closing price, which goes on while it moves in the same direction and turns when it pulls back "Reversal boxes" from its extreme; it becomes thick from where it rises above the shoulder before (yang, in the up color), and thin from where it falls below the waist before (yin, in the down color). Settings: method is "Size by", atr (the default, the ATR of the last atrLength bars, 14 by default), traditional (a fixed reversal) or percentage (percentage% of the latest price, 1 by default)
point-figure Point & figure: columns of X and of O, with a box size set by method too (atrLength, a fixed box, percentage); reversal is how many boxes the price must go the other way to start a new column (3 by default), source is close (the default, the closing price) or hl (the high and low prices), and oneStepBack is "One-box turns" (with a reversal of one box, a column of one box turns within itself)
volume, turnover Volume bars and Turnover bars: each closes once it has gathered volume (volume) or turnover (turnover). null by default, the average of a bar of the current timeframe; input is bars (the default, merging whole bars of the current timeframe, with history, finer as the timeframe is shorter) or trades (live trades, see below)
tick Tick bars: a bar every count trades (100 by default), built from live trades
imbalance, runs Imbalance bars and Run bars (the information-driven bars of the commercial edition), built from live trades: ticks is the number of trades expected per bar at the start (200 by default), and measure is the weight of each trade, tick (the count, the default), volume (volume) or turnover (turnover)

The settings are at the top of "Chart settings → Candles": what they are built from, the size of each bar (a few common sizes, or one of your own) and the weight of each trade; Renko, Kagi and Point & figure have the settings above. With a size by ATR or by percentage, the size computed now is written beside it; switching to "Fixed" fills in the size computed now first (rather than a fixed 1 or 3, which most symbols cannot use), to change from there. The settings of each type are kept apart in the state (ChartView.barSettings), and are as they were when switching back.

Renko, Kagi and Point & figure are built by the rules below, and every brick, line and column computed from daily and weekly bars of BTCUSDT, ETHUSDT and others has been checked:

  • Renko starts from the cell of the grid where the first price falls; a brick has the time of the bar that made it, and the volume since the batch of bricks before, shared evenly by the bricks one price makes. By open, high, low and close, a rising bar goes open, low, high, close and a falling one open, high, low, close, each price with a quarter of the volume. Wicks reach the highest or lowest price between two batches of bricks, and only when the price went more than a brick beyond the brick's open the other way.

  • The first line of Kagi starts at the first close, and is drawn once the close has moved the reversal amount from it; each line is a bar, opening at its start and closing at its extreme, with the time of the bar that started it and the volume from that bar to the bar of the extreme.

  • The boxes of Point & figure are aligned to multiples of the box size, and a new column starts one box away from the last box of the column before; each column is a bar, opening at the price of its first box and closing at its last.

  • A size by ATR or by percentage is rounded to a multiple of half the highest power of 10 in it (2137 → 2000, 820 → 800). By ATR, it is taken up to the last closed bar (computed as the ATR indicator; the bar in progress does not count: with an ATR length of 1, the size is exactly the true range of the day before). For a fixed size, fill one in with "Fixed".

  • The last bar of Renko, Line break, Kagi and Point & figure stops at a brick, line or box, not at the live price: on the price scale, the latest price's line and label stay on the last bar, and a paler label beside them marks the live price (in the up color above the last bar's close, in the down color below).

Timeframes and chart types look the same in the top bar: with no starred item, a button shows the current timeframe (a chart type shows its icon only, with the name in the tooltip), followed by a small pale arrow that opens the menu. With starred items, there are the starred items (chart types with their icon only), the item chosen last that is not starred, and a separate small arrow button: the item chosen last stays while a starred one is chosen, so a click goes straight back to it without opening the menu; only the small arrow opens the menu. Each row of the menu shows a star at its end when the pointer is over it (always, when it is starred). The starred types are kept in the state's favoriteChartTypes, and the method is setFavoriteChartTypes(types).

chart.setChartType('tick', { count: 500 });
chart.setChartType('volume', { volume: 1000, input: 'trades' });
chart.setChartType('imbalance', { ticks: 300, measure: 'volume' });
chart.setChartType('volume', { volume: null }); // back to the volume of an average bar
chart.setChartType('renko', { method: 'percentage', percentage: 1, source: 'ohlc', wicks: true });
chart.setChartType('kagi', { method: 'traditional', reversal: 2500 });
chart.setChartType('point-figure', { method: 'atr', atrLength: 20, reversal: 3, source: 'hl' });

Bars built from live trades (tick, imbalance, runs, and volume and turnover bars with input: 'trades') use only the trades streamed by LiveListener.trades, and the interface says so:

  • No history: getBars() gives only bars, so these bars start from the trades received after the chart opened (or changed symbol). Until the first trade arrives the chart says "Waiting for live trades", and afterwards its bottom left corner says from what time.
  • Gaps on disconnection: what a datafeed fills in after reconnecting is usually bars rather than the trades of the disconnection, so bars of time are complete while bars built from trades miss a piece for that time.
  • A trade is a trade as the datafeed streams it: when the datafeed streams aggregated trades (several fills of one aggressive order as one trade, as on Binance USDⓈ-M perpetuals), each tick bar holds more real trades.
  • A datafeed that streams only bars and no trades keeps it waiting.
  • They have nothing to do with timeframes: no timeframe is highlighted in the top bar, and clicking one goes back to the candles of that timeframe (as setTimeframe() does). The chart keeps the last 100,000 trades; once earlier trades are dropped, the bars built from them stay.

Volume footprint and Time Price Opportunity

Both are in the menu after Columns and High-low and before Heikin Ashi, named: 成交量轨迹 / Volume footprint / 出来高フットプリント / 볼륨 풋프린트, and 时间价格机会 / Time Price Opportunity / タイム・プライス・オポチュニティ / 시간 가격 기회. The settings are at the top of "Chart settings → Candles"; the methods are setChartType('footprint', { … }) and setChartType('tpo', { … }), with the fields below.

Volume footprint (footprint): beside each bar, in rows by price, a column on the left with the volume sold by aggressors and a column on the right with the volume bought, and a thin candle in between; below, the totals of the two columns, and below them a small box with the Delta (bought less sold) and the total volume.

Field Default Description
rowSize, atrLength, ticksPerRow auto, 14, 10 Row size: auto is a fifth of the average true range of the last atrLength bars, rounded to ticks (computed again when the symbol or the timeframe changes, and the settings show the row size computed now); manual is ticksPerRow ticks per row
display cluster Display: cluster (every cell as wide), profile (cells growing out of the candle by their volume)
type buy-sell Type: buy-sell buy and sell, delta one column of bought less sold, total one column of the total, ladder (only the larger side of each row colored)
gradient, sell1…sell4, buy1…buy4 on, from the theme The background in four shades by volume (in quarters between the smallest and the largest of the bar's own side); off, the second shade is used. A color of null is one of four shades made from the theme's up and down colors
valueArea, valueAreaPercent on, 70 Value area: dashed lines at its top and bottom
poc, pocColor on, the theme's text color Point of control: the row with the largest volume filled across
summary on Show summary info: the totals of the two columns, and the box with the Delta and the total volume
imbalance 300 Imbalance (%): a row's bought volume at least 300% of the sold volume of the row below (compared diagonally) is a buying imbalance, a row's sold volume at least 300% of the bought volume of the row above a selling imbalance
highlight, buyHighlight, sellHighlight on, from the theme Highlighting: a vertical line on the outside of an imbalanced cell, on the right for buying and on the left for selling
stacked, stackedLevels off, 3 Stacked levels: imbalances in the same direction on 3 rows or more in a row draw a zone from the bar to the right, until the price comes back into it

Footprints need every trade and its aggressor, which cannot be worked out from bars:

  • Where the data comes from: history from the volume at each price of each minute given by the datafeed's getTradeMinutes(), and after opening, the trades streamed (side is required; trades without it do not count). Only the bars on the screen are fetched, from the latest backward, at most 6 hours at a time and two requests at once; the charts of one symbol share one copy.
  • No wrong numbers shown: a bar is drawn only once every one of its trades is in; otherwise the bar says "Loading", "No trades" or "Failed" (tried again shortly) below it, and the bottom left corner of the chart says why. A closed bar is also checked against the volume of the datafeed's bar: when they do not match (trades streamed during a disconnection were missed, say), it is fetched once more; with history, what is fetched again is used when it is within a thousandth of the bar (some platforms now and then count the last fills of an aggregated trade into the next minute), and otherwise, or without history, the bar is marked "No trades".
  • How far back: as far as the datafeed's getTradeMinutes() can go. Without it, or when it gives only the latest batch, footprints mostly start from the minute the chart opened (that minute itself is completed once it has ended and can be fetched, and stays "No trades" when it cannot).
  • Replay: only the trades up to where the replay is are used. Timeframes of seconds are not supported (trades are kept by the minute). A bar of more than 2000 rows is not drawn, with a hint to raise the ticks per row.

Time Price Opportunity (tpo, market profile): the price is a line of closes; each trading day has a profile, drawn at the start of the day, with a letter for every 30 minutes (A to Z, a to z, then A again), one in every row the price reached in that half hour; on the right, the volume of each row of the day.

Field Default Description
period, periodUnit 1, D Period: a profile for so many days (D), weeks (W) or months (M), by the symbol's trading calendar
block 30m Block size: 5m 10m 15m 30m 1h 2h 4h
rowSize, ticksPerRow auto, 10 Row size: auto splits the price range of the last 300 bars into 80 rows, rounded to multiples of 5, 50, 500…; manual is ticksPerRow ticks per row
valueArea 70 Value area (%, by the number of letters)
color1…color4 pink, green, cyan, purple Gradient colors: A, N, a and n are these four colors, going from one to the next over every 13 letters in between
blocks, letters, opacity, expand on, on, 44, off Blocks, letters (left out when cells are too small), the opacity outside the VA (%), split by blocks (each letter at the position of its time)
poc, vah, val on The point of control (the row with the most letters, filled across) and dashed lines at the top and bottom of the value area, with labels on the left
nakedPoc, nakedPocColor off, the color of the point of control Naked POC: a point of control of the profiles of up to 20 periods before that no bar has touched since, drawn as a dashed line from the right of its profile to the right of the chart; once a bar touches it, the line is no longer drawn
poorHigh, poorLow, singlePrints off Lines for a poor high and a poor low (more than one letter in the highest or lowest row); single prints (rows in between with only one letter) as bands across the day
midpoint, open, close off Labels for the TPO midpoint, the open and the close
initialBalance, initialBalanceBlocks on, 2 Initial balance range (IBR): the range of the first 2 blocks (the first hour), as a vertical line left of the profile; letters go by the time of their block within the period, and a block without trades takes a letter too
volumeProfile, volumeValues on, off The volume of each row (the volume of each block is spread over the rows it covers by their length, block by block, whatever the chart's timeframe), darker inside the value area; volumeValues writes the value of each row and the total of the day
volumeVah, volumeVal, volumePoc off, off, on Lines at the top and bottom of the value area of the volume and at its point of control (red by default), in the colors volumeLineColor and volumePocColor
volumePlacement left Placement: whether each row grows from the left (left) or the right (right) of the space for the volume

The letters are built from the chart's own bars: with Time Price Opportunity chosen, the chart fetches bars that can build both the current timeframe and the block size (30-minute bars for a daily chart with 30-minute blocks, say), so history, live data and replay all agree with the bars; when the datafeed has no bars that can build the blocks, the chart says so. When several rows tie for the point of control, the one nearest the middle of the profile is taken (and then the upper one); the value area grows from the point of control by comparing the row above and the row below each time and adding the one with more letters (when they tie, the one nearer the point of control, and then the upper one), and stops when adding the next row would go over 70%.

Not done yet: splitting a profile at a letter and merging it with the one before, "extending until the price comes back" for the lines, profiles split by trading session (pre-market, regular, after hours, custom), the summary info table, and alerts at these levels; the summary info table of footprints and alerts on imbalances and the Delta are not done either.

↑↓ to select · Enter to open · Esc to close