{ "openapi": "3.0.0", "info": { "title": "Validator Metrics API", "description": "API for accessing Solana validator performance metrics and block time data. Please credit https://solanacompass.com when using our data with a link back.", "version": "1.0.0" }, "paths": { "/api/epoch-performance": { "get": { "tags": [ "Epoch Performance" ], "summary": "Get epoch performance data", "description": "Retrieve validator performance metrics for specific epochs or validators. At least one filter (epoch or leader) is required.", "operationId": "2a7c575bc9b60d344eaff60016ed0cac", "parameters": [ { "name": "epoch", "in": "query", "description": "Epoch number to filter by", "required": false, "schema": { "type": "integer", "example": 850 } }, { "name": "leader", "in": "query", "description": "Validator identity (leader) to filter by", "required": false, "schema": { "type": "string", "example": "7Np41oeYqPefeNQEHSv1UDhYrehxin3NStELsSKCT4K2" } }, { "name": "limit", "in": "query", "description": "Maximum number of results to return", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "example": 1500 } }, { "name": "offset", "in": "query", "description": "Number of results to skip", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 0 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/EpochPerformance" } }, "meta": { "properties": { "total": { "type": "integer", "example": 1000 }, "limit": { "type": "integer", "example": 1500 }, "offset": { "type": "integer", "example": 0 } }, "type": "object" } }, "type": "object" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string", "example": "At least one filter (epoch or leader) is required" } }, "type": "object" } } } } } } }, "/api/epoch-performance/{epoch}": { "get": { "tags": [ "Epoch Performance" ], "summary": "Get epoch performance data for a specific epoch", "description": "Retrieve all validator performance metrics for a specific epoch", "operationId": "64bad3de38df93f3d89a7da82e09c3ff", "parameters": [ { "name": "epoch", "in": "path", "description": "Epoch number", "required": true, "schema": { "type": "integer", "example": 850 } }, { "name": "limit", "in": "query", "description": "Maximum number of results to return", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "example": 1500 } }, { "name": "offset", "in": "query", "description": "Number of results to skip", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 0 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/EpochPerformance" } }, "meta": { "properties": { "total": { "type": "integer", "example": 1000 }, "limit": { "type": "integer", "example": 1500 }, "offset": { "type": "integer", "example": 0 }, "epoch": { "type": "integer", "example": 850 } }, "type": "object" } }, "type": "object" } } } }, "422": { "description": "Validation Error" } } } }, "/api/epoch-performance/validator/{leader}": { "get": { "tags": [ "Epoch Performance" ], "summary": "Get epoch performance data for a specific validator", "description": "Retrieve performance metrics for a specific validator across epochs", "operationId": "2d10cc11598fe220b41a05152dd2ed50", "parameters": [ { "name": "leader", "in": "path", "description": "Validator identity (leader)", "required": true, "schema": { "type": "string", "example": "7Np41oeYqPefeNQEHSv1UDhYrehxin3NStELsSKCT4K2" } }, { "name": "limit", "in": "query", "description": "Maximum number of results to return", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "example": 1500 } }, { "name": "offset", "in": "query", "description": "Number of results to skip", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 0 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/EpochPerformance" } }, "meta": { "properties": { "total": { "type": "integer", "example": 50 }, "limit": { "type": "integer", "example": 1500 }, "offset": { "type": "integer", "example": 0 }, "leader": { "type": "string", "example": "7Np41oeYqPefeNQEHSv1UDhYrehxin3NStELsSKCT4K2" } }, "type": "object" } }, "type": "object" } } } } } } }, "/api/v1/lsts": { "get": { "tags": [ "Liquid Staking Tokens" ], "summary": "Get liquid staking tokens (LSTs) data", "description": "Retrieve data for Solana liquid staking tokens (stake pools). Returns paginated list of active stake pools with their metadata, APY, and token information.", "operationId": "792cffd2c58e846f7ba75e9db266bb17", "parameters": [ { "name": "limit", "in": "query", "description": "Maximum number of results to return", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "example": 50 } }, { "name": "offset", "in": "query", "description": "Number of results to skip", "required": false, "schema": { "type": "integer", "minimum": 0, "example": 0 } }, { "name": "sort", "in": "query", "description": "Sort field", "required": false, "schema": { "type": "string", "enum": [ "totalLamports", "ratio_apy", "validatorCount", "name" ], "example": "totalLamports" } }, { "name": "order", "in": "query", "description": "Sort order", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "example": "desc" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StakePool" } }, "meta": { "properties": { "total": { "type": "integer", "example": 25 }, "limit": { "type": "integer", "example": 50 }, "offset": { "type": "integer", "example": 0 }, "sort": { "type": "string", "example": "totalLamports" }, "order": { "type": "string", "example": "desc" } }, "type": "object" } }, "type": "object" } } } }, "503": { "description": "Service Unavailable - Data cache miss", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string", "example": "Stake pool data is currently being updated. Please try again in a few minutes." } }, "type": "object" } } } } } } }, "/api/v1/lsts/{address}": { "get": { "tags": [ "Liquid Staking Tokens" ], "summary": "Get specific LST stake pool data", "description": "Retrieve detailed information for a specific liquid staking token by its address", "operationId": "7a3e66a3feb1d406a8b7b1baea187065", "parameters": [ { "name": "address", "in": "path", "description": "Stake pool address", "required": true, "schema": { "type": "string", "example": "3yFwqXBfZY4jBVUafQ1YEXw189y2dN3V5KQq9uzBDy6q" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StakePool" } } } }, "404": { "description": "Stake pool not found", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string", "example": "Stake pool not found" } }, "type": "object" } } } }, "503": { "description": "Service Unavailable - Data cache miss" } } } } }, "components": { "schemas": { "EpochPerformance": { "title": "Epoch Performance", "description": "Validator performance metrics for a specific epoch. NOTE: Most monetary values are in lamports (1 SOL = 1,000,000,000 lamports)", "properties": { "id": { "type": "integer", "example": 12345 }, "epoch": { "description": "Epoch number", "type": "integer", "example": 850 }, "leader": { "description": "Validator identity (null for cluster-wide metrics)", "type": "string", "example": "7Np41oeYqPefeNQEHSv1UDhYrehxin3NStELsSKCT4K2" }, "avg_rewards": { "description": "Average rewards per block (lamports)", "type": "integer", "example": 25551123 }, "median_rewards": { "description": "Median rewards per block (lamports)", "type": "integer", "example": 19624083 }, "num_slots": { "description": "Number of leader slots recorded", "type": "integer", "example": 432 }, "skipped": { "description": "Number of skipped slots", "type": "integer", "example": 12 }, "skipped_percent": { "description": "Percentage of slots skipped", "type": "number", "format": "double", "example": 2.78 }, "txns": { "description": "Average transactions per block", "type": "integer", "example": 1500 }, "vote_txns": { "description": "Average vote transactions per block", "type": "integer", "example": 300 }, "success": { "description": "Average successful transactions per block", "type": "integer", "example": 1450 }, "failed": { "description": "Average failed transactions per block", "type": "integer", "example": 50 }, "cu": { "description": "Average compute units per block", "type": "integer", "example": 48000000 }, "average_block_time": { "description": "Average block production time (milliseconds)", "type": "number", "format": "decimal", "example": 425.67 }, "avg_block_time_samples": { "description": "Average number of samples used for block time calculation", "type": "number", "format": "decimal", "example": 15.2 }, "median_block_time": { "description": "Median block production time (milliseconds)", "type": "number", "format": "decimal", "example": 420.45 }, "min_block_time": { "description": "Minimum block production time (milliseconds)", "type": "number", "format": "decimal", "example": 380.25 }, "max_block_time": { "description": "Maximum block production time (milliseconds)", "type": "number", "format": "decimal", "example": 480.55 }, "min_extra": { "description": "Minimum priority fee in a block (lamports)", "type": "integer", "example": 0 }, "max_extra": { "description": "Maximum priority fee in a block (lamports)", "type": "integer", "example": 1999805001 }, "avg_extra": { "description": "Average priority fee per transaction (lamports)", "type": "integer", "example": 68503 }, "med_extra": { "description": "Median priority fee per transaction (lamports)", "type": "integer", "example": 9366 }, "priority_txns": { "description": "Total transactions with priority fees", "type": "integer", "example": 12763172 }, "priority_fees": { "description": "Total priority fees collected (lamports)", "type": "integer", "example": 874319322794 }, "jito_total": { "description": "Total Jito MEV tips (lamports)", "type": "integer", "example": 1163842666806 }, "jito_transactions": { "description": "Number of Jito transactions", "type": "integer", "example": 4191830 }, "jito_avg_tip": { "description": "Average Jito tip per block (lamports)", "type": "integer", "example": 287833 }, "jito_med_tip": { "description": "Median Jito tip per block (lamports)", "type": "integer", "example": 6635 }, "all_fees": { "description": "Total fees collected (lamports)", "type": "integer", "example": 1101155457794 }, "base_fees": { "description": "Total base fees collected (lamports)", "type": "integer", "example": 300220720000 }, "vote_fees": { "description": "Total vote fees collected (lamports)", "type": "integer", "example": 190724731569 }, "avg_fee_ratio": { "description": "Average fee ratio (total_fee / compute_units)", "type": "number", "format": "double", "example": 7.3444817199555 }, "med_fee_ratio": { "description": "Median fee ratio (total_fee / compute_units)", "type": "number", "format": "double", "example": 0.20232677703001 }, "created_at": { "type": "string", "format": "date-time", "example": "2024-01-15T10:30:00Z" }, "updated_at": { "type": "string", "format": "date-time", "example": "2024-01-15T10:30:00Z" } }, "type": "object" }, "StakePool": { "title": "Stake Pool (LST)", "description": "Liquid Staking Token (LST) stake pool data", "properties": { "id": { "description": "Database ID", "type": "integer", "example": 93 }, "address": { "description": "Stake pool address", "type": "string", "example": "Jito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815Awbb" }, "name": { "description": "Stake pool name", "type": "string", "example": "Jito" }, "network": { "description": "Network (m=mainnet, t=testnet)", "type": "string", "example": "m" }, "command": { "description": "Pool type/command", "type": "string", "example": "spl-stake-pool" }, "poolMint": { "description": "Pool token mint address", "type": "string", "example": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn" }, "totalLamports": { "description": "Total lamports staked in the pool", "type": "integer", "example": 17483710490770248 }, "poolTokenSupply": { "description": "Total pool token supply", "type": "integer", "example": 14362627965756928 }, "lastUpdateEpoch": { "description": "Last epoch when pool was updated", "type": "integer", "example": 818 }, "lastEpochPoolTokenSupply": { "description": "Pool token supply from previous epoch", "type": "integer", "example": 14362524116099598 }, "lastEpochTotalLamports": { "description": "Total lamports from previous epoch", "type": "integer", "example": 17477059384593552 }, "validatorsCount": { "description": "Number of validators in the pool", "type": "integer", "example": 209 }, "maxValidators": { "description": "Maximum number of validators allowed", "type": "integer", "example": 10000 }, "ratio_apy": { "description": "Current APY percentage calculated from the increase in poolTokenSupply/totalLamports ratio using a median of the last ten epochs", "type": "number", "format": "double", "example": 0.07328990698610771 }, "manager": { "description": "Pool manager address", "type": "string", "example": "5eosrve6LktMZgVNszYzebgmmC7BjLK8NoWyRQtcmGTF" }, "staker": { "description": "Pool staker address", "type": "string", "example": "9BAmGVLGxzqct6bkgjWmKSv3BFB6iKYXNBQp8GWG1LDY" }, "stakeDepositAuthority": { "description": "Stake deposit authority", "type": "string", "example": "6hg6RMfjn3QSW6MdjH2Dg3dhF9XsVEE8CQXhjYwkRCiK" }, "poolWithdrawAuthority": { "description": "Pool withdraw authority", "type": "string", "example": "6iQKfEyhr3bZMotVkW6beNZz5CPAkiwvgV2CTje9pVSS" }, "validatorListStorageAccount": { "description": "Validator list storage account", "type": "string", "example": "3R3nGZpQs2aZo5FDQvd2MUQ6R7KhAPainds6uT6uE2mn" }, "reserveStake": { "description": "Reserve stake account", "type": "string", "example": "BgKUXdS29YcHCFrPm5M8oLHiTzZaMDjsebggjoaQ6KFL" }, "managerFeeAccount": { "description": "Manager fee account", "type": "string", "example": "feeeFLLsam6xZJFc6UQFrHqkvVt4jfmVvi2BRLkUZ4i" }, "tokenProgramId": { "description": "Token program ID", "type": "string", "example": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" }, "stakeWithdrawBumpSeed": { "description": "Stake withdraw bump seed", "type": "integer", "example": 253 }, "stakeReferralFee": { "description": "Stake referral fee", "type": "integer", "example": 0 }, "solDepositAuthority": { "description": "SOL deposit authority", "type": "string", "example": null, "nullable": true }, "solWithdrawAuthority": { "description": "SOL withdraw authority", "type": "string", "example": null, "nullable": true }, "solReferralFee": { "description": "SOL referral fee", "type": "integer", "example": 0 }, "preferredDepositValidatorVoteAddress": { "description": "Preferred deposit validator vote address", "type": "string", "example": null, "nullable": true }, "preferredWithdrawValidatorVoteAddress": { "description": "Preferred withdraw validator vote address", "type": "string", "example": null, "nullable": true }, "lockup": { "description": "Lockup configuration JSON", "type": "string", "example": "{\"epoch\": 0, \"custodian\": \"11111111111111111111111111111111\", \"unixTimestamp\": 0}" }, "keybase_id": { "description": "Keybase ID", "type": "string", "example": null, "nullable": true }, "logo": { "description": "Logo URL", "type": "string", "example": null, "nullable": true }, "logo_cached": { "description": "Cached logo path", "type": "string", "example": "images/pools/Jito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815Awbb.png" }, "description": { "description": "Pool description", "type": "string", "example": null, "nullable": true }, "website": { "description": "Pool website", "type": "string", "example": "https://jito.network/staking/?ref=compass" }, "strategy": { "description": "Pool strategy description", "type": "string", "example": null, "nullable": true }, "details": { "description": "Additional pool details", "type": "string", "example": null, "nullable": true }, "epoch_fee": { "description": "Epoch fee structure", "properties": { "fee_type": { "type": "string", "example": "epochFee" }, "numerator": { "type": "integer", "example": 4 }, "denominator": { "type": "integer", "example": 100 }, "lastUpdateEpoch": { "type": "integer", "example": 818 } }, "type": "object" }, "sol_deposit_fee": { "description": "SOL deposit fee structure", "properties": { "fee_type": { "type": "string", "example": "solDepositFee" }, "numerator": { "type": "integer", "example": 0 }, "denominator": { "type": "integer", "example": 0 }, "lastUpdateEpoch": { "type": "integer", "example": 818 } }, "type": "object" }, "sol_withdrawal_fee": { "description": "SOL withdrawal fee structure", "properties": { "fee_type": { "type": "string", "example": "solWithdrawalFee" }, "numerator": { "type": "integer", "example": 1 }, "denominator": { "type": "integer", "example": 1000 }, "lastUpdateEpoch": { "type": "integer", "example": 818 } }, "type": "object" }, "token": { "description": "Token metadata", "properties": { "name": { "type": "string", "example": "Jito Staked SOL" }, "symbol": { "type": "string", "example": "JitoSOL" }, "decimals": { "type": "integer", "example": 9 }, "logoURI": { "type": "string", "example": "https://storage.googleapis.com/token-metadata/JitoSOL-256.png" }, "metadata": { "properties": { "name": { "type": "string", "example": "Jito Staked SOL" }, "description": { "type": "string", "example": "MEV-Powered Liquid Staking Token" }, "symbol": { "type": "string", "example": "JitoSOL" }, "token_standard": { "type": "string", "example": "Fungible" } }, "type": "object" } }, "type": "object" }, "created_at": { "type": "string", "format": "date-time", "example": "2022-10-30T00:30:08.000000Z" }, "updated_at": { "type": "string", "format": "date-time", "example": "2025-07-15T08:07:25.000000Z" } }, "type": "object" } } }, "tags": [ { "name": "Epoch Performance", "description": "Epoch Performance" }, { "name": "Liquid Staking Tokens", "description": "Liquid Staking Tokens" } ] }