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

GEThttps://api.alluvial.finance/eth/v0/status
Response

OK

Body
active_validator_countinteger

Count of total validators minus stopped validators on the consensus layer

Example: 58
active_validators_eth_balancestring

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

Example: "128000000000000000000"
block_numberinteger

Height of the returned data

Example: 15034284
collected_rewardsstring

Total collected rewards

Example: "3200000000000000000000"
contract_eth_balancestring

ETH balance on the contract in Wei

Example: "5000000000000000000"
conversion_ratenumber
deposit_countinteger

Number of deposits

Example: 2
exited_validators_eth_balancestring

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

Example: "128000000000000000000"
exiting_validators_eth_balancestring

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

Example: "128000000000000000000"
funded_validator_countinteger

Count of funded validators

Example: 102
funded_valitor_countinteger

Previous typo made, keeping for backwards compatibility

Example: 102
pending_validator_countinteger

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

Example: 2
pending_validators_eth_balancestring

Total ETH balance of pending validators in GWei

Example: "64000000000000000000"
rebalance_deposit_to_redeem_modeboolean
Example: true
skimmed_validators_eth_balancestring

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

Example: "128000000000000000000"
slashing_containment_modeboolean
Example: false
stopped_validator_countinteger

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

Example: 42
total_eth_balancestring

Total ETH balance managed by the River protocol in GWei

Example: "3200000000000000000000"
total_eth_depositedstring

Total ETH deposited

Example: "3200000000000000000000"
total_supplystring

Total LsETH supply

Example: "3200000000000000000000"
total_validator_countinteger

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

Example: 100
Request
const response = await fetch('https://api.alluvial.finance/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

GEThttps://api.alluvial.finance/eth/v0/status/{block_number}
Path parameters
block_number*integer

Block height to query

Response

OK

Body
active_validator_countinteger

Count of total validators minus stopped validators on the consensus layer

Example: 58
active_validators_eth_balancestring

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

Example: "128000000000000000000"
block_numberinteger

Height of the returned data

Example: 15034284
collected_rewardsstring

Total collected rewards

Example: "3200000000000000000000"
contract_eth_balancestring

ETH balance on the contract in Wei

Example: "5000000000000000000"
conversion_ratenumber
deposit_countinteger

Number of deposits

Example: 2
exited_validators_eth_balancestring

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

Example: "128000000000000000000"
exiting_validators_eth_balancestring

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

Example: "128000000000000000000"
funded_validator_countinteger

Count of funded validators

Example: 102
funded_valitor_countinteger

Previous typo made, keeping for backwards compatibility

Example: 102
pending_validator_countinteger

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

Example: 2
pending_validators_eth_balancestring

Total ETH balance of pending validators in GWei

Example: "64000000000000000000"
rebalance_deposit_to_redeem_modeboolean
Example: true
skimmed_validators_eth_balancestring

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

Example: "128000000000000000000"
slashing_containment_modeboolean
Example: false
stopped_validator_countinteger

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

Example: 42
total_eth_balancestring

Total ETH balance managed by the River protocol in GWei

Example: "3200000000000000000000"
total_eth_depositedstring

Total ETH deposited

Example: "3200000000000000000000"
total_supplystring

Total LsETH supply

Example: "3200000000000000000000"
total_validator_countinteger

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

Example: 100
Request
const response = await fetch('https://api.alluvial.finance/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.

GEThttps://api.alluvial.finance/eth/v0/balances
Query parameters
Response

OK

Body
addressstring

Owner address

Example: "0x123456789985ca04a69c35978c3a3e778d6ef172"
balancestring

LsETH balance

Example: "4200000000000000000000"
block_numberinteger

Block height of the balance

Example: 15034284
Request
const response = await fetch('https://api.alluvial.finance/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.

GEThttps://api.alluvial.finance/eth/v0/balances/{address}
Path parameters
address*string

Account address to query the balance for

Query parameters
Response

OK

Body
addressstring

Owner address

Example: "0x123456789985ca04a69c35978c3a3e778d6ef172"
balancestring

LsETH balance

Example: "4200000000000000000000"
block_numberinteger

Block height of the balance

Example: 15034284
Request
const response = await fetch('https://api.alluvial.finance/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

GEThttps://api.alluvial.finance/eth/v0/balances/{address}/history
Path parameters
address*string

Address of the balance to query balance for

Query parameters
Response

OK

Body
addressstring

Owner address

Example: "0x123456789985ca04a69c35978c3a3e778d6ef172"
balancestring

LsETH balance

Example: "4200000000000000000000"
block_numberinteger

Block height of the balance

Example: 15034284
Request
const response = await fetch('https://api.alluvial.finance/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

GEThttps://api.alluvial.finance/eth/v0/contracts
Response

OK

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('https://api.alluvial.finance/eth/v0/contracts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "allowlister": [],
  "el_fee_recipient": [],
  "operators_registry": [],
  "oracle": [],
  "redeem_manager": [],
  "river": [],
  "withdraw": []
}

Last updated