Signal outcomes ledger
flag_outcomesRead-onlyIdempotent
Recently fired signal-ledger flags with fire-time price and later price outcomes, logged live and never backfilled. Descriptive market data only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | Filter to one coin, for example BTC. A pair like ETH/USD works too, the quote leg is dropped. One symbol, not a list. Omit for every coin. | |
| pair | No | Alias for coin. | |
| type | No | Filter to one signal type. One of: whale-spike, funding-extreme, squeeze-flip, liq-cascade, flow-divergence, major-pctile, major-block, deriv-record. The underscore spellings used by alert rules (for example funding_extreme, or spike for whale-spike) are accepted too. Anything else is refused by name rather than answered as every signal. Omit for all types. | |
| hours | No | How far back to look, in hours. Defaults to 48. Capped at 168 keyless and 720 on a developer plan; asking for more returns the cap, and the payload says so in `capped`. The all_time block is unaffected by this window. | |
| limit | No | Max rows returned. Capped at 25 keyless and 500 on a developer plan; asking for more returns the cap, and the payload says so in `capped`. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | The coin filter applied, or null for all coins. | |
| note | No | One line saying what the numbers cover, or why there are none. Read it before reporting any zero as a market reading. | |
| type | No | The signal type filter applied, or null for all types. | |
| count | No | How many rows this reply carries. | |
| hours | No | The window actually read, in hours. | |
| capped | No | Present only when an argument was cut down to a ceiling. Absent means nothing was clamped, so a smaller number than you asked for is the data and not a limit. | |
| signals | No | The signals that fired in the window, each with its type, coin, fire time, price at fire time and later price outcomes where they have been scored. | |
| all_time | No | Permanent counters from the archive, independent of the window asked for: fired, scored_h24, since, through and by_type. | |
| available | No | False when this lane could not answer: a producer is dark, the pair sits outside this plan, or the argument named something we do not carry. Absent or true means the numbers are a real reading, not a guess. | |
| aggregates | No | byType: how many fired per signal type inside the window. | |
| depth_note | No | How far back the data behind this answer reaches. | |
| access_note | No | What this connection could not return and what lifts it. Always pass this on to the user: it is the only place that information appears. | |
| valid_types | No | The signal types that do exist, returned alongside unknown_type. | |
| unknown_type | No | Set when the type asked for is not one this record keeps. Nothing was filtered and nothing was searched. | |
| total_in_window | No | How many signals fired in the whole window, before the row cap. |