---
updatedAt: 2026-05-07T01:57:09.000Z
agentTools:
  projectIndex: https://docs.mavan.bitminetech.io/llms.txt
---

# Get Wallets Dashboard APR Comparison

Returns APR comparison data for MAVAN, External, and CESR (network average) over time as part of the wallets dashboard. Supports 1Y, 1M, and 1W time ranges.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/ethereum/wallets/dashboard/apr-comparison": {
      "get": {
        "description": "Returns APR comparison data for MAVAN, External, and CESR (network average) over time as part of the wallets dashboard. Supports 1Y, 1M, and 1W time ranges.",
        "operationId": "getWalletsDashboardAprComparison",
        "parameters": [
          {
            "name": "timeRange",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "api-key",
            "in": "header",
            "description": "mavan api key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ApiResponseBase"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/AprComparisonResponse"
                        }
                      }
                    }
                  ],
                  "required": [
                    "data"
                  ]
                }
              }
            }
          }
        },
        "summary": "Get Wallets Dashboard APR Comparison",
        "tags": [
          "Ethereum"
        ]
      }
    }
  },
  "info": {
    "title": "MAVAN Staking API",
    "description": "The MAVAN Staking API Docs",
    "version": "1.0.181-main-mainnet",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://gw-1.api.standardvalidator.com"
    }
  ],
  "components": {
    "schemas": {
      "ApiResponseBase": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          }
        }
      },
      "ValidatorApr": {
        "type": "object",
        "properties": {
          "validatorIndex": {
            "type": "number",
            "description": "Validator index",
            "example": 12345
          },
          "apr": {
            "type": "number",
            "description": "Total APR percentage for this validator (consensus + execution)",
            "example": 2.5
          },
          "consensusApr": {
            "type": "number",
            "description": "Consensus layer APR percentage (attestations, sync committees)",
            "example": 1.8
          },
          "executionApr": {
            "type": "number",
            "description": "Execution layer APR percentage (block proposals, MEV)",
            "example": 0.7
          }
        },
        "required": [
          "validatorIndex",
          "apr",
          "consensusApr",
          "executionApr"
        ]
      },
      "ValidatorGroupApr": {
        "type": "object",
        "properties": {
          "apr": {
            "type": "number",
            "description": "Overall APR percentage for the validator group",
            "example": 2.5
          },
          "validators": {
            "description": "Individual validator APRs for this day",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidatorApr"
            }
          }
        },
        "required": [
          "apr",
          "validators"
        ]
      },
      "AprDataPoint": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "number",
            "description": "Timestamp for this data point (Unix timestamp in seconds)",
            "example": 1694736000
          },
          "mavan": {
            "description": "APR data for MAVAN validators",
            "allOf": [
              {
                "$ref": "#/components/schemas/ValidatorGroupApr"
              }
            ]
          },
          "external": {
            "description": "APR data for External validators",
            "allOf": [
              {
                "$ref": "#/components/schemas/ValidatorGroupApr"
              }
            ]
          },
          "cesr": {
            "type": "number",
            "description": "CESR APR percentage (network benchmark)",
            "example": 2.2
          }
        },
        "required": [
          "timestamp",
          "mavan",
          "external",
          "cesr"
        ]
      },
      "AprComparisonResponse": {
        "type": "object",
        "properties": {
          "dataPoints": {
            "description": "Array of APR data points over time. Each point represents a complete day of data.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AprDataPoint"
            }
          },
          "timeRange": {
            "type": "string",
            "description": "Time range used for the data",
            "example": "1Y",
            "enum": [
              "1Y",
              "1M",
              "1W"
            ]
          },
          "periodStart": {
            "type": "number",
            "description": "Start of the data period (Unix timestamp in seconds, midnight UTC)",
            "example": 1694736000
          },
          "periodEnd": {
            "type": "number",
            "description": "End of the data period (Unix timestamp in seconds, midnight UTC of last complete day)",
            "example": 1695340800
          },
          "excludesToday": {
            "type": "boolean",
            "description": "Whether the current (today) day is excluded from the data. Always true since today has incomplete income data.",
            "example": true
          }
        },
        "required": [
          "dataPoints",
          "timeRange",
          "periodStart",
          "periodEnd",
          "excludesToday"
        ]
      }
    }
  }
}
```