Fund Analyst Intelligence

Documentation

How the deterministic engine, heatmap and fund-specific chats work together.

1. Scope & intended users

Fund Analyst Intelligence is a research tool for investors, analysts and risk professionals who need transparent, repeatable analytics on listed funds. The platform combines a deterministic KPI engine with an ISIN-scoped chat interface. It is designed to support internal analysis and documentation, not to provide personal investment advice or trade execution.

For legal, privacy and security information, please refer to the Legal page.

2. Fund universe & identifiers

The platform maintains a canonical universe of funds. Each fund is represented as a single canonical entry, even if it has multiple share classes or listings. Analytics, chats and reports are always attached to that canonical fund.

  • Primary key: internal canonical fund ID.
  • External identifiers: ISIN (main anchor), provider name and listing symbols, where available.
  • Metadata: domicile, asset class estimate, benchmark, base currency and other descriptive fields.

When you open a tile from the heatmap or follow an ISIN link, you are always taken to the canonical record for that fund.

3. Deterministic NAV engine & snapshots

For each fund, the engine ingests NAV history and benchmark data and computes a set of deterministic key performance indicators (KPIs). Typical metrics include:

  • Realised returns over multiple horizons (e.g. 1M, 3M, 1Y, 3Y).
  • Realised volatility, drawdowns and simple risk buckets.
  • Relative performance versus the stated or inferred benchmark.

Calculations are deterministic and reproducible: given the same NAV inputs and configuration, the engine produces the same outputs. No stochastic simulations or scenario generators are used inside the live heatmap or the default KPIs.

Internally, the engine takes time-stamped NAV inputs and produces dated snapshots (for example monthly or quarterly). Chat sessions and reports refer back to these snapshots so that numbers can be traced to a specific data cut.

4. Heatmap & colour legend

The landing heatmap visualises the current fund universe by realised 1-year return. Each tile is one canonical fund. Tile size is influenced by the magnitude of the return, and colour encodes the return bucket.

  • Red shades: negative 1Y returns (deeper red for more negative outcomes).
  • Grey: approximately flat performance around zero.
  • Green shades: positive 1Y returns (deeper green for stronger gains).

Hovering a tile shows a tooltip with the fund name, ISIN, current NAV and risk bucket. Clicking a tile opens a dedicated chat for that fund and creates (or re-opens) a "one fund, one conversation" session.

5. Chat sessions & reports

Each chat is scoped to a single fund. The application enforces this rule and warns users if they try to mix ISINs within one session. Within a chat, you can:

  • Ask questions about the fund's historical behaviour and risk profile.
  • Request structured outputs such as performance summaries or simple scenario-style views based on the deterministic KPIs.
  • Iterate on explanations while preserving the same fund context and backend snapshot.

The conversational layer is built to be MiFID-aware: it does not perform personalised suitability assessments and does not issue direct "buy/sell/hold" recommendations.

6. Plans, usage limits & access

Access to the platform may be governed by usage plans. Plans can limit, for example, the number of distinct funds tracked per user, the volume of chat interactions or the availability of downloadable reports.

When a plan limit is reached, the application surfaces a clear message. It does not silently change the analytics or degrade the quality of the deterministic KPIs.

7. Data freshness & updates

NAV and benchmark data are refreshed on a scheduled basis. After each successful refresh, a new deterministic snapshot is produced and used for subsequent heatmap tiles, chats and reports.

If data for a fund is stale, incomplete or missing, the application may temporarily hide that fund from the heatmap or display a warning banner in the chat. This is to avoid giving a false impression of completeness.

8. Further technical documentation

Interested readers can access the complete detailed documentation reference set in the documentation pages.

For early access to technical material or integration questions, please contact contact@fundanalyst.app.