---
updatedAt: 2026-10-05T13:47:55.000Z
agentTools:
  projectIndex: https://docs.ccview.io/llms.txt
---

# Dashboard of SV Locking

Aggregated locking dashboard of super validators (SV). Returns per-organization locking data (earned and locked amounts, tier, weight, grace period) together with network-wide totals: lifetime earned, lifetime SV rewards, effective weight (organization weight multiplied by its tier coefficient), current mining round and the number of minutes until the next tier evaluation (evaluation runs every 10 minutes; the value is negative if it is overdue).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "CantonView Public API",
    "description": "Public API for accessing Canton Network explorer data through CCView",
    "contact": {
      "name": "API Maintainer",
      "email": "cantonview@pixelplex.io"
    },
    "license": {
      "name": ""
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://ccview.io",
      "description": "Production HTTPS server"
    }
  ],
  "paths": {
    "/api/super-validators/locking": {
      "get": {
        "tags": [
          "Validators & Super Validators"
        ],
        "summary": "Dashboard of SV Locking",
        "description": "Aggregated locking dashboard of super validators (SV). Returns per-organization locking data (earned and locked amounts, tier, weight, grace period) together with network-wide totals: lifetime earned, lifetime SV rewards, effective weight (organization weight multiplied by its tier coefficient), current mining round and the number of minutes until the next tier evaluation (evaluation runs every 10 minutes; the value is negative if it is overdue).",
        "operationId": "locking_v1",
        "responses": {
          "200": {
            "description": "Locking dashboard of super validators.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SvLockingGeneral"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "message",
                    "timestamp"
                  ],
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Detailed message description.",
                      "example": "message error"
                    },
                    "status": {
                      "type": "integer",
                      "format": "int32",
                      "description": "HTTP status code.",
                      "maximum": 599,
                      "minimum": 400
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of error occurrence."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "OrganizationGeneral": {
        "type": "object",
        "required": [
          "organization_name",
          "slug",
          "total_earned",
          "total_locked",
          "tier",
          "weight",
          "weight_formatted",
          "current_round",
          "last_evaluated_at",
          "provide_locking_wallets"
        ],
        "properties": {
          "current_round": {
            "type": "integer",
            "format": "integer",
            "example": "87467",
            "minimum": 0
          },
          "grace_period_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "last_evaluated_at": {
            "type": "string",
            "format": "date-time"
          },
          "organization_name": {
            "type": "string"
          },
          "provide_locking_wallets": {
            "type": "boolean"
          },
          "rounds_before_tier_change": {
            "type": [
              "integer",
              "null"
            ],
            "format": "integer",
            "example": "3",
            "minimum": 0
          },
          "slug": {
            "type": "string"
          },
          "tier": {
            "type": "string",
            "example": "tier_1"
          },
          "total_earned": {
            "type": "string",
            "format": "decimal",
            "example": "1548347.03934",
            "minimum": 0
          },
          "total_locked": {
            "type": "string",
            "format": "decimal",
            "example": "1548347.03934",
            "minimum": 0
          },
          "weight": {
            "type": "string",
            "example": "10000"
          },
          "weight_formatted": {
            "type": "string",
            "format": "string",
            "example": "1_0000"
          }
        }
      },
      "SvLockingGeneral": {
        "type": "object",
        "required": [
          "lifetime_earned",
          "lifetime_sv_rewards",
          "effective_weight",
          "current_round",
          "next_evaluating_mins",
          "organizations"
        ],
        "properties": {
          "current_round": {
            "type": "integer",
            "format": "integer",
            "example": "76346",
            "minimum": 0
          },
          "effective_weight": {
            "type": "string",
            "format": "decimal",
            "example": "1548347.03934",
            "minimum": 0
          },
          "lifetime_earned": {
            "type": "string",
            "format": "decimal",
            "example": "1548347.03934",
            "minimum": 0
          },
          "lifetime_sv_rewards": {
            "type": "string",
            "format": "decimal",
            "example": "1548347.03934",
            "minimum": 0
          },
          "next_evaluating_mins": {
            "type": "integer",
            "format": "int64",
            "example": "7"
          },
          "organizations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrganizationGeneral"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "Validators & Super Validators",
      "description": "Validators and Super Validators data"
    }
  ],
  "externalDocs": {
    "url": "https://swagger.io/resources/open-api/",
    "description": "OpenAPI Documentation Reference"
  }
}
```