Skip to main content

Network Information

Query information about the SphereNet network, including validators, slots, and performance metrics.

Get Network Status​

Get current network status including slot information and performance metrics.

GET v1/spherenet/network/status
curl -G https://api.sphere.net/v1/spherenet/network/status \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'accept: application/json'

Response​

{ 
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "cluster": "spherenet",
    "currentSlot": 239847123,
    "absoluteSlot": 239847123,
    "blockHeight": 239847123,
    "currentBlock": {
      "blockhash": "HASH111111111111111111111111111111111111111",
      "previousBlockhash": "HASH222222222222222222222222222222222222222",
      "parentSlot": 239847122,
      "blockTime": 1674259154
    },
    "commitment": "finalized",
    "performance": {
      "numTransactions": 123456789,
      "numSlots": 239847123,
      "samplePeriodSecs": 3600,
      "numNonVoteTransactions": 98765432,
      "transactionsPerSecond": 4389,
      "slotSkipRate": 0.0012
    },
    "updatedAt": "2024-01-20T19:39:14.316Z"
  },
  "ts": "2024-08-22T16:15:42.707Z",
  "request": "request_cdde26b2c0534183a1aaba6baebaec1f"
}

List Validators​

Get information about current network validators. Unlike Solana's permissionless network, SphereNet employs a permissioned validator set that ensures controlled onboarding and built-in compliance capabilities.

GET v1/spherenet/network/validators
curl -G https://api.sphere.net/v1/spherenet/network/validators \
     -H 'Authorization: Bearer <API_KEY>' \
     -H 'accept: application/json'

Response​

{ 
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "validators": [
      {
        "identity": "VAL1111111111111111111111111111111111111111",
        "voteAccount": "VOTE111111111111111111111111111111111111111",
        "activatedStake": 100000000,
        "lastVote": 239847120,
        "rootSlot": 239847000,
        "credits": 123456789,
        "commission": 10,
        "version": "1.16.15",
        "delinquent": false,
        "participantType": "financial_institution",
        "jurisdiction": "USA",
        "complianceFlags": ["msa_verified", "kyc_aml_compliant"]
      }
    ],
    "totalActiveStake": 1000000000,
    "totalCurrentStake": 1000000000,
    "totalDelinquentStake": 0,
    "updatedAt": "2024-01-20T19:39:14.316Z"
  },
  "ts": "2024-08-22T16:15:42.707Z",
  "request": "request_cdde26b2c0534183a1aaba6baebaec1f"
}