Skip to main content

Reputation API

TODO: Complete Reputation Indexing Endpoints Documentation​

Query operator reputation history and metrics.

Required Sections​

  • Endpoints

    • GET /v1/operators/{operator_address}/reputation
    • GET /v1/operators/{operator_address}/reputation/history
    • POST /v1/operators/batch/reputation
    • Time-series reputation queries

  • Current Reputation Response

    {
      "operator_address": "0x...",
      "reputation_tier": "TRUSTED",
      "reputation_score": 85,
      "metrics": {
        "slashing_events": 0,
        "uptime_percent": 99.7,
        "avs_count": 8,
        "governance_participation": 0.92
      },
      "last_updated": "2024-01-21T14:32:00Z"
    }

  • Historical Queries

    • Query reputation at specific timestamp
    • Daily/weekly/monthly snapshots
    • Reputation trend analysis
    • Historical data availability window

  • Time Series Data

    • Granularity options (daily, weekly, etc.)
    • Aggregation strategy
    • Gap handling (missing data)
    • Extrapolation vs exact data

  • Filtering & Sorting

    • Filter by reputation tier
    • Sort by reputation score
    • Sort by slashing incidents
    • Multi-criteria sorting

  • Batch Operations

    • Query multiple operators' reputation
    • Request size limits
    • Response format

  • Reputation Signals

    • Breaking down reputation by component
    • Historical slashing events (list)
    • Uptime trends
    • Governance participation history

  • Cross-Protocol Integration (if applicable)

    • Ethereum staking reputation
    • Other protocol reputation
    • Normalized comparison scores

  • Examples

    • Query current reputation
    • Plot reputation over time
    • Compare operators' reputation trajectories
    • Export reputation data for analysis

Use Cases​

  • Staker due diligence before delegation
  • AVS whitelist/blacklist management
  • Insurance underwriting
  • Research & analysis
  • Reputation dashboards

Status: NOT STARTED — Requires reputation data model & API design