> ## Documentation Index
> Fetch the complete documentation index at: https://retinaos.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cortex: On-Chain Wallet and Token Reputation Intelligence

> Cortex is RetinaOS's scoring engine — turning raw on-chain history into behavioral wallet classifications and composite trust scores.

Cortex is the intelligence layer embedded inside Retina Terminal. It converts raw on-chain trade history into meaningful reputation signals — telling you not just what a wallet has done, but how reliably and intelligently it has done it. Cortex scores appear directly on wallet and token pages; there is no separate app to open.

## What Cortex Produces

<CardGroup cols={2}>
  <Card title="Wallet Classification" icon="tag" href="/cortex/wallet-classification">
    Behavioral tags for every wallet
  </Card>

  <Card title="Reputation Scores" icon="star" href="/cortex/reputation-scores">
    Composite trust scores (0–100)
  </Card>

  <Card title="Token Risk Scores" icon="shield" href="/cortex/token-risk-scores">
    Per-token composite risk assessment
  </Card>
</CardGroup>

## How It Works (Plain Language)

Cortex reads from the same event stream that powers Retina Terminal. Every swap, liquidity event, and position close flows into the same ingestion pipeline — so the data you see in the terminal and the data powering Cortex scores are always in sync. There is no separate data source and no lag between what the terminal shows and what the scoring engine knows.

Classification happens first. Cortex applies a rule-based behavioral tagging system to each wallet — deterministic, explainable, and fast. Every classification can be traced back to specific on-chain events rather than opaque model outputs. If a wallet is tagged as an Early Mover, you can point to the exact entry timestamps that drove that label.

Scoring builds on top of classification. The composite reputation score combines win rate, entry timing, consistency across multiple tokens, and risk/drawdown profile into a single 0–100 number. These dimensions are weighted and combined using fixed rules — not a trained model. As new events arrive, the score recalculates automatically. Early scores for a new wallet are provisional and carry a Low confidence indicator; they deepen in reliability as more qualifying events accumulate.

## The Value Over Time

Cortex scores compound in value as the indexer accumulates history. A wallet scored on its first ten trades carries real information, but it is still provisional — the sample size is small and the pattern may not yet be stable. After 30 or more days of continuous data, scores become highly reliable predictors of future behavior. Wallets with long, consistent histories are difficult to fake and even harder to replicate quickly.

This accumulated history is the hardest thing for competitors to replicate. Raw scoring logic can be copied; months of indexed on-chain history cannot. The longer RetinaOS runs, the more differentiated its Cortex signals become relative to any newer entrant building the same type of product.

## Where Cortex Scores Appear

* **Token pages**: a badge showing the number of high-reputation top holders and their net activity (accumulating or exiting)
* **Wallet pages**: full score breakdown, classification tag, and a confidence indicator
* **Discovery feed**: filter by minimum reputation holders in the top 10
* **Alerts**: trigger on a wallet reputation threshold crossing
* **API**: `GET /scores/wallet/:address` and `GET /scores/token/:address`

<Note>
  Cortex is included in your Retina Terminal subscription — no separate plan needed.
</Note>