Market Structure Analyst
Describes what the chart shows, and refuses to tell you what to do
- 9hard rules
- Things it must never do, enforced in every run
- 5handover rules
- Conditions where it stops and gives the work to a person
- 10output fields
- A structured result, not a paragraph you have to re-read
- ≤5steps per run
- Bounded work: at most 4 tool calls, enforced by the runtime
Read-only by design. This agent has no path to sending, spending, publishing or committing anything. Where that limit is the product, removing it would remove the reason to trust the output.
Overview
Automated chart tools sell signals: buy, sell, target, stop. Two things are wrong with that. Telling someone what to do with their money is regulated investment advice in most markets. And it is false — an indicator is arithmetic on past prices, and dressing it in the language of a prediction is the most expensive lie in retail finance.
This agent describes instead. Where price has ranged and for how long, which levels have actually been tested and how many times, whether volatility has expanded or contracted against its own history, where volume behaved unlike itself, and where the structure it just described would no longer hold.
Every observation carries its sample. A level touched twice is reported as a level touched twice — because a line through two points is not a level, and no tool that draws it confidently will tell you so. It makes no recommendation, sets no target, sizes no position and predicts no price, and it says so in every output. That refusal is what makes it usable by a person who has to answer for the decision.
Benefits
Analysis you can defend
Every statement traceable to the series and its sample size.
The hours of chart reading, done
Structure across many instruments and timeframes, described consistently.
Nothing to be liable for
It describes; you decide. That boundary is what makes it distributable at all.
What it does
Every observation carries its sample
A level touched twice is reported as touched twice. A line through two points is not a level, and confident tools never say so.
Volatility against its own history
Whether the current range is unusual for this instrument, not for markets in general.
Says where the description breaks
The condition under which what it just described stops being true — more useful than the description itself.
Flags data it should not trust
Gaps, thin volume, a series too short to characterise. Bad data produces confident nonsense everywhere else.
Separates observed from inferred
What the series contains, and what someone might read into it, are never in the same paragraph.
Recommends nothing, ever
No signal, no target, no stop, no position size, no price prediction. That is regulated advice, and it is not this agent's to give.
What this changes
What this changes about your week
- It takes over
- Reading charts across a watchlist and writing down what actually changed.
- Done today by
- The trader, every morning, before anything else.
- How often
- Every session, across every instrument watched.
- Typical manual effort
- Reviewing twenty instruments properly is a morning.
Why Finance & Accounting in particular. It reports the sample behind every level. A line through two touches is not a level, and no signal tool will ever tell you that — it will draw it confidently instead.
Runs unattended
Started by you or by an event, and it finishes on its own. Nothing waits for someone to be at a desk.
The same standard every time
The two-hundredth item is held to the bar the first one was. Consistency is the part people cannot sustain.
It cannot act on its own
Market Structure Analyst has no path to sending, spending or committing. That limit is why its output is safe to act on.
How it runs
This agent runs server-side through the PROMIVO runtime. Each run is logged step by step and every tool call is permission-checked before it executes.
- 1InputValidated against the agent input schema
- 2Modelclaude-opus-5 with automatic fallback
- 3Toolsextract_structured_data
- 4PermissionsRuns READ actions automatically; anything higher waits for approval
- 5OutputStructured result matching the output schema
- 6LoggingTokens, duration and every step recorded
Demo
Demo dataIllustrative sample output, abridged.
Input
{
"series": [],
"timeframe": "4h",
"instrument": "BTC/USDT"
}Output
{
"levels": [
{
"price": 64200,
"touches": 6,
"lastTested": "2026-08-27"
},
{
"price": 58900,
"touches": 2,
"lastTested": "2026-07-11"
}
],
"sample": {
"to": "2026-09-01",
"from": "2026-06-01",
"timeframe": "4h",
"instrument": "BTC/USDT",
"observations": 540
},
"escalate": false,
"observed": [
{
"evidence": "88% of closes fell between 58,900 and 64,200 across 540 bars.",
"sampleSize": "540 observations over three months.",
"observation": "Price has held a range for most of the period."
},
{
"evidence": "20-bar realised volatility is at the 14th percentile of its last 500 bars.",
"sampleSize": "500 bars for the percentile.",
"observation": "Realised volatility has contracted against this instrument's own recent history."
}
],
"cannotSay": [
"Which direction price will move, or when.",
"Whether either level will hold again. Six touches describes the past and constrains nothing.",
"Why the range formed — that is not in a price series."
],
"disclaimer": "A description of a price series. Not investment advice, not a recommendation, not a forecast, and not a basis for a trading decision on its own.",
"dataQuality": [
"Two bars carry zero volume and were excluded from the volume comparison."
],
"wouldNoLongerHoldIf": [
"A close outside 58,900–64,200 that is not reversed within the next few bars would end the range description."
]
}Requirements
Integrations
No integrations required.
Before you start
- A price and volume series — OHLCV, any timeframe
- The instrument and the period it covers
- Requires the All-Access plan or higher
Use cases
Morning review
What changed structurally overnight across a watchlist.
Before a decision you have already made
What the data actually supports, and what it does not.
Reviewing your own thesis
Whether the structure you believed in is still there.
Pricing
All-Access
Billed monthly through your PROMIVO subscription. Cancel at any time.
Runs consume your plan allowance for agent executions and tokens. See plan limits
FAQ
Will it tell me when to buy or sell?
No, and be wary of anything that does. Telling a person what to do with their money is regulated investment advice in the EU, the UK and most markets. It describes structure; the decision and the responsibility stay with you.
Does it predict price?
No. An indicator is arithmetic on prices that have already happened. Anything presenting that as a forecast is selling you confidence rather than information.
Does it include market data?
No. You supply the series — an export, an API response, whatever your source is. A tool that quietly re-sold you someone else's feed would be adding a dependency and a licence problem you did not ask for.
Does it work for crypto specifically?
It works on any price and volume series. Crypto's thin books, exchange-specific prints and weekend sessions are exactly why the sample-size reporting matters more there than anywhere else.
Reviews
Reviews open once customers have run this agent.
Need this agent to work differently?
Tell us what to change and our team will scope a customised version for your business.
Customize this agent