ChartnautDocs

Show studies on charts

To see a study's numbers while you trade or replay, attach the study to the chart as a Forward Insight. You do not edit the study code yourself: the wizard updates it and runs it again.

The study has to measure what happens after the event. Forward Insights covers what the script needs. To create one from the API or an AI app instead, you write pin_cell yourself: From the API or an AI app.

Attach a study run

  1. Open the finished run. In the study builder it is the run card. In the Agent, click Open the full report on the Study results card.

  2. Click Attach to chart.

  3. Under What do you care about?, pick the result you want on the chart and click Continue.

  4. Under Break down by, pick the dimensions that should change the reading, or none for one global card.

  5. Click Apply breakdown. Chartnaut updates the study, saves the change, runs it again and builds the chart card. This takes about a minute.

  6. Check the preview under What the trader sees on a matching event.

  7. Type a Pin name and click Save pin.

Attach to chart wizard
The Break down by step, with distance from VWAP picked.

Applying a breakdown saves a new study version and a new run. The Forward Insight belongs to that run, and the run you started from stays as it was.

Where it shows

A Forward Insight belongs to one definition, one profile of it and the timeframe the study ran on. Open Trading → Charts on that timeframe, add the definition with the same profile, and click one of its marks. It works live and in replay. Forward Insights on the chart explains the popover.

To list, preview or archive them, open the definition from Tools → Definitions and go to its Forward Insights tab.

When it goes wrong

What you see

Fix

Not a forward insight yet

The study only measures before or during the event. Add a forward read, such as ctx.candles.forward.

This study doesn't publish a metric that can go on the chart yet

Declare and publish the number as a metric result, run the study again and attach that run.

Couldn't apply your breakdown

Nothing was saved. Go back, adjust the breakdown and try again. Pin validation errors lists the causes.

No study pin on this chart yet

Switch the chart to the timeframe the study ran on.

The same number on every event

You picked no breakdown, or the study has no scope dimensions. Add them, then attach again.