Public Data Dictionary
This data dictionary explains the public research-monitoring CSV and JSON exports published by CTO Scanner. It is intended for visitors who want to understand what each file contains, what its fields mean, and what the data should and should not be used for.
This data dictionary is for research and monitoring context only. It is not financial advice, does not recommend trades, and does not execute transactions.
Public Files
The following files are published by the nightly scanner/export workflow and are available on the public site.
daily_ai_summary.csv
A daily snapshot of high-level system stance, regime classification, and candidate count summaries for each scanner run. Each row represents one completed run. The file accumulates historical entries over time.
Intended use: monitoring how the system characterised market conditions
and candidate counts across dates.
Not for: inferring trade timing, market forecasts, or capital deployment
decisions from any individual row.
unified_candidates.csv
A snapshot of the current public observation-eligible candidate assets. Each row is one asset that met the criteria for public monitoring observation at the time of the latest run. Rows carry watch-tier, signal-band, and state labels.
Intended use: understanding which assets the system is currently observing
and at what watch tier.
Not for: treating any row as a buy/sell recommendation. All rows carry
status_note: public_observation_only.
signal_outcomes_history.csv
A historical export of signal outcome tracking records. Each row tracks an observed signal event — its labels, band, confidence, and post-signal excursion measurements (MFE/MAE). Open outcomes are incomplete observations; closed outcomes are finalised records.
Intended use: reviewing historical post-signal movement patterns for
research context.
Not for: inferring win/loss rates, profitability, or proof of trading
edge from these records alone.
public_manifest.json
A machine-readable inventory of all approved public files. Contains file names, sizes, modification timestamps, checksums where available, and the public disclaimer. Used by the dashboard and homepage to dynamically display file status and metadata.
Intended use: verifying which public files are available and when they
were last exported.
Not for: deriving signal or trading information.
public_system_summary.json
A sanitised row-level summary of the current scanner output. Contains asset-level labels, status classifications, and signal categories but excludes internal scoring details and private methodology internals.
Intended use: high-level review of what the latest scan produced.
Not for: reconstructing private scores or internal weighting logic.
public_status_summary.json
A small JSON record summarising the overall public launch readiness and export health
of the system at the time of the latest run. Contains flags such as
launch_ready, governance_locked, and freshness timestamps.
Intended use: checking whether the public site is considered healthy
and exports are current.
Not for: market direction or investment decisions.
Field Categories
Fields across the public files fall into the following categories.
Asset and Symbol Fields
| Field | Description |
|---|---|
symbol | Trading pair identifier (e.g. ETHUSDT). Identifies the asset being observed. |
asset_type | Category of asset (e.g. crypto). Informational — not a recommendation category. |
base | The base currency of the pair (e.g. ETH). |
quote | The quote currency of the pair (e.g. USDT). |
benchmark | The reference currency used for comparison in the system (e.g. USD). |
Timestamp and Freshness Fields
| Field | Description |
|---|---|
generated_at | UTC timestamp of when the row or file was generated by the export workflow. |
created_at | UTC timestamp of when a signal outcome record was first created. |
updated_at | UTC timestamp of the most recent update to a signal outcome record. |
Freshness fields reflect the latest export cycle. Public files are updated when the scheduled scanner/export workflow completes successfully.
Status and Readiness Fields
| Field | Description |
|---|---|
status | Outcome record status. open = observation in progress; closed = finalised record. |
status_note | Public export note. public_observation_only means the row is for observation context only, not a recommendation. |
current_state | Internal state label for an asset at the time of export (e.g. blue_state, gray_state). A monitoring indicator, not a directional signal. |
weekly_state | Weekly-timeframe state label. May be state_unavailable if not enough data exists yet. |
launch_ready | Boolean flag in public_status_summary.json. Indicates the public site export passed its health checks. Operational only. |
Governance and Safety Fields
| Field | Description |
|---|---|
cio_stance | System-level stance label (e.g. defensive_monitoring). Describes the overall system posture, not an investment instruction. |
governance_locked | Boolean indicating governance controls are active. When true, no capital deployment is authorised by the system. |
Candidate Monitoring Fields
| Field | Description |
|---|---|
public_watch_tier | Monitoring tier label (e.g. watch_tier_c, watch_tier_d). A to D tiers describe relative observation priority within the research system. Not a ranking for investment allocation. |
signal_strength_band | Band label for signal strength level (e.g. lower_signal_strength, medium_signal_strength). Describes internal model confidence bands, not price direction. |
market_cap_band | Approximate market-cap classification band. May be market_cap_unavailable if data was not available at export time. |
observation_bucket | Monitoring classification bucket (e.g. transition_watch, low_priority_watch). Groups observations by priority within the system. Not a recommendation tier. |
priority_watch_candidates | Count of candidates in the highest monitoring attention bucket in that run. |
deploy_candidates | Count of candidates internally flagged for potential deployment review. Does not mean capital was deployed. |
monitor_candidates | Count of candidates in active monitoring state. |
reject_candidates | Count of candidates filtered out in that run. |
Outcome Tracking Fields
| Field | Description |
|---|---|
signal_label | Internal label for the signal type recorded (e.g. young_trend_watch). Identifies the observation category. Not a trade action label. |
signal_score_band | Sanitised band representation of the model score at signal time (e.g. lower_model_score_band). Raw numeric scores are not exported. |
return_1d / return_3d / return_7d / return_14d | Observed percentage price change at 1, 3, 7, and 14 days after the signal was recorded. May be empty for open or recently recorded outcomes. These are historical observations, not forward predictions. |
max_favorable_excursion | Maximum observed price gain from the signal point during the tracking window. Abbreviated MFE. A tracking metric, not a performance guarantee. |
max_adverse_excursion | Maximum observed price drawdown from the signal point during the tracking window. Abbreviated MAE. A tracking metric, not a risk guarantee. |
Confidence and Quality Fields
| Field | Description |
|---|---|
confidence_band | Internal confidence label (e.g. medium_confidence_band). Describes the model's confidence level in the signal at the time of recording. Not a certainty claim. |
macro_regime | System classification of the macro environment at run time (e.g. crypto_outperformance). A monitoring label, not a forecast. |
market_leadership | System label for which market segment is leading at run time. Informational context for the monitoring record. |
market_transition | System label for the transition phase observed (e.g. expansion). A monitoring classification, not a market prediction. |
market_breadth | System label for breadth conditions (e.g. risk_on). A monitoring classification, not an investment signal. |
Public Export Metadata Fields
| Field | Description |
|---|---|
mode | Operating mode of the public system (value: research_monitoring_only). Confirms no live trading is active. |
financial_advice | Boolean. Always false. Confirms the system does not provide financial advice. |
live_trading | Boolean. Always false. Confirms no live trading is enabled. |
available | Boolean in system summary. Indicates whether the export was successfully generated. |
Status Values Glossary
Status values in the public exports and dashboard are operational, readiness, governance, and data-quality indicators. They describe internal system states — not market direction, buy/sell signals, or investment recommendations.
| Value | Type | Meaning |
|---|---|---|
red |
governance | System state is in an attention-required condition. Governance controls are active. No capital deployment authorised. |
blocked |
permission | System permission gate is closed. Actions requiring approval are not proceeding. Not a market direction indicator. |
not_ready |
readiness | A component or data source has not met its readiness criteria at this run time. Informational — does not describe an asset's market condition. |
restricted |
governance | Governance is in a restricted mode. Activity is limited to monitoring. Not a market-bearish signal. |
poor_quality |
quality | A quality assessment of decision inputs is below threshold. Used internally to flag that conditions for high-confidence decisions are not met. |
very_low_confidence |
confidence | Internal meta-confidence is very low. The system is in a monitoring-only posture. |
extreme |
stress | Market stress is classified as extreme by the monitoring system. A monitoring label, not a prediction of market direction. |
research_monitoring_only |
mode | The public system is operating in research and monitoring mode only. No live trading or capital deployment is active. |
launch_ready |
export health | The public export passed its health and freshness checks at the time of the last run. Operational indicator only. |
available |
export health | The relevant export file or summary was successfully generated and is present. |
public_observation_only |
scope | Rows tagged with this value in status_note are published for observation context only. They are explicitly not recommendations. |
open |
outcome | Outcome tracking record is still in observation. The post-signal window has not closed yet. |
true / false |
flag | Boolean flags. In public exports: financial_advice: false, live_trading: false, governance_locked: true. These confirm system operating constraints. |
What These Files Are Not
- Not trading recommendations.
- Not buy/sell signals.
- Not portfolio allocation guidance.
- Not proof of future performance.
- Not a complete internal methodology record — internal scoring details, weighting internals, and private control files are excluded from all public exports.
- Not a replacement for human review — any real decision requires independent analysis, risk controls, and human approval.
- Not real-time data — all files reflect the latest completed export cycle, not a live feed.
Freshness and Update Cadence
Public files reflect the latest export available to the static site. They are updated when the scheduled scanner/export workflow completes successfully. No guarantee of continuous, real-time, or guaranteed updates is made.
The generated_at field in each CSV row, and the latest_public_export
field in public_status_summary.json, indicate when the data was last refreshed.
Disclaimer
This data dictionary and all referenced public files are provided for research and monitoring purposes only. They are not financial advice, investment advice, or a recommendation to buy, sell, or hold any asset. Data may be incomplete, delayed, or incorrect. Any real-world decision requires independent review, risk controls, and human approval.