Skip to main content

Network Information

warning

Heads up: API coming soon.

This API is not currently accessible. The documentation below reflects the intended design and is meant for early familiarization, not active integration.

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"
}