Skip to content

Latest commit

 

History

History
68 lines (51 loc) · 1.36 KB

api.md

File metadata and controls

68 lines (51 loc) · 1.36 KB

Blockprint Public API

The blockprint API is publicly accessible at https://api.blockprint.sigp.io.

/blocks_per_client/{start_epoch}/{end_epoch}

Return the number of blocks proposed by each client in the requested epochs. The end_epoch may be omitted to fetch data for a single epoch.

These APIs intentionally group data by epoch to avoid identifying individual validators.

Examples

Get block proposer client affinity for a single epoch.

curl "https://api.blockprint.sigp.io/blocks_per_client/96000
{
  "Uncertain": 0,
  "Lighthouse": 5,
  "Lodestar": 0,
  "Nimbus": 0,
  "Other": 0,
  "Prysm": 23,
  "Teku": 4
}

Get block proposer client affinity for several epochs. The end_epoch is exclusive.

curl "https://api.blockprint.sigp.io/blocks_per_client/96000/97000"
{
  "Uncertain": 0,
  "Lighthouse": 7415,
  "Lodestar": 0,
  "Nimbus": 86,
  "Other": 0,
  "Prysm": 20665,
  "Teku": 3465
}

/sync/status

Return the status of Blockprint's database. This conveys how up-to-date Blockprint's view of the chain is.

curl "https://api.blockprint.sigp.io/sync/status"
{
  "greatest_block_slot": 3112960,
  "synced": true
}

Results can't be relied on for slots greater than greatest_block_slot, or if synced is false.

synced: false indicates the presence of gaps in Blockprint's DB.