Parameters

Two forms, one set of names

Each option is a data- attribute on the placeholder, or a query parameter on the iframe URL. The names and values are identical either way, so a snippet translates between the two by moving the dashes.

<div class="vp-chart"
     data-symbol="AAPL"
     data-interval="60"
     data-theme="light"></div>
<script src="https://view.verticalprop.com/embed.js" async></script>

<iframe src="https://view.verticalprop.com/embed?symbol=AAPL&interval=60&theme=light"
        width="100%" height="420" frameborder="0"></iframe>

Reference

The same options, after the chart has mounted

Every parameter here is read once, when the frame loads. Several have a live equivalent through the loader, and the table below identifies which. A page that only ever renders markup can ignore it, and a page whose chart changes needs nothing else.

symbol

The instrument to draw. Four shapes resolve, and the chart picks the venue from the shape rather than asking you to name one:

interval

The bar size the chart opens on. With toolbar on, the reader can change it; with the toolbar off, this is the only interval they will see.

With datafeed=host, the opening interval and chart.setInterval()use the host datafeed's onReady().supported_resolutions. For example, declare ["1", "3", "5"] to use data-interval="3" orchart.setInterval("3"). Unsupported opening intervals report a data error; unsupported commands reject without changing the interval. If the feed omits the list, the default intervals above apply.

symbolSearch

Keep toolbar=true and set symbolSearch=0 in the iframe URL, or data-symbolSearch="false" on the loader element, to hide only the built-in pair selector. Your own selector can still call chart.setSymbol().

<div class="vp-chart"
  data-symbol="BTC-USDCX"
  data-datafeed="titan"
  data-toolbar="true"
  data-symbolSearch="false"
  data-interval="3"></div>

theme

Two themes, and no automatic matching of the reader’s system setting, an embed sits inside your page, so it should follow YOUR design rather than their OS. If your site has a theme toggle, send setTheme when it flips.

type

Five chart types. candles and bars show the full range of each period; line and area show closes only, which reads better at small sizes and in a column of prose. footprint is the fifth and is not drawn below: it shows volume per price level inside each bar, which only exists when your datafeed supplies order flow, so on the first-party feed these panels use it would be four charts and an empty one. See order flow for the three ways to feed it.

numberFormat

How every number is punctuated. Leave it out and the chart follows the reader’s own locale, which is usually right: an English article read from Berlin shows 1.234,56 to the person in Berlin. Pin a preset when the numbers must read one way for everybody, and read the price scale to see the difference.

sessions

Tinted bands behind the bars marking a venue’s sessions. us gives the two US equity bands; anything else is spelled label@HH:mm-HH:mm, comma-separated, with an optional @days such as @12345, the weekdays it applies to as digits. Hours are read on the instrument’s own clock, and a band whose end is at or before its start wraps midnight, so Overnight@22:00-06:00 is an eight-hour band. Absent, no bands are drawn.

toolbar and legend

Both off is the smallest honest chart: a price series, an axis, and the attribution mark. Both on is close to the full terminal experience. Most articles want the first; a “live prices” page usually wants the second.

Height and width

The chart always fills its container’s width. Height is yours to set: with the loader, data-height is the STARTING height and the frame then reports what it would like, so the chart is never letterboxed. Without the loader, the height you put on the <iframe> is final.

Below about 200px the chart drops its axis labels to keep the series legible, and below roughly 320px wide the drawing rail is hidden automatically, a phone should spend its width on candles, not on a column of tools nobody uses with a thumb.

Unknown parameters

Anything not in the table above is dropped by the loader and ignored by the chart. That is a deliberate allowlist rather than an oversight: it means a parameter cannot be smuggled through to something that was never reviewed, and it is what makes the attribution mark structural rather than a default somebody can turn off.