About this plugin
Stockdio Historical Chart contains a plugin and a widget that provide the means to display a live chart with intraday and historical prices and information for stock, index, currencies or commodities. Over 65 different stock exchanges and a large number of market indices, currencies and commodities are supported.
If you’re using the standard Gutenberg editor, the easiest way to include this plugin on your page is using the Historical Chart block, which is included in the Stockdio Financial Visualizations category.
If you’re using a different editor o prefer to use the shortcode, below is a sample to help you start. Please be aware that most of the parameters listed below are optional, and are also available through the plugin’s settings page. Any parameter you include in the shortcode will overwrite the parameter used in the settings page.
[stockdio-historical-chart symbol="AAPL" stockExchange="USA" width="580" height="380" motif="financial" palette="financial-light"]
This plugin is part of the Stockdio Financial Widgets, which also includes the following plugins:
- Stock Quotes List.
- Stock Market Overview.
- Stock Market News.
- Stock Market Ticker.
- Economic & Market News.
The following parameters are supported in the shortcode and also available through the plugin’s settings page:
stockExchange: The exchange market the symbol is a member of (optional). If not specified, USA Equities will be used by default. com/exchanges.
symbol: The company’s stock symbol (ex. AAPL ), market index ticker (ex. ^SPX ), currency pair (ex.
EUR/USD ) or commodity ticker (ex. GC ). com/indices.
com/commodities.
compare: Specify a list of valid stock symbols or market indices against which to compare the base symbol, separated by semicolon (ex. MSFT;GOOG;^SPX;^IXIC ). Not case sensitive (optional).
height: Height of the chart in either px or % (default: 320px).
width: Width of the chart in either px or % ( default: 100%).
displayPrices: Allows to specify how to display the prices on the chart, using one of the following options (default: Line):
- Line
- Candlestick
- Area
- OHLC
- HLC
includeVolume: Allows to display or hide the volume on the chart. By default, volume is visible. Use includeVolume=false to hide it (optional).
performance: If enabled (true), price performance (percent change) will be displayed, instead of actual price.
g. Spanish-Spain). com/cultures.
intraday: If enabled (true), intraday delayed data will be used if available for the exchange and number of days is between 1 and 5. com/exchanges.
days: Allows to specify the number of days for the period to display. Used only if the start and/or the end date are not specified. If not specified, its default value is 365 days.
If intraday data is available for the stock exchange and the exchange is currently open, the default number of days is 1.
allowPeriodChange: If enabled (true), it provides a UI to allow the end user to select the period for the data to be displayed. This UI is only available if the from and to parameters have not been specified. This UI is enabled by default.
from: From date. If not specified, the “from” date will be the “to” date minus the number of days specified in the days parameter.
to: To date. If not specified, the “to” date will be today’s date.
motif: Design used to display the visualization with specific aesthetics, including borders and styles, among other elements. (optional). com/motifs.
palette: Includes a set of consistent colors used for the visualization. (optional). com/palettes.
font: Allows to specify the font that will be used to render the chart. g. Lato,Helvetica,Arial.
loadDataWhenVisible: Allows to fetch the data and display the visualization only when it becomes visible on the page, in order to avoid using calls (requests) when they are not needed. g. ).
g. using one instance of the plugin for mobile and another one for desktop). We recommend not using this by default but only on scenarios as those described above, as it may provide the end user with a small delay to display the visualization (optional).