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

200401403500

OK

Body

application/json

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

JavaScriptCurlPython

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

Response

200401403500

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

200401403500

OK

Body

application/json

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

JavaScriptCurlPython

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

Response

200401403500

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

200400401403500

OK

Body

application/json

addressstring

Owner address

Example: "0x123456789985ca04a69c35978c3a3e778d6ef172"

balancestring

LsETH balance

Example: "4200000000000000000000"

block_numberinteger

Block height of the balance

Example: 15034284

Request

JavaScriptCurlPython

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

Response

200400401403500

[
  {
    "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

200400401403500

OK

Body

application/json

addressstring

Owner address

Example: "0x123456789985ca04a69c35978c3a3e778d6ef172"

balancestring

LsETH balance

Example: "4200000000000000000000"

block_numberinteger

Block height of the balance

Example: 15034284

Request

JavaScriptCurlPython

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

Response

200400401403500

{
  "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 occurred 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

200400401403500

OK

Body

application/json

addressstring

Owner address

Example: "0x123456789985ca04a69c35978c3a3e778d6ef172"

balancestring

LsETH balance

Example: "4200000000000000000000"

block_numberinteger

Block height of the balance

Example: 15034284

Request

JavaScriptCurlPython

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

Response

200400401403500

[
  {
    "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

200401403500

OK

Body

application/json

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

JavaScriptCurlPython

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

Response

200401403500

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