API Documentation

Our API provides endpoints to query validator and network information. All responses are JSON.

Required Versions

Returns the software versions that must be run for upcoming epochs in order to receive stake from the Solana Foundation Delegation Program. The endpoint returns at least 4 future epochs. If no versions are explicitly set for future epochs, they inherit from the most recent defined version. When versions are set for specific future epochs, all gaps are filled with inherited versions from the previous epoch.

GET https://api.solana.org/api/community/v1/sfdp_required_versions

Query Parameters

ParameterTypeDescription
clusterstringRequired. Either 'mainnet-beta' or 'testnet'

Example Request

curl --request GET "https://api.solana.org/api/community/v1/sfdp_required_versions?cluster=mainnet-beta"

Example Response

{
  "data": [
    {
      "cluster": "mainnet-beta",
      "epoch": 857,
      "agave_min_version": "2.0.0",
      "agave_max_version": null,
      "firedancer_min_version": "0.1.0",
      "firedancer_max_version": null,
      "inherited_from_prev_epoch": true
    },
    {
      "cluster": "mainnet-beta",
      "epoch": 858,
      "agave_min_version": "2.0.0",
      "agave_max_version": null,
      "firedancer_min_version": "0.1.0",
      "firedancer_max_version": null,
      "inherited_from_prev_epoch": true
    },
    {
      "cluster": "mainnet-beta",
      "epoch": 859,
      "agave_min_version": "2.0.0",
      "agave_max_version": null,
      "firedancer_min_version": "0.1.0",
      "firedancer_max_version": null,
      "inherited_from_prev_epoch": true
    },
    {
      "cluster": "mainnet-beta",
      "epoch": 860,
      "agave_min_version": "2.1.0",
      "agave_max_version": "2.2.0",
      "firedancer_min_version": "0.2.0",
      "firedancer_max_version": "0.3.0",
      "inherited_from_prev_epoch": false
    }
  ]
}

SFDP Participants

Returns a list of Solana Foundation Delegation Program participants and their current program statuses.

GET https://api.solana.org/api/community/v1/sfdp_participants

Example Request

curl --request GET https://api.solana.org/api/community/v1/sfdp_participants

Example Response

[
  {
    "mainnetBetaPubkey": "JEz865PrGtMHsKope27BETXtBDSNeFo4hVtbfsiF64f",
    "testnetPubkey": "BYWeoPrtLAhZdP2FoScmGHWmZVqBKhgwGy4kHyKyR9DF",
    "state": "TestnetOnboarded",
    "sfdp2OnboardingEpoch": null
  },
  {
    "mainnetBetaPubkey": "Gb2M4Ee5ciut3Cc3toG6UrXJohPPiLcT3RkUaDU7dHp2",
    "testnetPubkey": "8az9GBsu44bnEr3aFmqE7AYhP59xG4PoyfkXBhKFmSEv",
    "state": "Approved",
    "sfdp2OnboardingEpoch": 577
  },
  {
    "mainnetBetaPubkey": "AWfsAgeXiX6qi2ZS6ctYQ8pRc3q7bh4HaYmisoqLB45F",
    "testnetPubkey": "13mLjjALbXAHCYPTx1zAXJap1nKXigJQNGQn5cQbrRGc",
    "state": "Rejected",
    "sfdp2OnboardingEpoch": 577
  }
]