Ethereum Data API

Ethereum Data API is a collection of APIs that expose read data from the Ethereum network.

Get latest status of the Ethereum protocol

Get global information about protocol token supplies

GET//eth/v0/status

Response

Body

active_validator_countinteger

Count of total validators minus stopped validators on the consensus layer

active_validators_eth_balancestring

Total consensus ETH balance of all validators on the consensus layer (as reported by the Oracle) in Wei

block_numberinteger

Height of the returned data

collected_rewardsstring

Total collected rewards

contract_eth_balancestring

ETH balance on the contract in Wei

conversion_ratenumber

deposit_countinteger

Number of deposits

exited_validators_eth_balancestring

Total ETH balance of exited validators on the consensus layer (as reported by the Oracle) in Wei

exiting_validators_eth_balancestring

Total ETH balance of exiting validators on the consensus layer (as reported by the Oracle) in Wei

funded_validator_countinteger

Count of funded validators

funded_valitor_countinteger

Previous typo made, keeping for backwards compatibility

pending_validator_countinteger

Count of funded validators and pending activation on the consensus layer (as reported by the Oracle)

pending_validators_eth_balancestring

Total ETH balance of pending validators in GWei

rebalance_deposit_to_redeem_modeboolean

skimmed_validators_eth_balancestring

Total ETH balance of skimmed withdrawals (as reported by the Oracle) in Wei

slashing_containment_modeboolean

stopped_validator_countinteger

Count of stopped LC validators on the consensus layer (as reported by the Oracle)

total_eth_balancestring

Total ETH balance managed by the River protocol in GWei

total_eth_depositedstring

Total ETH deposited

total_supplystring

Total LsETH supply

total_validator_countinteger

Count of all LC validators found on the consensus layer (as reported by the Oracle)

Request

const response = await fetch('//eth/v0/status', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "active_validator_count": 58,
  "active_validators_eth_balance": "128000000000000000000",
  "block_number": 15034284,
  "collected_rewards": "3200000000000000000000",
  "contract_eth_balance": "5000000000000000000",
  "conversion_rate": 0,
  "deposit_count": 2,
  "exited_validators_eth_balance": "128000000000000000000",
  "exiting_validators_eth_balance": "128000000000000000000",
  "funded_validator_count": 102,
  "funded_valitor_count": 102,
  "pending_validator_count": 2,
  "pending_validators_eth_balance": "64000000000000000000",
  "rebalance_deposit_to_redeem_mode": true,
  "skimmed_validators_eth_balance": "128000000000000000000",
  "slashing_containment_mode": false,
  "stopped_validator_count": 42,
  "total_eth_balance": "3200000000000000000000",
  "total_eth_deposited": "3200000000000000000000",
  "total_supply": "3200000000000000000000",
  "total_validator_count": 100
}

Get status of the Ethereum protocol at a given block number

Get global information about protocol token supplies at a given block number

GET//eth/v0/status/{block_number}

Path parameters

block_number*integer

Block height to query

Response

Body

active_validator_countinteger

Count of total validators minus stopped validators on the consensus layer

active_validators_eth_balancestring

Total consensus ETH balance of all validators on the consensus layer (as reported by the Oracle) in Wei

block_numberinteger

Height of the returned data

collected_rewardsstring

Total collected rewards

contract_eth_balancestring

ETH balance on the contract in Wei

conversion_ratenumber

deposit_countinteger

Number of deposits

exited_validators_eth_balancestring

Total ETH balance of exited validators on the consensus layer (as reported by the Oracle) in Wei

exiting_validators_eth_balancestring

Total ETH balance of exiting validators on the consensus layer (as reported by the Oracle) in Wei

funded_validator_countinteger

Count of funded validators

funded_valitor_countinteger

Previous typo made, keeping for backwards compatibility

pending_validator_countinteger

Count of funded validators and pending activation on the consensus layer (as reported by the Oracle)

pending_validators_eth_balancestring

Total ETH balance of pending validators in GWei

rebalance_deposit_to_redeem_modeboolean

skimmed_validators_eth_balancestring

Total ETH balance of skimmed withdrawals (as reported by the Oracle) in Wei

slashing_containment_modeboolean

stopped_validator_countinteger

Count of stopped LC validators on the consensus layer (as reported by the Oracle)

total_eth_balancestring

Total ETH balance managed by the River protocol in GWei

