Validator Status

Get Validator Status

Retrieve the current status and performance metrics for Validator.com.

Endpoint

GET /v1/status

Parameters

No parameters required.

Response

string

Current validator status: active, inactive, or maintenance

number

Validator uptime percentage over the last 30 days

number

Commission rate percentage (5%)

number

Total SOL currently staked with the validator

string

Validator vote account address

string

Validator identity key

Example Request

curl https://api.validator.com/v1/status

Example Response

{
  "status": "success",
  "data": {
    "status": "active",
    "uptime": 99.97,
    "commission": 5.0,
    "active_stake": 2500000.5,
    "vote_account": "VoteAccount1234567890abcdef",
    "identity": "ValidatorCom1234567890abcdef",
    "last_updated": "2024-01-15T10:30:00Z"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Get Validator Performance

Get detailed performance metrics for a specific time period.

Endpoint

GET /v1/performance

Parameters

string

default:"7d"

Time period for metrics: 1d, 7d, 30d, 90d, 1y

string

default:"hourly"

Data granularity: hourly, daily, weekly

Response

array

Array of uptime percentages over the time period

array

Array of block production rates

array

Array of vote participation percentages

array

Array of reward amounts per period

Example Request

curl "https://api.validator.com/v1/performance?timeframe=30d&granularity=daily"

Example Response

{
  "status": "success",
  "data": {
    "timeframe": "30d",
    "granularity": "daily",
    "uptime": [99.98, 99.97, 99.99, 99.96, 99.98],
    "block_production": [99.8, 99.9, 99.7, 99.8, 99.9],
    "vote_participation": [100, 100, 100, 100, 100],
    "rewards": [125.5, 127.2, 124.8, 126.1, 125.9],
    "periods": [
      "2024-01-10T00:00:00Z",
      "2024-01-11T00:00:00Z",
      "2024-01-12T00:00:00Z",
      "2024-01-13T00:00:00Z",
      "2024-01-14T00:00:00Z"
    ]
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Get Validator Alerts

Retrieve recent alerts and notifications for the validator.

Endpoint

GET /v1/alerts

Parameters

integer

default:"10"

Maximum number of alerts to return (1-100)

string

Filter by alert severity: critical, warning, info

string

Return alerts since this timestamp (ISO 8601 format)

Response

array

Array of alert objects

string

Unique alert identifier

string

Alert severity level

string

Alert message description

string

When the alert was triggered

boolean

Whether the alert has been resolved

Example Request

curl "https://api.validator.com/v1/alerts?limit=5&severity=critical"

Example Response

{
  "status": "success",
  "data": {
    "alerts": [
      {
        "id": "alert_123456",
        "severity": "critical",
        "message": "Validator offline - investigating",
        "timestamp": "2024-01-15T09:15:00Z",
        "resolved": true,
        "resolved_at": "2024-01-15T09:25:00Z"
      },
      {
        "id": "alert_123457",
        "severity": "warning",
        "message": "Uptime below 99% threshold",
        "timestamp": "2024-01-14T14:30:00Z",
        "resolved": true,
        "resolved_at": "2024-01-14T15:00:00Z"
      }
    ]
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Error Responses

Invalid Parameters

{
  "status": "error",
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Invalid timeframe parameter",
    "details": "timeframe must be one of: 1d, 7d, 30d, 90d, 1y"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Rate Limit Exceeded

{
  "status": "error",
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "details": "Too many requests. Please try again later."
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Validator API

Monitoring API

Get Validator Status

Endpoint

Parameters

Response

Example Request

Example Response

Get Validator Performance

Endpoint

Parameters

Response

Example Request

Example Response

Get Validator Alerts

Endpoint

Parameters

Response

Example Request

Example Response

Error Responses

Invalid Parameters

Rate Limit Exceeded

​Get Validator Status

​Endpoint

​Parameters

​Response

​Example Request

​Example Response

​Get Validator Performance

​Endpoint

​Parameters

​Response

​Example Request

​Example Response

​Get Validator Alerts

​Endpoint

​Parameters

​Response

​Example Request

​Example Response

​Error Responses

​Invalid Parameters

​Rate Limit Exceeded

Get Validator Status

Endpoint

Parameters

Response

Example Request

Example Response

Get Validator Performance

Endpoint

Parameters

Response

Example Request

Example Response

Get Validator Alerts

Endpoint

Parameters

Response

Example Request

Example Response

Error Responses

Invalid Parameters

Rate Limit Exceeded