tidal-ts
tidal-ts draws financial time series: price bars, volatility curves, and the technical studies traders lay over them. It is built on pond-ts, and it came out of Tidal, a volatility analytics terminal, so that other apps can draw the same chart without Tidal's controls or data layer.
Pre-1.0: pin an exact version. All three packages ship together on one version number.
The packages
| Package | What it gives you |
|---|---|
@tidal-ts/core | Every study in the catalog, the volatility data layout, bar windows, the wire-format adapter, sessions and time zones. |
@tidal-ts/chart | TimeSeriesChart, the settings that describe what to draw, and the step that prepares data for it. |
@tidal-ts/terminal | A state machine that holds a chart's setup (rows, series, studies, axes, saved presets), never its data. |
The dependency runs one way: terminal uses chart, chart uses core.
Built on pond-ts
tidal-ts is a layer over these pond-ts packages. They are peer dependencies, so your app installs them itself (see Getting started for the versions).
| Package | What tidal-ts uses it for | Docs |
|---|---|---|
pond-ts | The TimeSeries every chart and study reads: typed columns, windows, alignment, aggregation. | pond-ts (core) |
@pond-ts/financial | The technical studies themselves, trading calendars and session-aligned bars. | @pond-ts/financial |
@pond-ts/charts | The canvas drawing: candles, lines, bands, bars, axes, cursors and annotations. | @pond-ts/charts |
@pond-ts/process (runs studies as content-addressed specs) and
@pond-ts/react (React hooks for live series) are peers too.
How the pieces fit
- Your app fetches the data. tidal-ts never makes a network call. You turn
your API's response into a pond
TimeSeries(core has an adapter for a column-by-column wire format). - You describe the chart. Each line, candle series or study is a small settings object: which column, which colour, which axis, which row.
- The prepare step does the work. It computes every study, works out the axes, and hands back rows the chart can draw.
- The chart draws. Its theme and colours come in as props; it reads no CSS and needs no provider, so it fits into any design system.
If you want users to build their own charts (add a study, move a line to another axis, save a layout), the terminal package holds that state for you.
Where to go next
- Getting started: install, then a chart with candles, a moving average and an RSI panel.
- The study catalog: every study with a live chart, its settings, and how traders use it.
- Storybook: the chart's workshop, with every story the package is tested against.