---
updatedAt: 2026-08-19T14:40:16.000Z
agentTools:
  projectIndex: https://docs.blockberry.one/llms.txt
---

# getValidatorsApy

Get a chart showing the average APY (annual percentage yield) of all validators across the Sui Network. Average APY shows how much an account can earn on average per year by delegating Sui funds. This is a key metric to consider while making an investment decision. Avg APY is a rough estimation. The actual returns from staking may differ.

> 📘 This is the Pro endpoint, currently available for free as part of the API campaign.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Sui mainnet API",
    "description": "This is the new API Module implementation. The SUI Blockchain API is used to retrieve SUI Blockchain data. In order to execute queries you need to get API Key and use it in header 'x-api-key'. However, before that you need to sign up on the explorer or company website. If an account is created on the website <strong>https://staketab.com/</strong> or <strong>https://suiscan.xyz/</strong>, the user will be granted the <strong>ROLE_USER</strong> role. After that you may fetch API KEY.",
    "termsOfService": "terms-of-service",
    "contact": {
      "name": "Staketab tech support",
      "url": "https://staketab.com/",
      "email": "support@staketab.com"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.blockberry.one/sui",
      "description": "Production"
    }
  ],
  "security": [
    {
      "x-api-key": []
    }
  ],
  "paths": {
    "/v1/validators/apy": {
      "get": {
        "tags": [
          "Accounts"
        ],
        "summary": "getValidatorsApy",
        "description": "Get a chart showing the average APY (annual percentage yield) of all validators across the Sui Network. Average APY shows how much an account can earn on average per year by delegating Sui funds. This is a key metric to consider while making an investment decision. Avg APY is a rough estimation. The actual returns from staking may differ.",
        "operationId": "getValidatorsApy",
        "parameters": [
          {
            "name": "pk",
            "in": "query",
            "description": "Queried validator address digest (hash).",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Queried validator address digest (hash).",
              "default": "0x61953ea72709eed72f4441dd944eec49a11b4acabfc8e04015e89c63be81b6ab"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/LineChartWidgetAPIDot"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Dot": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "LineChartWidgetAPIDot": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "format": "double"
          },
          "changeValue": {
            "type": "number",
            "format": "double"
          },
          "changePercent": {
            "type": "number",
            "format": "double"
          },
          "additionalValue": {
            "type": "number",
            "format": "double"
          },
          "maxRate": {
            "type": "number",
            "format": "double"
          },
          "changeRate": {
            "type": "number",
            "format": "double"
          },
          "changePeriod": {
            "type": "string"
          },
          "isHasNoChanges": {
            "type": "boolean"
          },
          "chart": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Dot"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "x-api-key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  }
}
```