total_eth_depositedstring

Total ETH deposited

total_supplystring

Total LsETH supply

total_validator_countinteger

Count of all LC validators found on the consensus layer (as reported by the Oracle)

Request

const response = await fetch('//eth/v0/status/{block_number}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "active_validator_count": 58,
  "active_validators_eth_balance": "128000000000000000000",
  "block_number": 15034284,
  "collected_rewards": "3200000000000000000000",
  "contract_eth_balance": "5000000000000000000",
  "conversion_rate": 0,
  "deposit_count": 2,
  "exited_validators_eth_balance": "128000000000000000000",
  "exiting_validators_eth_balance": "128000000000000000000",
  "funded_validator_count": 102,
  "funded_valitor_count": 102,
  "pending_validator_count": 2,
  "pending_validators_eth_balance": "64000000000000000000",
  "rebalance_deposit_to_redeem_mode": true,
  "skimmed_validators_eth_balance": "128000000000000000000",
  "slashing_containment_mode": false,
  "stopped_validator_count": 42,
  "total_eth_balance": "3200000000000000000000",
  "total_eth_deposited": "3200000000000000000000",
  "total_supply": "3200000000000000000000",
  "total_validator_count": 100
}

List LsETH balance of several addresses

List LsETH balance of several addresses It is possible to specify for which block and which addresses to get the balances.

GET//eth/v0/balances

Query parameters

Response

Body

addressstring

Owner address

balancestring

LsETH balance

block_numberinteger

Block height of the balance

Request

const response = await fetch('//eth/v0/balances', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "address": "0x123456789985ca04a69c35978c3a3e778d6ef172",
  "balance": "4200000000000000000000",
  "block_number": 15034284
}

Get LsETH balance of a given address

Get LsETH balance of a given address It is possible to specify for which block to get the balance at.

GET//eth/v0/balances/{address}

Path parameters

address*string

Account address to query the balance for

Query parameters

Response

Body

addressstring

Owner address

balancestring

LsETH balance

block_numberinteger

Block height of the balance

Request

const response = await fetch('//eth/v0/balances/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "address": "0x123456789985ca04a69c35978c3a3e778d6ef172",
  "balance": "4200000000000000000000",
  "block_number": 15034284
}

Get LsETH balance history

Get the LsETH balance history for a given address It returns a balance object for every block a balance change occured It is possible to filter the history for a range only blocks

GET//eth/v0/balances/{address}/history

Path parameters

address*string

Address of the balance to query balance for

Query parameters

Response

Body

addressstring

Owner address

balancestring

LsETH balance

block_numberinteger

Block height of the balance

Request

const response = await fetch('//eth/v0/balances/{address}/history', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "address": "0x123456789985ca04a69c35978c3a3e778d6ef172",
    "balance": "4200000000000000000000",
    "block_number": 15034284
  }
]

List the smart contracts

List all the smart contracts addresses used

GET//eth/v0/contracts

Response

Body

allowlisterarray of integer

deployment_blockinteger

el_fee_recipientarray of integer

operators_registryarray of integer

oraclearray of integer

redeem_managerarray of integer

riverarray of integer

withdrawarray of integer

Request

const response = await fetch('//eth/v0/contracts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "allowlister": [],
  "el_fee_recipient": [],
  "operators_registry": [],
  "oracle": [],
  "redeem_manager": [],
  "river": [],
  "withdraw": []
}

PreviousAuthentication API NextOnboarding API

Last updated 21 days ago

{ "active_validator_count": 58, "active_validators_eth_balance": "128000000000000000000", "block_number": 15034284, "collected_rewards": "3200000000000000000000", "contract_eth_balance": "5000000000000000000", "conversion_rate": 0, "deposit_count": 2, "exited_validators_eth_balance": "128000000000000000000", "exiting_validators_eth_balance": "128000000000000000000", "funded_validator_count": 102, "funded_valitor_count": 102, "pending_validator_count": 2, "pending_validators_eth_balance": "64000000000000000000", "rebalance_deposit_to_redeem_mode": true, "skimmed_validators_eth_balance": "128000000000000000000", "slashing_containment_mode": false, "stopped_validator_count": 42, "total_eth_balance": "3200000000000000000000", "total_eth_deposited": "3200000000000000000000", "total_supply": "3200000000000000000000", "total_validator_count": 100 }