> ## 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.

# Scores API: Cortex Token Risk and Wallet Reputation

> GET /scores/wallet/:address for Cortex reputation scores and GET /scores/token/:address for token risk scores — with full dimension breakdowns.

The Scores API exposes Cortex's reputation and risk scoring data as structured JSON. Use it to filter on-chain entities in your own tools, build reputation-gated workflows, or display trust signals in your UI.

## GET /scores/wallet/:address

```
GET https://api.retinaos.xyz/v1/scores/wallet/{address}
```

### Path Parameter

<ParamField path="address" type="string" required>
  The on-chain EVM wallet address.
</ParamField>

### Example Response

```json theme={null}
{
  "address": "0xdef456...",
  "reputation_score": 83,
  "confidence": "high",
  "classification": "Early Mover",
  "dimensions": {
    "win_rate": 0.74,
    "entry_timing_score": 88,
    "consistency_score": 79,
    "risk_drawdown_score": 85
  },
  "trade_count": 214,
  "updated_at": "2025-01-15T08:00:00Z"
}
```

## GET /scores/token/:address

```
GET https://api.retinaos.xyz/v1/scores/token/{address}
```

### Path Parameter

<ParamField path="address" type="string" required>
  The on-chain contract address of the token.
</ParamField>

### Example Response

```json theme={null}
{
  "address": "0xabc123...",
  "risk_score": 28,
  "risk_level": "low",
  "flags": [],
  "dimensions": {
    "holder_concentration_score": 22,
    "liquidity_stability_score": 15,
    "wash_trade_score": 31,
    "smart_money_flow_score": 18
  },
  "top_holder_summary": {
    "early_mover_count": 3,
    "early_mover_net_activity": "accumulating",
    "avg_reputation_top10": 71
  },
  "updated_at": "2025-01-15T08:05:00Z"
}
```

<Note>
  Score fields are 0–100 within each dimension. The composite `risk_score` and `reputation_score` are weighted composites — not averages.
</Note>