An open-high-low-close candle stock graph is a graph that is specifically designed for showing the opening, high, low, and closing prices of a stock on a particular day. Each stock marker displays four separate values.
The constant for this graph type is STOCK_OHLC_CANDLE
.
You use stock graphs to show more than one stock price for a stock.
The following figure shows the data structure of a STOCK_OHLC_CANDLE
stock
graph.
The data structure for open-high-low-close candle stock graphs is as follows:
A group is a four-column set or, if data columns are shown as series, then as a four-row set of data. Each group is represented by a single stock marker. If you show data for more than one group, then the opening, high, low, and closing values should vary faster than the Time values. That is, the order of the columns (or rows) should be Monday Open, Monday High, Monday Low, Monday Close, Tuesday Open, Tuesday High, Tuesday Low, Tuesday Close, and so on. A group is labeled by an O1 tick label, such as Mon.
Candle stock graphs display only one series of data. If you have more than one series of data, then only the first series is displayed. For this reason, no legend appears in a candle stock graph. You should show the series label in the title of the graph.
Each group in this kind of stock graph has four measure values:
The first value is the opening price. The opening price defines the top or the bottom of the candle (rectangle).
The second value is the high price, which defines the top of the line that is attached to the top of the candle (the wick). This value is not visible if the high value is equal to the open or close value.
The third value is the low price, which defines the bottom of the line that is attached to the bottom of the candle (the wick). This value is not visible if the low value is equal to the open or close value.
The fourth value is the closing price. The closing price also defines the top or the bottom of the candle.
The lesser of the open and close values defines the bottom of the candle. The greater value defines the top. If the closing value is greater than the opening value, then the candle is green. If the opening value is higher than the closing value, then the candle is red.
Data for this kind of stock graph has the following guidelines:
All graphs show numeric data only.
The open-high-low-close candle stock graph must have at least four columns of data (or rows of data, if columns are series), in this order:
Open
High
Low
Close
If the data has fewer than four columns (or rows) of data, then the Graph bean displays a message about insufficient data, instead of displaying a graph.
If the closing price lies outside the high and low range, then the graph
sends an AlertEvent
to any registered AlertListeners
.
The ID for the AlertEvent
is DATA_STOCK_OPEN_OR_CLOSE_OUT_OF_RANGE
.
To display stock data for more than one day, the data must be in multiples
of four, such as four columns or rows for Monday, then four for Tuesday,
and so on. If the last group does not have four columns (or rows), then
the graph does not display that group. The graph notifies any registered
AlertListeners
of this problem by sending an AlertEvent
,
with DATA_PARTIAL_GROUP
as its ID.
Open-high-low-close candle stock graphs can have only one series of data. If you have more than one series of data, then only the first series appears in the graph. This graph type does not display a legend, so you should display the name of the stock in a title.
Time axis data must be regular, complete, and in ascending order. If it is not, then the graph displays a regular ordinal axis rather than a time axis. The graph recognizes time data that skips days when stocks are not traded.
The following graph shows the stock data for one stock for two different days.
The following table shows the structure of the data that the stock graph displays.
This example assumes that Graph.isDataRowShownAsASeries
returns
true
.
Mon Open | Mon High | Mon Low | Mon Close | Tues Open | Tues High | Tues Low | Tues Close |
---|---|---|---|---|---|---|---|
30.25 | 47.63 | 28.33 | 40.13 | 40.75 | 45.13 | 31.13 | 31.75 |
Stock Graphs
Handling Problems
in Graph Data
Specifying Data for a Graph
Example: Setting Data from
a File on a High-Low-Close Stock Graph