How research works
Research in Chartnaut answers one question: when this setup happened before, what came next? A definition finds every time the setup happened, a study measures what followed, and a Forward Insight puts the answer on your chart. All three live under Tools → Definitions, and all three need Starter or above.
Test your first trading idea walks through the whole loop with one real example. This page explains the parts.
Definitions
A definition is a trading idea written down precisely enough that Chartnaut can spot it on a chart. Price breaks the first 15-minute range of the New York session on BTC while above session VWAP is a definition. So is a London session sweep of the Asia high that fails to hold.
You describe the idea and the agent writes it as a script. The builder shows the agent's chat beside a chart preview, so you check its marks on real days as it works. Build a definition covers the builder, and Scripting covers writing one yourself.
A definition can read indicators such as VWAP, ATR or your own. When the agent wants one, it asks you first. Indicators inside definitions explains how.
Events
Every time the definition's setup happens, it records an event: the bar where it happened, plus whatever details the definition was written to record. The opening range definition records the direction of the break and how far price was from VWAP.
Events are what everything else is built on. A study measures them, and a Forward Insight fires on them. Browse events shows how to open any one of them on a chart and check it with your own eyes.
Versions and profiles
Every working change to a definition is saved as a new version. Events, studies and Forward Insights belong to the version they were made with, so changing the definition never quietly changes an answer you already have.
A definition can expose settings, such as the length of the opening range. A profile is a named set of those settings for one version, with its own events and studies. Profiles let you compare a 15-minute range with a 30-minute one without copying the definition. Versions and profiles covers both.
Running over history
A definition finds its events by running over past data. You pick the instrument, the chart interval and a date range, and Chartnaut runs the definition over every bar in it. Two years of BTC found 786 opening range breaks.
Each run becomes a dataset on the definition's Overview tab, and you can add more instruments and ranges at any time. Run a definition over history walks through it. How many events you can keep depends on your plan, listed on Definition events.
Studies
A study asks a question of the events. How often did price reach the prior day's high? What came first, the target or the stop? Does it matter how far above VWAP the break started?
Studies live on the definition's Studies tab. You ask the question in plain words and the agent writes the study, shows it to you for approval, and runs it over the datasets you pick. Build and run a study covers the whole process, including the Guided, Collaborative and Technical ways of working with the agent.
Results
A study's results are the numbers, tables and charts it publishes. For the opening range: bullish breaks from above the upper VWAP band reached the prior day's high 51 times in 61.
Every result comes from events you can open and check. A strong percentage from a small group deserves a look at the events behind it before you trade on it. Read the results explains each kind of result and what to watch for.
Forward Insights
A Forward Insight is a study's answer attached to the chart. You create one with Attach study to chart below a finished study's results, and it appears on the definition's Forward Insights tab.
From then on, when the definition marks the setup on a chart, live or in a replay, clicking the mark shows what usually happened next. The next BTC break above the upper band shows 51 in 61 on the bar where it happens. Forward Insights covers creating and managing them, and Forward Insights on the chart covers how they look while you trade.
Definitions on the chart
A definition does not have to be part of a study to be useful. Add it to a chart and it marks the setup as it happens, the same way it marked history. Definitions on the chart explains how.
Research and your own trading
A study tells you what the market does. Your playbooks tell you what you do with the same setup, and Historical Intelligence learns from your own trades. Together they show whether your version of the setup matches the market's.
Definitions shared by other traders are in the community library, ready to add to your library and run over your own history.