Get Validator Status
Retrieve the current status and performance metrics for Validator.com.
Endpoint
Parameters
No parameters required.
Response
Current validator status: active, inactive, or maintenance
Validator uptime percentage over the last 30 days
Commission rate percentage (5%)
Total SOL currently staked with the validator
Validator vote account address
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"
}
Endpoint
Parameters
Time period for metrics: 1d, 7d, 30d, 90d, 1y
Data granularity: hourly, daily, weekly
Response
Array of uptime percentages over the time period
Array of block production rates
Array of vote participation percentages
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
Parameters
Maximum number of alerts to return (1-100)
Filter by alert severity: critical, warning, info
Return alerts since this timestamp (ISO 8601 format)
Response
Alert message description
When the alert was triggered
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"
}
