Beacon HTTP API

The https://data.spiceai.io/eth/beacon API is compatible with the read-only GET requests from the Beacon Node API specification.

Authentication

All requests should specify the Spice API Key by adding a header with X-API-KEY or appending ?api_key=[apikey] to the URL suffix.

Header API Key Example

curl https://data.spiceai.io/eth/beacon/eth/v1/beacon/genesis \
  --header 'X-API-Key: [api-key]'

Query API Key Example

curl https://data.spiceai.io/eth/beacon/eth/v1/beacon/genesis?api_key=[api_key]

Beacon APIs

Retrieve details of the chain's genesis.

Retrieve details of the chain's genesis which can be used to identify chain.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/genesis

Response

200404500

Request successful

Body

application/json

dataobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/genesis', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "genesis_time": {},
    "genesis_validators_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2",
    "genesis_fork_version": "0x00000000"
  }
}

Get state SSZ HashTreeRoot

Calculates HashTreeRoot for state with given 'stateId'. If stateId is root, same value will be returned.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/root

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/root', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": {
    "root": {}
  }
}

Get Fork object for requested state

Returns Fork object for state with given 'stateId'.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/fork

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataobject

The Fork object from the CL spec.

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/fork', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": {
    "previous_version": "0x00000000",
    "current_version": "0x00000000",
    "epoch": "1"
  }
}

Get state finality checkpoints

Returns finality checkpoints for state with given 'stateId'. In case finality is not yet achieved, checkpoint should return epoch 0 and ZERO_HASH as root.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/finality_checkpoints

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/finality_checkpoints', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": {
    "previous_justified": {
      "epoch": "1",
      "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
    },
    "current_justified": {
      "epoch": "1",
      "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
    },
    "finalized": {
      "epoch": "1",
      "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
    }
  }
}

Get validators from state

Returns filterable list of validators with their balance, status and index.

Information will be returned for all indices or public key that match known validators. If an index or public key does not match any known validator, no information will be returned but this will not cause an error. There are no guarantees for the returned data in terms of ordering; both the index and public key are returned for each validator, and can be used to confirm for which inputs a response has been returned.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/validators

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Query parameters

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/validators', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": [
    {
      "index": {},
      "balance": {},
      "status": "active_ongoing",
      "validator": {
        "pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a",
        "withdrawal_credentials": {},
        "effective_balance": {},
        "slashed": false,
        "activation_eligibility_epoch": {},
        "activation_epoch": {},
        "exit_epoch": {},
        "withdrawable_epoch": {}
      }
    }
  ]
}

Get validator from state by id

Returns validator specified by state and id or public key along with status and balance.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/validators/{validator_id}

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

validator_id*string

Either hex encoded public key (any bytes48 with 0x prefix) or validator index

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/validators/{validator_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": {
    "index": {},
    "balance": {},
    "status": "active_ongoing",
    "validator": {
      "pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a",
      "withdrawal_credentials": {},
      "effective_balance": {},
      "slashed": false,
      "activation_eligibility_epoch": {},
      "activation_epoch": {},
      "exit_epoch": {},
      "withdrawable_epoch": {}
    }
  }
}

Get validator balances from state

Returns filterable list of validators balances.

Balances will be returned for all indices or public key that match known validators. If an index or public key does not match any known validator, no balance will be returned but this will not cause an error. There are no guarantees for the returned data in terms of ordering; the index and is returned for each balance, and can be used to confirm for which inputs a response has been returned.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/validator_balances

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Query parameters

Response

200400500

Success

Body

application/json

execution_optimisticall of

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/validator_balances', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": [
    {
      "index": {},
      "balance": {}
    }
  ]
}

Get all committees for a state.

Retrieves the committees for the given state.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/committees

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Query parameters

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/committees', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": [
    {
      "index": {},
      "slot": "1",
      "validators": [
        "1"
      ]
    }
  ]
}

Get sync committees for a state.

Retrieves the sync committees for the given state.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/sync_committees

Path parameters

state_id*string

State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.

Query parameters

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/states/{state_id}/sync_committees', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": {
    "validators": {},
    "validator_aggregates": [
      {}
    ]
  }
}

Get block headers

Retrieves block headers matching given query. By default it will fetch current head slot blocks.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/headers

Query parameters

Response

200400500

Success

Body

application/json

execution_optimisticall of

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/headers', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": [
    {
      "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2",
      "canonical": false,
      "header": {
        "message": {
          "slot": {},
          "proposer_index": {},
          "parent_root": {},
          "state_root": {},
          "body_root": {}
        },
        "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
      }
    }
  ]
}

Get block header

Retrieves block header for given block id.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/headers/{block_id}

Path parameters

block_id*string

Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/headers/{block_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": {
    "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2",
    "canonical": false,
    "header": {
      "message": {
        "slot": {},
        "proposer_index": {},
        "parent_root": {},
        "state_root": {},
        "body_root": {}
      },
      "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
    }
  }
}

Get block

Retrieves block details for given block id. Depending on Accept header it can be returned either as json or as bytes serialized by SSZ

GEThttps://data.spiceai.io/eth/beacon/eth/v2/beacon/blocks/{block_id}

Path parameters

block_id*string

Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.

Response

200400404500

Successful response

Headers

Body

application/jsonapplication/octet-stream

versionenum

phase0altairbellatrix

execution_optimisticall of

dataone of

objectobjectobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v2/beacon/blocks/{block_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "version": "phase0",
  "execution_optimistic": {},
  "data": {
    "message": {
      "slot": {},
      "proposer_index": {},
      "parent_root": {},
      "state_root": {},
      "body": {
        "randao_reveal": {},
        "eth1_data": {
          "deposit_root": {},
          "deposit_count": {},
          "block_hash": {}
        },
        "graffiti": "text",
        "proposer_slashings": [
          {
            "signed_header_1": {
              "message": {
                "slot": {},
                "proposer_index": {},
                "parent_root": {},
                "state_root": {},
                "body_root": {}
              },
              "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
            },
            "signed_header_2": {
              "message": {
                "slot": {},
                "proposer_index": {},
                "parent_root": {},
                "state_root": {},
                "body_root": {}
              },
              "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
            }
          }
        ],
        "attester_slashings": [
          {
            "attestation_1": {
              "attesting_indices": [
                "1"
              ],
              "signature": {},
              "data": {
                "slot": "1",
                "index": "1",
                "beacon_block_root": {},
                "source": {
                  "epoch": "1",
                  "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
                },
                "target": {
                  "epoch": "1",
                  "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
                }
              }
            },
            "attestation_2": {
              "attesting_indices": [
                "1"
              ],
              "signature": {},
              "data": {
                "slot": "1",
                "index": "1",
                "beacon_block_root": {},
                "source": {
                  "epoch": "1",
                  "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
                },
                "target": {
                  "epoch": "1",
                  "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
                }
              }
            }
          }
        ],
        "attestations": [
          {
            "aggregation_bits": "0x01",
            "signature": {},
            "data": {
              "slot": "1",
              "index": "1",
              "beacon_block_root": {},
              "source": {
                "epoch": "1",
                "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
              },
              "target": {
                "epoch": "1",
                "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
              }
            }
          }
        ],
        "deposits": [
          {
            "proof": [
              {}
            ],
            "data": {
              "pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a",
              "withdrawal_credentials": {},
              "amount": {},
              "signature": {}
            }
          }
        ],
        "voluntary_exits": [
          {
            "message": {
              "epoch": {},
              "validator_index": {}
            },
            "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
          }
        ]
      }
    },
    "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
  }
}

Get block root

Retrieves hashTreeRoot of BeaconBlock/BeaconBlockHeader

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/blocks/{block_id}/root

Path parameters

block_id*string

Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataobject

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/blocks/{block_id}/root', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": {
    "root": {}
  }
}

Get block attestations

Retrieves attestation included in requested block.

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/blocks/{block_id}/attestations

Path parameters

block_id*string

Block identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.

Response

200400404500

Success

Body

application/json

execution_optimisticall of

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/blocks/{block_id}/attestations', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "execution_optimistic": {},
  "data": [
    {
      "aggregation_bits": "0x01",
      "signature": {},
      "data": {
        "slot": "1",
        "index": "1",
        "beacon_block_root": {},
        "source": {
          "epoch": "1",
          "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
        },
        "target": {
          "epoch": "1",
          "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
        }
      }
    }
  ]
}

Get Attestations from operations pool

Retrieves attestations known by the node but not necessarily incorporated into any block

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/attestations

Query parameters

Response

200400500

Successful response

Body

application/json

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/attestations', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "aggregation_bits": "0x01",
      "signature": {},
      "data": {
        "slot": "1",
        "index": "1",
        "beacon_block_root": {},
        "source": {
          "epoch": "1",
          "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
        },
        "target": {
          "epoch": "1",
          "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
        }
      }
    }
  ]
}

Get AttesterSlashings from operations pool

Retrieves attester slashings known by the node but not necessarily incorporated into any block

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/attester_slashings

Response

200500

Successful response

Body

application/json

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/attester_slashings', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "attestation_1": {
        "attesting_indices": [
          "1"
        ],
        "signature": {},
        "data": {
          "slot": "1",
          "index": "1",
          "beacon_block_root": {},
          "source": {
            "epoch": "1",
            "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
          },
          "target": {
            "epoch": "1",
            "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
          }
        }
      },
      "attestation_2": {
        "attesting_indices": [
          "1"
        ],
        "signature": {},
        "data": {
          "slot": "1",
          "index": "1",
          "beacon_block_root": {},
          "source": {
            "epoch": "1",
            "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
          },
          "target": {
            "epoch": "1",
            "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
          }
        }
      }
    }
  ]
}

Get ProposerSlashings from operations pool

Retrieves proposer slashings known by the node but not necessarily incorporated into any block

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/proposer_slashings

Response

200500

Successful response

Body

application/json

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/proposer_slashings', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "signed_header_1": {
        "message": {
          "slot": {},
          "proposer_index": {},
          "parent_root": {},
          "state_root": {},
          "body_root": {}
        },
        "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
      },
      "signed_header_2": {
        "message": {
          "slot": {},
          "proposer_index": {},
          "parent_root": {},
          "state_root": {},
          "body_root": {}
        },
        "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
      }
    }
  ]
}

Get SignedVoluntaryExit from operations pool

Retrieves voluntary exits known by the node but not necessarily incorporated into any block

GEThttps://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/voluntary_exits

Response

200500

Successful response

Body

application/json

dataarray of object

Request

JavaScriptCurl

const response = await fetch('https://data.spiceai.io/eth/beacon/eth/v1/beacon/pool/voluntary_exits', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "message": {
        "epoch": {},
        "validator_index": {}
      },
      "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
    }
  ]
}