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

address · string · required

The on-chain EVM wallet address.

Example Response

{
  "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

address · string · required

The on-chain contract address of the token.

Example Response

{
  "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"
}

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