Updated
What a why-note says, and what it never says
A why-note is a short note under an alert. It describes how the move looked. The sentences can come from a model. Every number in them is written by code, from facts stored when the alert fired. If a number is not on that sheet, it does not appear.
It does not tell you what to do with a coin.
Where the words come from
The model receives lines the code already formatted. It does not receive raw tables or an earlier note. Those lines are the only material the words may use.
A draft is cut to two sentences. The model is asked to keep it to 45 words. If the first draft fails a check, it is written once more with the problems named. If the second draft fails, no partial note is shown.
The label under a note the model wrote is "AI-written · numbers from market data". That label follows model sentences only. A fallback line has no label. Lines written entirely by code, including a world line, have no model label.
A phone notification does not carry the note. It shows the code-rendered facts only. The note is on the alert page the tap opens, and in email when a note was added. Delivery describes those copies. How a why-note is written is the short public account of the same rules.
What the fact sheet contains
A line is included only when its value exists. A missing value is left out. It is not replaced with zero.
The sheet can name the coin, the last price, and its exchange. It can name the change over the alert's window and over the other windows already stored. When enough minutes are stored, it adds the high, the low, which came first, and the largest short change. It can add trading volume next to that coin's own average, and how Bitcoin (BTC) and Ethereum (ETH) changed over the same window when those prices are fresh.
A price level has no window of its own. Its note looks at the last hour.
Funding and open interest are named only when a licensed source was stored on that alert. Without that block, a draft that mentions them is refused. When world lines are off, news is listed as not available, so a note cannot invent a headline as a cause. When world lines are on, they replace that line. Crypto next to world events: what "same window" means explains them. A note may mention at most two events from its own sheet, only as happening in the same window, with the time, and in a sentence that does not also carry the move.
The checks on a draft
Code checks the draft before anyone sees it.
Every money figure, percent, and plain number must match the sheet, including the sign of a percent. A window label such as "1 hour" must already be on the sheet, and it cannot stand in for a different number. A rounded figure is allowed only as that same number, rounded.
A draft is refused if it tells you what to do with the coin, names a future price, or names a cause the sheet does not list. A capitalized name must be one the sheet allows, such as the coin, Bitcoin, Ethereum, or the exchange on the price.
A world event may be named as in the same window, with its time, and not as the cause. The note may not add which way a central bank moved. The title does not say that.
Notes on the same coin, window, and direction can share one note inside the same 5-minute bucket, and only when it still passes this alert's checks. Different numbers get their own note.
When there is no note
The price and the receipt stay when there is no model sentence. How alert receipts are recorded is that later record. Alerts and rules is where the note sits.
When no model is available, both drafts fail, the sheet has nothing to explain, or the call fails, the alert shows: "A note was not added to this alert. The recorded price is shown above."
When the monthly allowance is used and nothing is left to pay for another note, the alert shows: "The note limit for this month is used. The recorded price is shown above." Free includes a monthly allowance. How a why-note is written states the count for each plan. This page does not copy a plan's price.
When notes are paused for the rest of the month on a paid plan, the alert shows: "Notes are paused on this account for the rest of the month. Alerts still arrive with the price."
The button on the alert uses the same checks. If the allowance is used, that request can spend credits when the account has them. A note queued for every alert does not switch to credits on its own. A failed check does not show a half-written sentence. The price, the source, and the time remain. So does the receipt at 1 hour, 4 hours, 24 hours, and 7 days. A slot that is not due yet says it is not in yet. A missing price is not written as zero.
Terminal shows a why-note only when every number in it matches the stored facts, and it keeps the price and the receipt when a note is not added.
FAQ
Who writes the numbers in a why-note?
Code writes them, from the fact sheet stored with the alert. The model may write the words around those numbers. A money figure, a percent, or a plain number that is not on the sheet is rejected, and the draft is not shown.
What do I see if no note is added?
You see one plain line. It says a note was not added and that the recorded price is shown above, or it says the monthly limit is used, or that notes are paused for the rest of the month. The alert and its later prices stay either way.
Can the note name a future price?
No. A draft that names a future price is refused. The note describes what the stored facts already say. The later prices are the receipt, filled when each clock arrives.